Etherscan Tools

🚀 MCP 以太坊浏览器服务器

MCP 以太坊浏览器服务器基于模型上下文协议（Model Context Protocol）构建，借助以太坊浏览器 API 提供丰富的以太坊区块链数据工具。它能帮助用户检查 ETH 余额、查看交易记录、跟踪 ERC20 转账等，为区块链数据交互提供便利。

🚀 快速开始

先决条件

• Node.js >= 18
• 一个以太坊浏览器 API 密钥（获取方式：https://etherscan.io/apis）

安装

1. 克隆仓库：

git clone [your-repo-url]
cd mcp-etherscan-server

2. 安装依赖项：

npm install

3. 在根目录下创建一个 .env 文件：

ETHERSCAN_API_KEY=your_api_key_here

4. 构建项目：

npm run build

运行服务器

启动服务器：

npm start

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

✨ 主要特性

• 余额查询：获取任意以太坊地址的 ETH 余额
• 交易记录：查看最近的交易记录及详细信息
• 代币转账：追踪 ERC20 代币的转账记录及其代币详情
• 合约 ABI：获取智能合约的 ABI（应用二进制接口）用于开发
• 汽油价格监控：查看当前的汽油价格（安全低、标准、快速）
• ENS 解析：将以太坊地址解析为 ENS 名称

🔧 技术细节

工作原理

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

可用工具

1. check-balance

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

2. get-transactions

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

3. get-token-transfers

   • 输入：以太坊地址、可选限制
   • 输出：最近的 ERC20 代币转账记录及其代币详情

4. get-contract-abi

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

5. get-gas-prices

   • 输入：无
   • 输出：当前汽油价格（Gwei）

6. get-ens-name

   • 输入：以太坊地址
   • 输出：可用的关联 ENS 名称

💻 使用示例

与 Claude Desktop 集成

要将此服务器添加到 Claude Desktop：

1. 使用 npm start 启动服务器

2. 在 Claude Desktop 中：

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

     {
       "name": "以太坊浏览器工具",
       "transport": "stdio"
     }