← 返回目录

Bankless Onchain MCP Server

社区

通过 Bankless API 提供区块链数据交互的 MCP 服务器。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 205 / 230
Stars: ★ 79 热门
传输方式: stdio（本地进程）
运行环境: Node.js
凭据: 需要 API Key / 凭据
最近提交: 5 个月前
工具数: 8

35FMRS · D

该项目已停止更新，但核心功能可用。适合需要快速接入链上数据的开发者，但需注意其只读性和依赖外部 API。

最强项 · 文档质量 8/20 最弱项 · 安全与权限 6/20

可靠性

7/20

安全与权限

6/20

维护活跃度

7/20

文档质量

8/20

安装易用性

7/20

查看各项评分依据

可靠性 7/20: 审查中未发现可执行测试或CI配置，因此可靠性得分上限为12。但根据README描述，服务器功能明确，且错误处理类型设计合理。不过由于缺乏实际运行证据，无法验证声明与实现是否完全一致。扣分原因是测试证据缺失。
安全与权限 6/20: 该服务器需要API令牌，且README中提供了配置方法。但未发现明确的令牌存储或权限最小化说明。服务器发起外部网络请求，但未提及确认机制。未发现恶意行为，但安全最佳实践不完善，扣分。
维护活跃度 7/20: 仓库有许可证（MIT），且有版本号0.6.2，但README明确声明项目不再接收更新，因此维护活跃度低。但有版本号和许可证，弥补部分不足。扣分主要因项目已停止更新。
文档质量 8/20: README提供了安装、使用、示例和错误处理等信息，文档质量较好。但缺少故障排除和成本限制说明。扣分因文档仍有不完整之处。
安装易用性 7/20: 安装步骤清晰（npx命令），并提供环境变量配置示例。但未提供构建验证或客户端配置示例（尽管提供JSON配置示例）。扣分因缺少可验证的安装证据。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要链上数据的 AI 代理开发者
智能合约审计和数据分析
构建 DeFi 仪表盘或监控工具

不适合谁

写入或修改区块链状态（只读）
需要私有链或自定义 RPC 的场景
实时交易推送（需要额外组件）

所需权限

需要 BANKLESS_API_TOKEN 环境变量
调用 Bankless API 需要网络访问
需要读取合约和交易数据

风险与副作用

使用第三方 API 可能存在可用性和配额限制
输入合约地址或方法名时需小心避免安全漏洞
API 密钥泄露可能导致费用或数据滥用

安装接入

准备工作

运行环境：Node.js

BANKLESS_API_TOKEN 必填密钥 Bankless API 的访问令牌，必须设置才能运行；可按 https://docs.bankless.com/bankless-api/other-services/onchain-mcp 的说明获取。

设置环境变量 BANKLESS_API_TOKEN，可参考 https://docs.bankless.com/bankless-api/other-services/onchain-mcp 获取。
使用 npx @bankless/onchain-mcp 运行服务器。
在支持 MCP 的客户端中配置服务器，示例见 install_config。

claude_desktop_config.json

{
  "mcpServers": {
    "bankless": {
      "command": "npx",
      "args": [
        "@bankless/onchain-mcp"
      ],
      "env": {
        "BANKLESS_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "bankless": {
      "command": "npx",
      "args": [
        "@bankless/onchain-mcp"
      ],
      "env": {
        "BANKLESS_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add bankless -e BANKLESS_API_TOKEN=your_api_token_here -- npx @bankless/onchain-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

启动后在客户端工具列表中应出现 read_contract、get_abi、get_events 等工具；调用 get_proxy 查询一个代理合约地址即可验证 API token 有效。

常见排障

检查 BANKLESS_API_TOKEN 是否设置正确
确保网络连接稳定，访问 Bankless API
检查合约地址和网络参数是否正确

试试这样问

连接成功后，可以直接对 AI 助手这样说：

读取以太坊上合约 0x1234... 的 balanceOf 方法，输入地址 0xabcd...，返回 uint256 余额
查询合约 0x1234... 在以太坊上的代理实现地址
获取以太坊上某合约的 ABI 和源代码
查询地址 0xabcd... 在以太坊上的交易历史

工具能力 8

read_contract 只读

读取智能合约的状态，例如调用只读方法。

get_proxy 只读

获取代理合约的实现合约地址。

get_abi 只读

获取合约的 ABI（应用程序二进制接口）JSON。

get_source 只读

获取已验证合约的源代码、ABI、编译器版本等元数据。

get_events 只读

根据主题过滤条件获取合约的事件日志。

build_event_topic 只读

根据事件名称和参数类型生成事件主题的哈希。

get_transaction_history 只读

获取指定用户地址的交易历史列表。

get_transaction_info 只读

获取特定交易的详细信息，包括区块、时间戳、价值、gas 和状态等。

使用场景

在 AI 应用中读取以太坊智能合约的状态

分析代币转账和事件日志

追踪账户的交易历史

调试合约交互

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

Bankless Onchain MCP Server 是一个基于模型上下文协议（MCP）的服务器，允许 AI 模型以结构化方式访问区块链状态和事件数据。它通过 Bankless API 提供合约操作（读取状态、获取代理、ABI、源代码）、事件操作（获取事件日志、构建事件主题）和交易操作（获取交易历史、交易详情）。

Bankless Onchain MCP Server

选型与风险

适合谁

不适合谁

所需权限

风险与副作用

安装接入

准备工作

验证是否装好

常见排障

试试这样问

工具能力 8

使用场景

支持客户端

详细介绍

同类可选方案