MCP Etherscan Server

基本能力

产品定位

MCP Etherscan Server 是一个以太坊区块链数据查询工具，通过 MCP 协议提供服务。

核心功能

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

适用场景

• 以太坊钱包余额查询
• 交易历史分析
• ERC20 代币转账跟踪
• 智能合约开发
• Gas 价格监控
• ENS 名称解析

工具列表

1. check-balance
2. 输入：以太坊地址

3. 输出：以 Wei 和 ETH 为单位的余额

4. get-transactions

5. 输入：以太坊地址，可选限制

6. 输出：带有时间戳、值和地址的近期交易

7. get-token-transfers

8. 输入：以太坊地址，可选限制

9. 输出：带有代币详情的近期 ERC20 代币转账

10. get-contract-abi

11. 输入：合约地址

12. 输出：JSON 格式的合约 ABI

13. get-gas-prices

14. 输入：无

15. 输出：以 Gwei 为单位的当前 gas 价格

16. get-ens-name

17. 输入：以太坊地址
18. 输出：可用的关联 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 客户端兼容。

常见问题解答

1. 如何获取 Etherscan API 密钥？

2. 访问 https://etherscan.io/apis 注册并获取 API 密钥

3. 如何与 Claude Desktop 集成？

4. 启动服务器后，在 Claude Desktop 的 MCP Servers 部分添加服务器配置

5. 如何添加新功能？

6. 修改 src/server.ts 和 src/services/etherscanService.ts 文件，然后运行 npm run build

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。