以太坊数据查询服务

一个基于Model Context Protocol (MCP)框架的以太坊区块链数据查询服务,提供余额查询、价格获取、交易历史等功能。

  • by qingfengzxr
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 qingfengzxr/eth-mcp-server

使用说明

eth-mcp服务器

一个痴迷于ETH的MCP服务器,创建者仍在思考其最终用途。现在,这只是为了好玩!

关于MCP

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

特性

现在是支持工具和资源

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

需求

  • Python 3.7+
  • web3.py
  • 请求:
  • 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() -获取当前以太坊网络天然气价格
  • 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:

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

如何使用光标进行设置

  1. 打开光标mcp设置

  2. 点击 Add new Global mcp server 按钮

  3. 这样设置配置,请用您自己的路径替换路径

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

例子