MCP Etherscan Server

MCP以太网扫描服务器

MCP（模型上下文协议）服务器，通过Etherscan的API提供以太坊区块链数据工具。功能包括检查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

1. 安装依赖项：

npm install

1. 创建一个 .env 根目录中的文件：

ETHERSCAN_API_KEY=your_api_key_here

1. 构建项目：

npm run build

运行服务器

启动服务器：

npm start

服务器将在stdio上运行，使其与Claude Desktop等MCP客户端兼容。

运作原理

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

可用工具

1. check-balance

- 输入：以太坊地址 - 输出：Wei和ETH的ETH余额

1. get-transactions

- 输入：以太坊地址，可选限制 - 输出：带有时间戳、值和地址的最近交易

1. get-token-transfers

- 输入：以太坊地址，可选限制 - 输出：最近的ERC20代币转移，包括代币详细信息

1. get-contract-abi

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

1. get-gas-prices

- 输入：无 - 产量：桂目前的天然气价格

1. get-ens-name

- 输入：以太坊地址 - 输出：相关ENS名称（如果可用）

与Claude Desktop一起使用

要将此服务器添加到Claude Desktop，请执行以下操作：

1. 使用启动服务器 npm start

1. 在克劳德桌面中：

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

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

- 保存配置

1. 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许可证-有关详细信息，请参阅许可证文件