Crazyrabbitltc MCP Etherscan Server

🚀 以太坊Etherscan MCP服务器

本项目是一个基于MCP（模型上下文协议）的服务器，借助Etherscan API，为用户提供丰富的以太坊区块链数据查询工具。用户可以通过它检查ETH余额、查看交易历史记录、跟踪ERC20代币转账、获取智能合约ABI、监控气体价格以及解析ENS名称，极大地提升了以太坊数据交互的便利性。

🚀 快速开始

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

先决条件

• Node.js >= 18
• Etherscan API密钥（可在https://etherscan.io/apis获取）

安装步骤

1. 克隆仓库：

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

2. 安装依赖项：

npm install

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

ETHERSCAN_API_KEY=你的API密钥

4. 构建项目：

npm run build

运行服务器

启动服务器：

npm start

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

✨ 主要特性

• 余额查询：可获取任意以太坊地址的ETH余额。
• 交易历史：能查看带有详细信息的最近交易。
• 代币转账：可追踪ERC20代币的转账记录及其代币详情。
• 合约ABI：能获取智能合约的ABI，满足开发需求。
• 气体价格：可监控当前的气体价格（安全低、标准、快速）。
• ENS解析：可将以太坊地址解析为ENS名称。

📦 安装指南

克隆仓库

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

安装依赖

npm install

配置环境变量

在根目录创建一个.env文件，并填入Etherscan API密钥：

ETHERSCAN_API_KEY=你的API密钥

构建项目

npm run build

💻 使用示例

基础用法

使用Claude Desktop调用服务器工具示例：

检查0x742d35Cc6634C0532925a3b844Bc454e4438f44e的余额
或
显示vitalik.eth的近期交易记录

高级用法

与Claude Desktop集成

将此服务器添加到Claude Desktop：

1. 使用npm start启动服务器。
2. 在Claude Desktop中：
   • 转到设置
   • 进入MCP服务器部分
   • 点击“添加服务器”
   • 输入以下配置：

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

   • 保存配置
3. 现在，Etherscan工具将在Claude对话中可用。

📚 详细文档

可用工具

1. check-balance

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

2. get-transactions

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

3. get-token-transfers

   • 输入：以太坊地址、可选限制
   • 输出：近期ERC20代币转账记录及其详细信息

4. get-contract-abi

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

5. get-gas-prices

   • 输入：无
   • 输出：当前气体价格（单位为Gwei）

6. get-ens-name

   • 输入：以太坊地址
   • 输出：可用时解析出的ENS名称

🔧 技术细节

开发逻辑

• 主服务器逻辑在src/server.ts。
• Etherscan API交互处理在src/services/etherscanService.ts。

修改与构建

若要添加新功能或修改现有功能，修改相关代码后，使用npm run build进行构建。

📄 许可证

本项目采用MIT License，详情请查看LICENSE文件。