← 返回目录
B

Blockscout MCP Server

官方
通过 MCP 暴露 Blockscout 区块链数据
分类
开发工具 第 38 / 438
Stars
★ 46 热门
传输方式
Streamable HTTP
运行环境
远程托管(无需本地环境) · Python · Docker
凭据
需要 API Key / 凭据
许可证
其他 / 未声明
最近提交
工具数
16
66FMRS · C

Blockscout 官方维护的多链区块链数据 MCP 服务器,工具集完整,支持托管端点与自托管,需 PRO API 密钥,主要面向只读区块链查询与分析。

最强项 · 文档质量 18/20 最弱项 · 可靠性 9/20

可靠性
9/20
安全与权限
14/20
维护活跃度
12/20
文档质量
18/20
安装易用性
13/20
查看各项评分依据
可靠性 9/20
README详细列出了16个工具及其参数,并描述了标准化的ToolResponse模型、游标分页、进度通知等机制,与描述基本吻合,具备一定的可信度。但本次评审仅基于README和manifest文本,未见到仓库中实际的CI工作流或测试文件作为可验证证据,TESTING.md/API.md/SPEC.md等文档均为引用而非提供的证据本身。根据静态评审校准规则,在缺乏可验证的执行证据(真实CI+已提交测试覆盖关键路径)之前,可靠性不应超过12分。此外,大多数数据工具依赖PRO API密钥,若无密钥则'fail fast',这是一种可控的失败模式,但也说明离线/无密钥场景下功能大幅受限,增加了不确定性。
安全与权限 14/20
服务器主要暴露只读类工具(余额、合约ABI、交易信息、read_contract等),未见发送交易、支付或删除类不可逆默认操作,不构成红线风险。PRO API密钥的获取、存储、客户端传递(通过HTTP header)、密钥格式校验失败时不回退到服务器密钥等机制描述清晰,体现出对最小权限和密钥隔离的关注。会话计量功能对密钥生成、持久化、轮换风险有明确说明。遥测默认开启(收集工具名、参数、版本、API密钥的SHA-256指纹),虽然进行了公开披露且提供了退出开关,但'默认收集'而非'默认关闭/需选择加入'仍是可扣分项。另外direct_api_call工具允许对'原始Blockscout API端点'发起GET/POST请求,其endpoint_path的具体范围限制在提供文本中未充分说明,存在一定的攻击面不确定性。综合来看,主要风险已可见且有一定缓解措施,但权限边界与端点范围的披露不够完整,故未达到20分档。
维护活跃度 12/20
版本号为0.18.1,表明存在持续的迭代发布,并提及GitHub Releases、Docker镜像(ghcr.io)、Smithery/Glama等第三方目录收录,显示出一定的社区活跃度(44星,12个未解决issue)。但仓库对象元数据显示许可证为'NOASSERTION',而README中却声称采用名为'Blockscout Software Licence'的自定义许可证并提供LICENSE文件链接——这一元数据与文档描述之间的不一致本身就是治理层面的缺陷,需要谨慎对待(自定义许可证条款是否宽松、是否允许商用/分发均无法从现有材料确认)。文本中也未提供安全响应渠道、贡献指南或版本发布历史的具体证据。因此维护性评级为'活跃但治理/许可证明确性存在缺口'的中等水平。
文档质量 18/20
README文档层次丰富:涵盖多种客户端(Claude Desktop/Code、ChatGPT、Codex、Cursor)的详细配置示例、环境变量及其默认值/作用说明、PRO API密钥获取与计费/信用额度预警机制、遥测数据收集范围与退出方法、DNS重绑定保护与内网穿透注意事项,并列出了16个工具的功能与参数说明及多条示例提示语。同时指向API.md、SPEC.md、AGENTS.md、TESTING.md等补充文档,体现分层文档结构。局限性和成本(PRO API密钥要求、信用额度)也被明确披露。仅因部分引用文档(如SPEC.md、TESTING.md的具体内容)未随附作为证据、部分工具的输入边界(如direct_api_call的可访问端点范围)未充分说明而略有扣分。
安装易用性 13/20
README为多种主流客户端(Claude Desktop的MCPB包与Docker代理两种方式、Claude Code、ChatGPT应用商店、Codex App/CLI、Cursor)提供了具体配置示例,并说明了本地开发、Docker构建与运行、REST API启用等路径,整体步骤清晰、可操作性强。但根据静态评审校准规则,由于未见到真实CI工作流与已提交测试作为可验证的执行证据,安装易用性上限为15分。此外,完整功能依赖注册获取PRO API密钥这一外部前置条件,且可选的会话计量功能涉及密钥生成、持久卷、TTL等较复杂的运维配置,增加了部署的整体复杂度。

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

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

  • 需要实时多链数据的 AI 代理和 IDE 用户
  • 区块链分析师和开发者
  • 使用 Claude、Cursor、ChatGPT 或 Codex 的加密货币研究者

不适合谁

  • 不愿注册 Blockscout PRO API 密钥的用户
  • 需要写链上交易或签名操作的场景(工具均为只读查询)
  • 对匿名遥测敏感且未关闭该功能的社区实例使用者

