🚀 MCP 以太坊浏览器服务器
MCP 以太坊浏览器服务器基于 Model Context Protocol (MCP)，借助 Etherscan 的 API，为用户提供丰富的以太坊区块链数据工具。它可以帮助用户检查 ETH 余额、查看交易历史、追踪 ERC20 转账、获取智能合约 ABI、监控气体价格以及解析 ENS 名称，极大地提升了用户与以太坊区块链交互的便利性。
✨ 主要特性
- 余额检查：可查询任意以太坊地址的 ETH 余额。
- 交易记录：能查看最近的交易及其详细信息。
- 代币转账：可追踪 ERC20 代币转账及代币详情。
- 合约 ABI：能获取智能合约的 ABI 用于开发。
- 气体价格：可监控当前的气体价格（安全低、标准、快速）。
- ENS 解析：可将以太坊地址解析为 ENS 名称。
📦 安装指南
先决条件
- Node.js >= 18
- Etherscan API 密钥（前往 https://etherscan.io/apis 获取）
安装步骤
- 克隆仓库：
git clone [your-repo-url]
cd mcp-etherscan-server
- 安装依赖项：
npm install
- 在根目录创建一个
.env文件：
ETHERSCAN_API_KEY=your_api_key_here
- 构建项目：
npm run build
🚀 快速开始
启动服务器
运行以下命令启动服务器：
npm start
服务器将在标准输入输出上运行，使其与 MCP 客户端（如 Claude Desktop）兼容。
💻 使用示例
可用工具
check-balance- 输入：以太坊地址
- 输出：ETH 余额（单位为 Wei 和 ETH）
get-transactions- 输入：以太坊地址，可选限制数量
- 输出：最近的交易记录，包括时间戳、价值和地址
get-token-transfers- 输入：以太坊地址，可选限制数量
- 输出：最近的 ERC20 代币转账及代币详情
get-contract-abi- 输入：合约地址
- 输出：合约 ABI 的 JSON 格式
get-gas-prices- 输入：无
- 输出：当前气体价格（单位为 Gwei）
get-ens-name- 输入：以太坊地址
- 输出：关联的 ENS 名称（若有）
在 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 对话中可用。
示例用法
在 Claude 中可以使用如下命令：
检查 0x742d35Cc6634C0532925a3b844Bc454e4438f44e 的余额
或
显示 vitalik.eth 的最近交易记录
🔧 技术细节
该服务器实现了 Model Context Protocol (MCP)，通过 Etherscan 的 API 提供以太坊区块链数据工具。每个工具作为 MCP 端点暴露出来，可被兼容客户端调用。
📚 详细文档
开发
若要添加新功能或修改现有功能，可按以下步骤操作：
- 主服务器逻辑位于
src/server.ts。 - Etherscan API 交互处理在
src/services/etherscanService.ts。 - 修改后进行构建：
npm run build
📄 许可证
[在此处添加许可证信息，例如 MIT 或 GPL]
通过此 MCP 以太坊浏览器服务器，您可以方便地集成和管理以太坊区块链数据，适用于开发人员、研究人员及区块链爱好者。