🚀 以太坊Etherscan MCP服务器
本项目是一个基于MCP（模型上下文协议）的服务器，借助Etherscan API，为用户提供丰富的以太坊区块链数据查询工具。用户可以通过它检查ETH余额、查看交易历史记录、跟踪ERC20代币转账、获取智能合约ABI、监控气体价格以及解析ENS名称，极大地提升了以太坊数据交互的便利性。
🚀 快速开始
本服务器实现模型上下文协议（MCP），通过Etherscan的API提供以太坊区块链数据交互工具。每个工具作为MCP端点进行暴露，可由兼容的客户端调用。
先决条件
- Node.js >= 18
- Etherscan API密钥（可在https://etherscan.io/apis获取）
安装步骤
- 克隆仓库：
git clone [your-repo-url]
cd mcp-etherscan-server
- 安装依赖项：
npm install
- 在根目录创建一个
.env文件：
ETHERSCAN_API_KEY=你的API密钥
- 构建项目：
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：
- 使用
npm start启动服务器。 - 在Claude Desktop中：
- 转到设置
- 进入MCP服务器部分
- 点击“添加服务器”
- 输入以下配置：
{ "name": "Etherscan工具", "transport": "stdio", "command": "node /path/to/mcp-etherscan-server/build/index.js" } - 保存配置
- 现在，Etherscan工具将在Claude对话中可用。
📚 详细文档
可用工具
-
check-balance- 输入：以太坊地址
- 输出：ETH余额（单位为Wei和ETH）
-
get-transactions- 输入：以太坊地址、可选限制
- 输出：最近交易，包括时间戳、价值和地址
-
get-token-transfers- 输入：以太坊地址、可选限制
- 输出：近期ERC20代币转账记录及其详细信息
-
get-contract-abi- 输入：合约地址
- 输出：JSON格式的合约ABI
-
get-gas-prices- 输入：无
- 输出：当前气体价格（单位为Gwei）
-
get-ens-name- 输入：以太坊地址
- 输出：可用时解析出的ENS名称
🔧 技术细节
开发逻辑
- 主服务器逻辑在
src/server.ts。 - Etherscan API交互处理在
src/services/etherscanService.ts。
修改与构建
若要添加新功能或修改现有功能，修改相关代码后，使用npm run build进行构建。
📄 许可证
本项目采用MIT License，详情请查看LICENSE文件。