所需权限

  • 需要 Blockscout PRO API 密钥(proapi_ 前缀)用于数据访问
  • 通过 HTTP 传输访问 https://mcp.blockscout.com/mcp
  • 本地部署可通过 BLOCKSCOUT_PRO_API_KEY 环境变量提供密钥

风险与副作用

  • PRO API 访问按额度计费,余额低于阈值时工具会附加提示
  • 社区实例默认收集匿名遥测(工具名、参数、版本、API 密钥 SHA-256 哈希),可用 BLOCKSCOUT_DISABLE_COMMUNITY_TELEMETRY=true 关闭
  • PRO API 密钥不应提交到代码库或嵌入客户端二进制中
  • Claude Connectors Directory 需付费 Claude 计划且因共享访问密钥可能有限制

安装接入

准备工作

运行环境:远程托管(无需本地环境) · Python · Docker

BLOCKSCOUT_PRO_API_KEY 必填密钥 Blockscout PRO API 密钥,在 Blockscout 开发者门户注册获取,以 proapi_ 前缀开头。
BLOCKSCOUT_SESSION_SECRET 可选密钥 会话计量功能的签名密钥(至少 32 字节),可选功能。
其他可选配置项(13 个)
BLOCKSCOUT_PRO_API_KEY_HEADER 可选 HTTP 模式下客户端自带密钥的请求头名称,默认 Blockscout-MCP-Pro-Api-Key。
BLOCKSCOUT_PRO_API_LOW_CREDITS_THRESHOLD 可选 低余额提醒阈值(默认 5000 credits),设为 0 可关闭。
BLOCKSCOUT_PRO_API_KEY_REQUIRED_NOTICE 可选 运营方配置的公告,附加到未携带客户端密钥的工具响应末尾,仅官方公开服务器使用。
BLOCKSCOUT_MCP_USER_AGENT 可选 RPC 请求 User-Agent 的自定义前缀,默认 'Blockscout MCP'。
BLOCKSCOUT_DEV_JSON_RESPONSE 可选 开发模式开关,启用后返回纯 JSON 而非 SSE 流,仅用于本地测试。
BLOCKSCOUT_MCP_ALLOWED_HOSTS 可选 允许的 Host 列表,用于 ngrok 隧道开发场景。
BLOCKSCOUT_MCP_ALLOWED_ORIGINS 可选 允许的 Origin 列表,用于 ngrok 隧道开发场景。
BLOCKSCOUT_SESSION_DB_PATH 可选 会话数据库路径,启用会话计量时需挂载持久卷。
BLOCKSCOUT_SESSION_MCP_MAX_CALLS 可选 无客户端密钥调用者每会话的 MCP 工具调用上限,默认 5。
BLOCKSCOUT_SESSION_REST_MAX_CALLS 可选 无客户端密钥调用者每会话的 REST 调用上限,默认 5。
BLOCKSCOUT_SESSION_TTL_SECONDS 可选 会话 TTL,默认 900 秒。
BLOCKSCOUT_SESSION_SWEEP_INTERVAL_SECONDS 可选 过期会话行的清理频率,默认每个 TTL 一次。
BLOCKSCOUT_DISABLE_COMMUNITY_TELEMETRY 可选 设为 true 可关闭匿名遥测数据收集。
  1. 在 Blockscout Developer Portal (dev.blockscout.com) 注册并生成 PRO API 密钥(免费层无需信用卡)。
  2. Claude 桌面端:从 GitHub Releases 下载 blockscout-mcp.mcpb 双击安装,或使用 docker run sparfenyuk/mcp-proxy 配置 claude_desktop_config.。
  3. Claude Code:运行 claude mcp add --transport http blockscout https://mcp.blockscout.com/mcp --header "Blockscout-MCP-Pro-Api-Key: proapi_your_key_here"。
  4. Cursor:在 .cursor/mcp. 中添加带 Blockscout-MCP-Pro-Api-Key 请求头的配置。
  5. Codex:在设置中添加 Streamable HTTP 服务器及密钥请求头。
  6. 本地开发:git clone 后 uv pip install -e . 并运行 python -m blockscout_mcp_server(stdio)或加 --http;Docker 镜像为 ghcr.io/blockscout/mcp-server:latest。
claude_desktop_config.json
{"mcpServers":{"blockscout":{"url":"https://mcp.blockscout.com/mcp","headers":{"Blockscout-MCP-Pro-Api-Key":"proapi_your_key_here"}}}}

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

.vscode/mcp.json
{
  "servers": {
    "blockscout": {
      "url": "https://mcp.blockscout.com/mcp",
      "headers": {
        "Blockscout-MCP-Pro-Api-Key": "proapi_your_key_here"
      }
    }
  }
}

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

Terminal
claude mcp add --transport http blockscout https://mcp.blockscout.com/mcp --header 'Blockscout-MCP-Pro-Api-Key: proapi_your_key_here'

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

验证是否装好

