适合谁
- 需要实时多链数据的 AI 代理和 IDE 用户
- 区块链分析师和开发者
- 使用 Claude、Cursor、ChatGPT 或 Codex 的加密货币研究者
B
66FMRS · C
Blockscout 官方维护的多链区块链数据 MCP 服务器，工具集完整，支持托管端点与自托管，需 PRO API 密钥，主要面向只读区块链查询与分析。
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。
工具能力
__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 代币持有情况及丰富的元数据和市场数据。
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 请求。
安装接入
- 在 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"}}}}
选型与风险
不适合谁
- 不愿注册 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 计划且因共享访问密钥可能有限制
常见排障
- 确认 PRO API 密钥已通过 Blockscout-MCP-Pro-Api-Key 请求头或环境变量正确提供
- 密钥格式错误时需要 PRO API 的请求会失败且无回退；未提供任何密钥会返回 not-configured 错误
- stdio 模式下无法通过请求头携带客户端密钥，须自行设置 BLOCKSCOUT_PRO_API_KEY
- HTTP 模式需在 Docker 中绑定 --http-host 0.0.0.0 才能从容器外部访问
- Ngrok 隧道需设置 BLOCKSCOUT_MCP_ALLOWED_HOSTS 和 BLOCKSCOUT_MCP_ALLOWED_ORIGINS 以绕过 DNS 重绑定保护
- Codex CLI 需在 config.toml 中启用 experimental_use_rmcp_client
使用场景
查询地址余额、代币持有和 NFT 集合
分析交易、区块和 gas 费用
检索并检查已验证智能合约的 ABI 和源代码
通过 read_contract 执行只读合约函数
追踪特定时间范围内的 ERC-20 代币转账
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Claude (Web) Connectors Directory完整支持
ChatGPT Apps完整支持
Codex App完整支持
Codex CLI完整支持
Cursor完整支持