MCP Etherscan Server

MCP Etherscan 服务

一个通过 Etherscan API 提供以太坊区块链数据工具的 MCP（模型上下文协议）服务。功能包括查询 ETH 余额、查看交易历史、追踪 ERC20 转账、获取合约 ABI、监控 Gas 价格以及解析 ENS 名称。

功能

• 余额查询：查询任意以太坊地址的 ETH 余额
• 交易历史：查看近期交易及其详细信息
• 代币转账：追踪 ERC20 代币转账及代币详情
• 合约 ABI：获取智能合约 ABI，供开发使用
• Gas 价格：监控当前 Gas 价格（低速、安全、快速）
• ENS 解析：将以太坊地址解析为 ENS 名称

前置条件

• Node.js >= 18
• Etherscan API 密钥（可在 https://etherscan.io/apis 获取）

安装

1. 克隆代码库：

git clone [your-repo-url]
cd mcp-etherscan-server

2. 安装依赖项：

npm install

3. 在根目录中创建 .env 文件：

ETHERSCAN_API_KEY=your_api_key_here

4. 构建项目：

npm run build

运行服务

启动服务：

npm start

服务将通过 stdio 运行，因此兼容 Claude Desktop 等 MCP 客户端。

工作原理

此服务实现了模型上下文协议（MCP），通过 Etherscan API 提供用于交互和查询以太坊区块链数据的工具。每个工具都作为 MCP 端点公开，兼容的客户端可以调用这些端点。

可用工具

1. check-balance

   • 输入：以太坊地址
   • 输出：以 Wei 和 ETH 为单位的 ETH 余额

2. get-transactions

   • 输入：以太坊地址，可选的数量上限
   • 输出：近期交易及其时间戳、金额和地址

3. get-token-transfers

   • 输入：以太坊地址，可选的数量上限
   • 输出：近期 ERC20 代币转账及代币详情

4. get-contract-abi

   • 输入：合约地址
   • 输出：JSON 格式的合约 ABI

5. get-gas-prices

   • 输入：无
   • 输出：当前 Gas 价格，单位为 Gwei

6. get-ens-name

   • 输入：以太坊地址
   • 输出：可用时返回关联的 ENS 名称

与 Claude Desktop 配合使用

要将此服务添加到 Claude Desktop：

1. 使用 npm start 启动服务

2. 在 Claude Desktop 中：

   • 前往设置
   • 找到 MCP 服务部分
   • 点击“添加服务”
   • 输入以下配置：

     {
       "name": "Etherscan Tools",
       "transport": "stdio",
       "command": "node /path/to/mcp-etherscan-server/build/index.js"
     }
     

   • 保存配置

3. Etherscan 工具现在即可在 Claude 对话中使用

在 Claude 中的使用示例

你可以使用如下命令：

Check the balance of 0x742d35Cc6634C0532925a3b844Bc454e4438f44e

或

Show me recent transactions for vitalik.eth

开发

要添加新功能或修改现有功能：

1. 主服务逻辑位于 src/server.ts
2. Etherscan API 交互由 src/services/etherscanService.ts 处理
3. 修改后进行构建：npm run build

许可证

MIT 许可证——详情请参阅 LICENSE 文件