在客户端配置 https://mcp.blockscout.com/mcp 并附带 Blockscout-MCP-Pro-Api-Key 请求头后,工具列表中应出现 __unlock_blockchain_analysis__ 和 get_chains_list 等工具;调用 get_chains_list 可验证连接是否正常。

常见排障

  1. 确认 PRO API 密钥已通过 Blockscout-MCP-Pro-Api-Key 请求头或环境变量正确提供
  2. 密钥格式错误时需要 PRO API 的请求会失败且无回退;未提供任何密钥会返回 not-configured 错误
  3. stdio 模式下无法通过请求头携带客户端密钥,须自行设置 BLOCKSCOUT_PRO_API_KEY
  4. HTTP 模式需在 Docker 中绑定 --http-host 0.0.0.0 才能从容器外部访问
  5. Ngrok 隧道需设置 BLOCKSCOUT_MCP_ALLOWED_HOSTS 和 BLOCKSCOUT_MCP_ALLOWED_ORIGINS 以绕过 DNS 重绑定保护
  6. Codex CLI 需在 config.toml 中启用 experimental_use_rmcp_client

试试这样问

连接成功后,可以直接对 AI 助手这样说:

  • 查询 zeaver.eth 在 Optimism 链上是否对 OP 代币设置了授权?
  • 计算地址 0xcafe...cafe 在 2025 年 5 月于以太坊上支付的 gas 总费用。
  • 查看 Redstone rollup 上交易 0xf8a55721f7e2dcf85690aaf81519f7bc820bc58a878fa5f81b12aef5ccda0efb 的详细信息。
  • USDT 代币在 Arbitrum One 上是否存在黑名单功能?

工具能力 16

__unlock_blockchain_analysis__ 只读
初始化 Blockscout MCP 会话:返回服务器参考数据、blockscout-analysis 技能指针和 URI 解析规则。每个会话在其他工具之前调用一次。
get_chains_list 只读
返回支持的链列表,可按名称、链 ID、原生货币或生态系统过滤。
get_address_by_ens_name 只读
将 ENS 域名转换为对应的以太坊地址。
lookup_token_by_symbol 只读
按符号或名称搜索代币地址,返回多个潜在匹配。
get_contract_abi 只读
检索智能合约的 ABI(应用二进制接口)。
inspect_contract_code 只读
获取已验证合约的源代码文件。
get_address_info 只读
获取地址的综合信息,包括余额、ENS 关联、合约状态、代币详情和公共标签。
get_tokens_by_address 只读
返回地址的 ERC20 代币持有情况及丰富的元数据和市场数据。
展开其余 8 个工具
get_block_number 只读
获取特定日期/时间的区块号和时间戳,或最新区块。
get_transactions_by_address 只读
获取地址在特定时间范围内的交易,可按方法过滤。
get_token_transfers_by_address 只读
返回地址在特定时间范围内的 ERC-20 代币转账。
nft_tokens_by_address 只读
检索地址拥有的 NFT 代币,按集合分组。
get_block_info 只读
返回区块信息,包括时间戳、gas 使用量、燃烧费用和交易数量,可选包含交易哈希列表。
get_transaction_info 只读
获取综合交易信息,含解码后的输入参数和详细代币转账。
read_contract 只读
执行智能合约的只读函数并返回结果。abi 参数是描述函数签名的 JSON 对象。
direct_api_call 只读
调用原始 Blockscout API 端点以获取高级或链特定数据,支持 GET 和带 JSON 体的 POST 请求。

使用场景

查询地址余额、代币持有和 NFT 集合
分析交易、区块和 gas 费用
检索并检查已验证智能合约的 ABI 和源代码
通过 read_contract 执行只读合约函数
追踪特定时间范围内的 ERC-20 代币转账

支持客户端

Claude Desktop
Claude Code
Claude (Web) Connectors Directory
ChatGPT Apps
Codex
Cursor

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

详细介绍

Blockscout MCP Server 由 Blockscout 官方维护,封装 Blockscout API 并通过模型上下文协议(MCP)向 AI 代理和 IDE(如 Claude、Cursor)暴露区块链数据,包括地址余额、代币、NFT、交易和合约元数据。它支持多链(通过 Blockscout PRO API 配置和 Chainscout 元数据)、上下文优化、响应切片、Base64URL 游标分页和版本化 REST API。需要 Blockscout PRO API 密钥(proapi_ 前缀,通过 Blockscout-MCP-Pro-Api-Key 请求头或 BLOCKSCOUT_PRO_API_KEY 环境变量提供)。官方托管端点为 https://mcp.blockscout.com/mcp。社区实例默认收集匿名遥测数据,可通过 BLOCKSCOUT_DISABLE_COMMUNITY_TELEMETRY=true 关闭。许可证为 Blockscout Software Licence。

同类可选方案

Context7 80 · B

Upstash 官方维护,为 AI 编码助手提供实时更新的第三方库文档

★ 63.3k · 工具数 2 与当前对比 →

源版本 095ef2c03f1a 数据同步于 2026-10-19 查看 FMRS 评分方法