MCP Etherscan 服务器

一个 MCP (模型上下文协议) 服务器，通过 Etherscan 的 API 提供以太坊区块链数据工具。功能包括检查 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 [你的仓库地址]
cd mcp-etherscan-server

2. 安装依赖项:

npm install

3. 在根目录中创建一个 .env 文件:

ETHERSCAN_API_KEY=你的_api_密钥_在这里

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

   • 输入: 无
   • 输出: 以 Gwei 为单位的当前 Gas 价格

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 文件