eth-mcp-server

eth-mcp-server

一个痴迷于 ETH 的 MCP 服务，创建者仍在思索它的终极用途。目前，它只是用来好玩的！

关于 MCP

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

功能

目前支持工具和资源

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

要求

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

安装

1. 克隆代码库
2. 安装所需依赖：

   pip install web3 requests
   pip install mcp mcp[cli]
   pip install uv
   

3. 将代码中的 Etherscan API 密钥替换为你自己的密钥：

   ETHERSCAN_API_KEY = "YOUR_API_KEY_HERE"
   

可用工具

• get_eth_balance(address) - 获取某个地址的 ETH 余额
• get_eth_price() - 获取当前以美元计价的以太坊价格
• 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，用于获取交易历史

如何在 Cursor 中设置

1. 打开 Cursor MCP 设置

2. 点击 Add new Global mcp server 按钮

3. 按照此示例设置配置，请将路径替换为你自己的路径

{
  "mcpServers": {
    "eth": {
      "type": "stdio",
      "command": "/path/to/python /path/to/blockchain.py"
    }
  }
}

4. 设置成功后，你可以在 Cursor 中通过聊天获取 ETH 信息。

示例