shield_lock
金大哥
← 返回 MCP 目录
public公开dns本地运行

eth-mcp-server

一个基于MCP协议的以太坊数据服务项目，为AI助手提供实时区块链数据查询功能，包括余额、价格、交易等以太坊相关信息。

article

README

🚀 eth-mcp-server

eth-mcp-server 是一个专注于以太坊的 MCP 服务器，其开发者仍在探索它的最终应用场景。目前，它主要是为了给大家带来乐趣而创建的！

🚀 快速开始

先决条件

  • Python 3.7+
  • web3.py
  • requests
  • mcp.server.fastmcp

安装步骤

  1. 克隆仓库
  2. 安装所需依赖： 
    pip install web3 requests
pip install mcp mcp[cli]
pip install uv
  3. 在代码中替换以太坊scan API密钥： 
    ETHERSCAN_API_KEY = "YOUR_API_KEY_HERE"

在Cursor中设置

  1. 打开Cursor的MCP设置

  2. 点击“添加新的全局MCP服务器”按钮

  3. 设置如下配置，其中请用您自己的路径替换路径：

{
  "mcpServers": {
    "eth": {
      "type": "stdio",
      "command": "/path/to/python /path/to/blockchain.py"
    }
  }
}
  1. 成功设置后，您可以在Cursor中使用聊天功能获取以太坊信息。

✨ 主要特性

关于 MCP

模型上下文协议（MCP）允许AI模型通过标准化工具和资源实时访问数据并执行操作。此实现为AI助手提供了以太坊区块链功能。

当前支持的工具和服务

  • 获取任意以太坊地址的ETH余额
  • 检查当前以太坊价格（USD）
  • 查看以太坊网络当前_gas_价格
  • 获取最新区块信息
  • 查看交易详情
  • 估算交易费用
  • 查询账户交易历史

可用工具

  • get_eth_balance(address) - 获取地址的ETH余额
  • get_eth_price() - 获取当前以太坊价格（USD）
  • get_gas_price() - 获取以太坊网络当前_gas_价格
  • get_latest_block() - 获取最新区块信息
  • get_transaction(tx_hash) - 获取交易详情
  • estimate_tx_fee(gas_amount) - 估算交易费用
  • get_account_transactions(address, page, offset) - 获取账户交易历史

可用资源

  • ethereum://price - 以太坊价格信息
  • ethereum://stats - 以太坊网络统计信息
  • ethereum://address/{address} - 地址信息
  • ethereum://address/{address}/transactions - 地址交易历史

🔧 技术细节

API端点

该服务使用的外部API包括：

  • 通过LlamaRPC的以太坊JSON-RPC API
  • CoinGecko API用于ETH价格
  • Etherscan API用于交易历史

💻 使用示例

示例展示

即贴即用配置

MCP 客户端配置生成器

选择客户端，补齐所需环境变量，再复制根据当前 MCP 公开配置生成的完整文件

terminal
data_object

当前条目没有标准 command 或远程 URL，暂时无法安全生成客户端配置

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载，用户一般按页面提供的连接方式或授权流程接入，不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖，把 server_config 复制到 MCP 客户端，并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端