适合谁
- 需要链上数据的 AI 代理开发者
- 智能合约审计和数据分析
- 构建 DeFi 仪表盘或监控工具
B
35FMRS · D
该项目已停止更新，但核心功能可用。适合需要快速接入链上数据的开发者，但需注意其只读性和依赖外部 API。
Bankless Onchain MCP Server 是一个基于模型上下文协议（MCP）的服务器，允许 AI 模型以结构化方式访问区块链状态和事件数据。它通过 Bankless API 提供合约操作（读取状态、获取代理、ABI、源代码）、事件操作（获取事件日志、构建事件主题）和交易操作（获取交易历史、交易详情）。
工具能力
read_contract
读取智能合约的状态，例如调用只读方法。
get_proxy
获取代理合约的实现合约地址。
get_abi
获取合约的 ABI（应用程序二进制接口）JSON。
get_source
获取已验证合约的源代码、ABI、编译器版本等元数据。
get_events
根据主题过滤条件获取合约的事件日志。
build_event_topic
根据事件名称和参数类型生成事件主题的哈希。
get_transaction_history
获取指定用户地址的交易历史列表。
get_transaction_info
获取特定交易的详细信息，包括区块、时间戳、价值、gas 和状态等。
安装接入
- 设置环境变量 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"
}
}
}
}
选型与风险
不适合谁
- 写入或修改区块链状态（只读）
- 需要私有链或自定义 RPC 的场景
- 实时交易推送（需要额外组件）
所需权限
- 需要 BANKLESS_API_TOKEN 环境变量
- 调用 Bankless API 需要网络访问
- 需要读取合约和交易数据
风险与副作用
- 使用第三方 API 可能存在可用性和配额限制
- 输入合约地址或方法名时需小心避免安全漏洞
- API 密钥泄露可能导致费用或数据滥用
常见排障
- 检查 BANKLESS_API_TOKEN 是否设置正确
- 确保网络连接稳定，访问 Bankless API
- 检查合约地址和网络参数是否正确
使用场景
在 AI 应用中读取以太坊智能合约的状态
分析代币转账和事件日志
追踪账户的交易历史
调试合约交互
支持客户端
Claude Desktop完整支持