MCP Etherscan Server

MCP Etherscan Server

site icon
2025.01.01 13
TypeScript以太坊区块链数据查询区块链开发工具金融服务
MCP Etherscan Server 是一个基于 Model Context Protocol (MCP) 的服务,通过 Etherscan API 提供以太坊区块链数据工具。它支持查询 ETH 余额、查看交易历史、跟踪 ERC20 代币转账、获取智能合约 ABI、监控 gas 价格以及解析 ENS 名称等功能。
View on GitHub

Overview

基本能力

产品定位

MCP Etherscan Server 是一个以太坊区块链数据查询工具,通过 Etherscan API 提供丰富的区块链数据服务。

核心功能

  • 余额查询:获取任意以太坊地址的 ETH 余额
  • 交易历史:查看带有详细信息的最近交易记录
  • 代币转账:跟踪 ERC20 代币转账及代币详情
  • 合约 ABI:获取智能合约 ABI 用于开发
  • Gas 价格:监控当前 gas 价格(安全低、标准、快速)
  • ENS 解析:将以太坊地址解析为 ENS 名称

适用场景

  • 开发者在构建 DApp 时需要查询区块链数据
  • 用户需要查询自己的以太坊账户余额和交易记录
  • 需要监控 gas 价格以优化交易成本
  • 需要解析 ENS 名称或查询智能合约 ABI

工具列表

  1. check-balance:查询以太坊地址的 ETH 余额
  2. get-transactions:获取指定地址的交易历史
  3. get-token-transfers:获取 ERC20 代币转账记录
  4. get-contract-abi:获取智能合约 ABI
  5. get-gas-prices:获取当前 gas 价格
  6. get-ens-name:解析 ENS 名称

常见问题解答

  • 需要 Node.js >= 18 环境
  • 需要从 Etherscan 获取 API 密钥
  • 服务器运行在 stdio 模式,兼容 Claude Desktop 等 MCP 客户端

使用教程

使用依赖

  • Node.js >= 18
  • Etherscan API 密钥(从 https://etherscan.io/apis 获取)

安装教程

  1. 克隆仓库:
git clone [your-repo-url]
cd mcp-etherscan-server
  1. 安装依赖:
npm install
  1. 创建 .env 文件:
ETHERSCAN_API_KEY=your_api_key_here
  1. 构建项目:
npm run build

调试方式

启动服务器:

npm start

在 Claude Desktop 中添加服务器配置:

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

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。