Blockscout MCP Server

🚀 Blockscout MCP 服务器

这是一个用于与 Blockscout API 对接的 Model Context Protocol (MCP) 服务器实现，为 AI 模型提供了与 Blockscout API 交互的标准接口，让 AI 模型能更便捷地获取区块链相关信息。

✨ 主要特性

• 支持任何 Blockscout API 端点，具有广泛的适用性。
• 可获取当前区块编号，实时掌握区块链进度。
• 能检查账户余额，了解账户资产情况。
• 可查看交易计数（非 ces），分析交易活跃度。
• 能检索区块信息，深入了解区块链结构。
• 可获取交易详情，追踪每一笔交易。
• 支持调用合约，实现更多区块链功能。

📦 安装指南

安装前准备

• Node.js (v16 或更高版本)
• npm (Node 包管理器)

具体安装步骤

1. 克隆仓库：

git clone <repository-url>
cd blockscout-mcp

2. 安装依赖项：

npm install

3. 构建项目：

npm run build

4. 全局安装：

npm install -g .

此全局安装使 blockscout-mcp 命令在系统范围内可用，这是 Cursor 找到并执行 MCP 服务器所必需的。

📚 详细文档

配置说明

服务器使用的环境变量如下：

• BLOCKSCOUT_API_URL：连接到的 Blockscout API 端点 URL（例如，'https://mainnet.game7.io/api' 或 'https://testnet.game7.io/api'）

Cursor MCP 配置

在你的 Cursor 的 mcp.json 文件中添加以下内容（设置 > MCP > 添加新的全局服务器）：

{
  "mcpServers": {
    "blockscout-mcp": {
      "command": "npx",
      "args": ["-y", "blockscout-mcp"],
      "env": {
        "BLOCKSCOUT_API_URL": "YOUR_API_ENDPOINT"
      }
    }
  } 
}

此配置将在 Cursor 中提供以下工具：

• search
• get_transactions
• get_blocks
• get_token_transfers
• get_stats
• get_transaction_info
• get_transaction_token_transfers
• get_transaction_internal_txs
• get_transaction_logs
• get_block_info
• get_block_transactions
• get_address_info
• get_address_token_transfers
• get_token_info
• get_token_holders
• get_internal_transactions
• get_main_page_transactions
• get_main_page_blocks
• get_indexing_status
• get_transaction_chart
• get_market_chart
• get_transaction_raw_trace
• get_transaction_state_changes
• get_transaction_summary
• get_block_withdrawals
• get_address_counters
• get_address_internal_transactions
• get_address_logs
• get_address_blocks_validated
• get_address_coin_balance_history
• get_address_coin_balance_history_by_day
• get_smart_contracts
• get_smart_contract_counters
• get_smart_contract
• get_json_rpc_url
• get_account_abstraction_status
• get_addresses
• get_address_transactions
• get_address_token_balances
• get_address_tokens
• get_address_withdrawals
• get_address_nfts
• get_address_nft_collections
• get_tokens
• get_token_transfers_list
• get_token_counters
• get_token_instances
• get_token_instance_by_id
• get_token_instance_transfers
• get_token_instance_holders
• get_token_instance_transfers_count
• refetch_token_instance_metadata
• get_withdrawals
• search_redirect