快速结论
Blockscout MCP Server 是 Blockscout 官方维护的链上数据 MCP 服务,适合需要让 Claude、Cursor、Codex 或内部 Agent 查询 EVM 地址、代币、NFT、区块、交易和已验证合约的开发者。截至 2026-07-21,GitHub 最新稳定版是 v0.16.0;main 分支虽已出现 0.17 开发版本号,但不能把开发分支当成已发布稳定版。
它最大的价值是把多条采用 Blockscout 的 EVM 网络放到一组结构化工具后面,并对大结果做分页、裁剪和后续调用提示。不过它不是链上真相裁判,也不是交易执行钱包。数据来自 Blockscout PRO API、Chainscout 元数据和各链索引结果,可能受索引延迟、链重组、代理合约、代币精度与标签错误影响。任何余额、资金流或合约判断都应回到目标网络的区块、交易收据、事件日志和合约源码复核。
核心功能
- 多链发现:
get_chains_list用名称、chain ID、原生币或生态过滤可用网络,后续工具必须显式携带正确的chain_id。 - 地址与资产查询:读取地址概况、ERC-20 持仓、NFT、交易和代币转账,并用 opaque cursor 分页,避免一次把大列表塞入模型上下文。
- 区块与交易分析:按时间查区块号,读取区块、交易、解码参数和 token transfer;返回的是索引后的解释结果,不等同于执行层共识证明。
- 合约检查:获取已验证 ABI 与源码文件,调用
read_contract执行只读 view 函数;代理合约仍需识别 implementation、存储布局和调用上下文。 - 高级 API 调用:
direct_api_call可访问更细的 Blockscout API 路径,能力更宽,也更需要 endpoint allowlist、参数限制和响应大小控制。 - Agent 上下文优化:统一
ToolResponse、字段截断、游标分页、进度通知和 follow-up instructions,降低长查询挤占上下文的概率。 - MCP 与 REST 两种表面:托管 MCP 位于
https://mcp.blockscout.com/mcp;自托管可用 stdio,或开启 Streamable HTTP,并通过--rest额外暴露/v1REST API。
适合人群
- 构建区块浏览器助手、钱包支持工具、合约研究 Agent 或内部链上调查工作流的开发团队。
- 需要跨多条 Blockscout 支持网络统一查询,但愿意显式管理 chain ID、API credits、缓存和审计的工程团队。
- 希望在 IDE 内快速获取 ABI、已验证源码、地址活动和交易详情,同时保留人工复核步骤的安全研究人员。
- 不适合要求交易签名、自动转账、确定性实时结算或无人工复核投资结论的场景;该服务器主要读取和解释数据,不应持有私钥。
使用场景
开发者可以先调用 get_chains_list 锁定网络,再查询一个地址在指定时间段的交易与 token transfer,最后读取相关交易和合约源码。这个顺序比让模型凭链名猜 chain ID 更可靠。合约分析时,应同时检查代理地址与实现地址、验证状态、目标区块高度和函数 ABI;同名代币必须用链与合约地址确认,不能仅凭 symbol 归并。
生产接入应把工具限制为任务必需集合,为 direct_api_call 建立路径和方法白名单,设置超时、页数、结果大小与 credit 预算。不要把钱包私钥、助记词、交易所凭据或其他 Secret 传给工具。日志可记录调用者、工具名、chain ID、耗时和错误,但应遮蔽地址之外的敏感业务参数及 API Key。涉及资产归属、制裁标签、异常资金流或投资判断时,必须由具备背景的人复核,不能把模型摘要直接当结论。
价格与版本
v0.16.0 的托管数据工具通常需要 proapi_ 前缀的 Blockscout PRO API Key。Key 可在 Developer Portal 创建,官方说明免费层无需信用卡;免费层仍受 daily credits 等额度约束,耗尽时可能返回 402,高用量需要补充 credits 或采用相应商业方案。Claude Connectors 使用共享访问方式且要求相应付费 Claude 方案,其能力和限额不能等同于自带 PRO Key。
源码可查看和自托管,但不是开源软件。2026-05-15 生效的 Blockscout Software Licence 是自定义源码可用许可证:授权具有临时、可撤销、不可转让和不可再许可等条件;要求保留品牌与界面归属;派生作品限内部使用;未经 Commercial Licence,不得把软件或其功能收费、托管或作为服务提供给第三方。采用、修改、分发或商业托管前应核对仓库当前 LICENSE 并让法务确认,不能用“GitHub 公开”推断 MIT、Apache 或 OSI 开源权利。
国内访问与使用体验
GitHub 源码、自托管镜像、Developer Portal 与托管端点的可达性会随网络和组织环境变化,needsVPN 仅作为海外服务访问元数据,不代表稳定性承诺。需要低延迟或受控数据边界的团队可评估在自己的环境运行 stdio/HTTP 服务,但上游 PRO API、Chainscout 和目标链节点仍是外部依赖。
客户端通过托管 MCP 接入时,应把 Key 放在 Blockscout-MCP-Pro-Api-Key 请求头,不要使用普通 Authorization 头,也不要把 Key 写进仓库或客户端发布包。自托管可使用 BLOCKSCOUT_PRO_API_KEY 环境变量;HTTP 模式可允许每个客户端提交自己的专用头。社区实例默认可能收集匿名工具调用参数、版本和 API Key 的单向指纹,可用环境变量关闭;参数本身也可能包含业务敏感地址,部署前应评估遥测与日志策略。
优点
- 一组 MCP 工具覆盖链发现、地址、代币、NFT、区块、交易、ABI、源码和只读合约调用。
- 托管 MCP、自托管 stdio、Streamable HTTP 与可选 REST 能适配不同 Agent 和应用架构。
- 游标分页、字段裁剪和结构化响应比直接把原始浏览器 API 全量返回给模型更节省上下文。
- PRO API 免费层降低小规模验证门槛,用户自带 Key 可明确归属 credits。
- 官方仓库、版本发布、容器和详细 API 文档便于审查与固定版本部署。
不足
- 自定义 Blockscout Software Licence 限制商业服务、派生作品和再分发,不能按普通开源组件采用。
- 大多数数据工具依赖有效 PRO Key 和 credits;免费层不是无限量公共端点。
- Chainscout 网络元数据、Blockscout 索引和链执行层之间可能存在覆盖、延迟或高度差异。
direct_api_call增大攻击和误用表面,Agent 可能选错 endpoint、参数、网络或时间范围。- 链上数据容易被模型过度解释;标签、token symbol、代理源码和转账事件都需要语境与人工验证。
替代品对比
| 工具 | 更适合谁 | 主要优势 | 主要边界 |
|---|---|---|---|
| Glassnode | 需要成品链上指标、图表和研究管道的团队 | 指标方法、Studio、Workbench 与企业交付完整 | 不是通用区块浏览器 MCP,套餐决定资产与指标 |
| OpenBB | 要整合多家金融和数字资产 provider 的机构 | 开放式数据集成与研究界面 | 具体链上来源、许可和费用需另配 |
| Alpha Vantage | 以股票、外汇、宏观 API 为主的开发者 | API 入口清晰,传统市场覆盖更合适 | 不提供同等 EVM 地址与合约工具 |
| ElizaOS | 要构建带 Web3 插件和社交渠道的完整 Agent | Agent 运行时、角色与插件生态 | 不是独立可信链上数据源,权限面更大 |
| GitHub MCP | 主要让 Agent 检查源码、Issue 和仓库的团队 | 代码协作数据和 GitHub 操作丰富 | 不负责区块、交易、余额或合约状态 |
常见问题 FAQ
Blockscout MCP Server 当前稳定版是什么?
截至 2026-07-21,GitHub 最新稳定 Release 是 v0.16.0。仓库开发分支中的 0.17 开发版本不应当作稳定发布部署。
它是开源软件吗?
不是。源码公开,但采用自定义 Blockscout Software Licence。该许可证不是 OSI 批准开源许可证,并对商业服务、派生作品、品牌归属、转让和再许可设置明确限制。
免费层需要信用卡吗?
官方说明 Developer Portal 的 PRO API 免费层无需信用卡,但 API Key 仍有 credits 与限额。生产容量、补充 credits 和商业条款应以当期 Portal 为准。
托管 MCP 怎样认证?
连接 https://mcp.blockscout.com/mcp,通过 Blockscout-MCP-Pro-Api-Key 头提交 proapi_ Key。不要提交私钥,也不要把 PRO Key 固化在公开配置或客户端二进制中。
查询结果能作为最终链上证据吗?
不能直接这样使用。结果可能受索引延迟、链重组、错误网络、代理合约、token decimals、标签和解码方式影响。高风险结论应使用目标链 RPC、区块高度、交易收据、事件与源码交叉验证。
它能替 Agent 签名或发送交易吗?
核心工具面向查询与只读合约调用,不应持有钱包私钥。若另接交易执行工具,必须独立做最小权限、模拟、限额、明确确认和审计,不能因分析服务器返回建议就自动执行。
总结
Blockscout MCP Server v0.16.0 是把多链浏览器数据交给 Agent 的实用适配层,但选型重点不只是工具数量。先用免费 PRO Key 在一条明确网络上验证地址、交易和合约查询,再测试 credits、分页、索引时延、错误网络和链重组处理。上线前固定版本,审查自定义许可证,隔离 Key,关闭或评估遥测,限制 direct_api_call,并把链上复核与人工判断保留在工作流中。