Etherscan MCP Server

一个基于Go语言的Etherscan API客户端实现，支持通过Model Context Protocol（MCP）为LLM应用提供多链区块链数据查询服务。

金融开发者工具 #区块链查询 #多链支持 #API客户端 #智能合约 .Go

评分 : 2.5分

下载量 : 12

更新时间 : 2025-04-29

什么是Etherscan MCP Server?

这是一个基于Go语言实现的Etherscan API客户端，专为Model Context Protocol (MCP)设计。它允许LLM(大语言模型)应用程序通过简单的自然语言查询访问50多个区块链网络的数据。

如何使用Etherscan MCP Server?

您可以通过两种方式使用：1) 标准输入/输出模式直接集成到LLM应用中；2) SSE(服务器发送事件)模式通过HTTP接口访问。

适用场景

适用于需要实时区块链数据的各种场景：钱包余额查询、智能合约交互、交易状态跟踪、Gas费监控等。

主要功能

多链支持支持50+区块链网络，包括以太坊、BNB Chain、Polygon等

自然语言查询使用简单英语提问即可获取区块链数据

双运行模式支持标准IO和SSE两种集成方式

全面数据覆盖提供账户、区块、合约、交易等19种区块链数据查询工具

优势与局限性

优势

单一API密钥支持所有链，简化管理

无需复杂编程，自然语言即可查询

响应速度快，数据实时性强

开源免费，社区支持

局限性

需要Etherscan API密钥(免费申请)

某些高级功能可能需要Etherscan付费计划

免费版有API调用频率限制

如何使用

获取API密钥

前往Etherscan官网注册并获取API密钥

安装服务器

克隆仓库并构建可执行文件

配置环境变量

设置您的Etherscan API密钥

运行服务器

选择适合您需求的运行模式

使用案例

查询账户余额获取指定地址的ETH或代币余额

获取合约信息查询已验证智能合约的源代码和ABI

监控Gas价格获取当前网络Gas费建议

常见问题

如何获取Etherscan API密钥?

支持哪些区块链网络?

SSE模式和标准模式有什么区别?

是否有调用频率限制?

🚀 Etherscan MCP 服务器

Etherscan MCP 服务器是一个基于 Go 语言实现的 Etherscan API 客户端，专为模型上下文协议 (MCP) 量身打造。它能够让 LLM 应用程序轻松访问以太坊区块链数据，为区块链数据的获取和使用提供了极大的便利。

✨ 主要特性

多链支持：通过访问 Etherscan API V2，实现了对多链的支持。使用单一 API 密钥，就可以调用 50 多条支持的链。
丰富的数据获取方式：支持多种区块链数据的获取，涵盖账户余额查询、块信息获取、合约数据（ABI、源代码）、气价 oracle、代币信息、交易数据等众多功能。

📦 安装指南

克隆仓库：

git clone https://github.com/huahuayu/etherscan-mcp-server.git

配置和安装步骤：
- 步骤 1：若尚未安装 Go 环境，需先下载并安装。
- 步骤 2：将上述仓库克隆到本地开发环境。
- 步骤 3：在终端进入仓库目录，运行以下命令进行安装：
```
go install
```
- 步骤 4：安装完成后，确保将可执行文件添加到系统 PATH 环境变量中。

💻 使用示例

基础用法

服务操作

启动服务：
```
mcp-server start
```
停止服务：
```
mcp-server stop
```
重启服务：
```
mcp-server restart
```

配置文件

默认情况下，服务器会读取位于 $HOME/.etherscan-mcp/config.yaml 的配置文件。您可以编辑此文件来进行以下自定义设置：

API 密钥：指定您的 Etherscan API 密钥（从 https://etherscan.io/myapikey 获取）。
监听地址：定义服务器绑定的 IP 地址。
监听端口：配置服务器运行的端口号。

示例命令

# 获取账户余额
mcp-server get-account-balance --address 0x1234567890abcdeF123456789abcdEF123456789 --chain-id 1

# 查询区块信息
mcp-server get-block-by-number --chain-id 1 --block-number 1000000

# 获取代币余额
mcp-server get-token-balance --address 0x1234567890abcdeF123456789abcdEF123456789 --chain-id 1 --contract-address 0xEeeeeEeeeEeC9c7B2CBb6bb42C975a9769e0Eed0af