Etherscan Tools MCP 服务器使用说明

项目简介

Etherscan Tools MCP 服务器是一个实现了 Model Context Protocol (MCP) 的后端应用，它利用 Etherscan API 提供了多种查询以太坊区块链数据的功能。通过此服务器，LLM 客户端可以方便地获取以太坊地址的余额、交易记录、代币转移信息、合约ABI、实时Gas价格以及ENS域名解析等数据，从而增强 LLM 在区块链相关应用场景中的能力。

主要功能点

查询ETH余额: 获取指定以太坊地址的 ETH 余额。
查询交易记录: 查看指定以太坊地址的近期交易历史。
查询代币转移记录: 追踪指定以太坊地址的 ERC20 代币转移记录。
获取合约ABI: 获取指定智能合约地址的应用程序二进制接口 (ABI)。
获取Gas价格: 监控当前以太坊网络的 Gas 价格（安全、标准、快速）。
ENS域名解析: 将以太坊地址解析为对应的 ENS 域名。

安装步骤

克隆仓库:

git clone https://github.com/crazyrabbitLTC/mcp-etherscan-server
cd mcp-etherscan-server

安装依赖: 确保已安装 Node.js (>= 18)，然后运行：
```
npm install
```
配置 Etherscan API 密钥:
- 访问 Etherscan 官网注册并获取 API Key。
- 在项目根目录下创建 '.env' 文件，并填入你的 API Key：
```
ETHERSCAN_API_KEY=你的_Etherscan_API_密钥
```
构建项目:
```
npm run build
```
启动服务器:
```
npm start
```
服务器将在标准输入输出 (stdio) 上运行。

服务器配置

要将此 MCP 服务器添加到支持 MCP 协议的客户端（例如 Claude Desktop），你需要提供以下配置信息。客户端将使用这些信息连接到服务器并调用其提供的工具。

{
  "name": "Etherscan Tools",  // 服务器名称，自定义
  "transport": "stdio",      // 使用 stdio 传输协议
  "command": "node",         // 启动服务器的命令，这里使用 node
  "args": [                  // 命令参数
    "/path/to/mcp-etherscan-server/build/index.js" //  指向编译后的服务器入口文件 index.js 的绝对路径。请替换为实际路径，例如：/Users/username/mcp-etherscan-server/build/index.js
  ]
}

注意: 请将 '"/path/to/mcp-etherscan-server/build/index.js"' 替换为你本地 'mcp-etherscan-server/build/index.js' 文件的绝对路径。

基本使用方法

服务器启动后，在支持 MCP 协议的客户端中配置并连接到该服务器。连接成功后，你就可以通过自然语言指令或客户端提供的界面调用 Etherscan Tools 服务器提供的各种工具，查询以太坊区块链数据。

例如，在 Claude 中，你可以这样提问：

Check the balance of 0x742d35Cc6634C0532925a3b844Bc454e4438f44e

或者

Show me recent transactions for vitalik.eth

服务器会将查询结果返回给客户端，客户端会将结果展示给你。具体的使用方式取决于你使用的 MCP 客户端的功能和界面。

关键词