Etherscan

Etherscan

🚀 MCP 以太坊扫描服务器

MCP 以太坊扫描服务器是基于模型上下文协议(MCP)构建的,借助以太坊扫描 API 为用户提供丰富的以太坊区块链数据工具。这些工具能帮助用户检查 ETH 余额、查看交易历史、跟踪 ERC20 转账、获取智能合约 ABI、监控气体价格以及解析 ENS 名称,极大地提升了与以太坊区块链交互的便利性。

✨ 主要特性

  • 余额检查:能够快速获取任何以太坊地址的 ETH 余额。
  • 交易历史:可查看最近的交易及其详细信息,掌握账户动态。
  • 代币转账:精准跟踪 ERC20 代币转账及代币详情,便于关注资产流向。
  • 合约 ABI:为开发人员提供智能合约的 ABI,助力开发工作。
  • 气体价格:实时监控当前气体价格(安全低、标准、快速),合理规划交易成本。
  • ENS 解析:将以太坊地址解析为 ENS 名称,使地址更易记忆和识别。

📦 安装指南

先决条件

  • Node.js >= 18
  • 一个以太坊扫描 API 密钥(获取方式:https://etherscan.io/apis)

安装步骤

  1. 克隆仓库:
git clone [你的仓库地址]
cd mcp-etherscan-server
  1. 安装依赖项:
npm install
  1. 在根目录创建一个 .env 文件:
ETHERSCAN_API_KEY=你的_api_密钥
  1. 构建项目:
npm run build

💻 使用示例

运行服务器

启动服务器:

npm start

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

与 Claude Desktop 使用

添加服务器到 Claude Desktop

  1. 使用 npm start 启动服务器。
  2. 在 Claude Desktop 中:
    • 进入设置
    • 浏览到 MCP 服务器部分
    • 点击“添加服务器”
    • 输入以下配置:
      {
      "name": "以太坊扫描工具",
      "transport": "stdio",
      "command": "node /path/to/mcp-etherscan-server/build/index.js"
      }
      
    • 保存配置
  3. 现在,以太坊扫描工具将在您的 Claude 对话中可用。

在 Claude 中使用示例

您可以使用以下命令:

检查 0x742d35Cc6634C0532925a3b844Bc454e4438f44e 的余额

显示 vitalik.eth 的最近交易

📚 详细文档

工作原理

此服务器实现模型上下文协议 (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 名称(如有)

🔧 技术细节

开发

要添加新功能或修改现有功能:

  1. 主服务器逻辑位于 src/server.ts
  2. 以太坊扫描 API 交互处理在 src/services/etherscanService.ts
  3. 修改后进行构建:npm run build

📄 许可证

本项目采用 MIT License,有关详细信息请参阅 LICENSE。

  • 0 关注
  • 0 收藏,29 浏览
  • system 提出于 2025-09-26 14:09

相似服务问题

相关AI产品