以太坊Etherscan MCP服务器

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

特性

• 余额查询：获取任意以太坊地址的ETH余额
• 交易历史：查看带有详细信息的最近交易
• 代币转账：追踪ERC20代币的转账记录及其代币详情
• 合约ABI：获取智能合约的ABI，用于开发目的
• 气体价格：监控当前的气体价格（安全低、标准、快速）
• 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=你的API密钥

4. 构建项目：

npm run build

运行服务器

启动服务器：

npm start

该服务器将在标准输出上运行，使其与MCP客户端（如Claude Desktop）兼容。

工作原理

此服务器实现模型上下文协议（MCP），通过Etherscan的API提供以太坊区块链数据交互工具。每个工具作为MCP端点进行暴露，可由兼容的客户端调用。

可用工具

1. check-balance

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

2. get-transactions

   • 输入：以太坊地址、可选限制
   • 输出：最近交易，包括时间戳、价值和地址

3. get-token-transfers

   • 输入：以太坊地址、可选限制
   • 输出：近期ERC20代币转账记录及其详细信息

4. get-contract-abi

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

5. get-gas-prices

   • 输入：无
   • 输出：当前气体价格（单位为Gwei）

6. get-ens-name

   • 输入：以太坊地址
   • 输出：可用时解析出的ENS名称

与Claude Desktop一起使用

将此服务器添加到Claude Desktop：

1. 使用npm start启动服务器。

2. 在Claude Desktop中：

   • 转到设置
   • 进入MCP服务器部分
   • 点击“添加服务器”
   • 输入以下配置：

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

   • 保存配置

3. 现在，Etherscan工具将在Claude对话中可用。

Claude中的示例用法

你可以使用类似以下的命令：

检查0x742d35Cc6634C0532925a3b844Bc454e4438f44e的余额
或
显示vitalik.eth的近期交易记录

开发

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

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

许可证

MIT License - 详情请查看LICENSE文件