以太坊测试网交互服务器

一个基于web3.py的Model Context Protocol (MCP)服务器,用于与以太坊Sepolia测试网交互,提供查询余额、区块信息、发送交易等功能。

  • by me-tusharchandra
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 me-tusharchandra/ekai

使用说明

Web3Demo MCP服务器

用于与以太坊Sepolia测试网交互的模型上下文协议(MCP)服务器 web3.py该服务器将多个区块链实用程序作为MCP工具公开,使查询余额、区块信息、天然气价格以及从Claude或其他MCP客户端发送交易变得容易。


特性

  • 取得平衡:查询任何以太坊地址的以太币余额。
  • 获取区块编号:获取Sepolia上的最新区块号。
  • 获取天然气价格:获取桂当前的天然气价格。
  • 获取链ID:检索当前链ID。
  • 获取测试网信息:获取当前测试网状态的摘要。
  • 获取水龙头信息:获取Sepolia测试网水龙头的链接。
  • 发送交易:将以太币从私钥发送到另一个地址。
  • 问候资源:获得个性化问候(演示资源)。

先决条件

  • Python 3.10+ (建议使用 pyenv 或类似)
  • 炼金术 或 英富拉 Sepolia端点(免费注册)
  • 克劳德桌面应用程序 (或其他MCP兼容客户端)

安装说明

1.克隆存储库

# Clone your fork or this repo
git clone <your-repo-url>
cd ekai/ekai

2.创建并激活虚拟环境

python3 -m venv .venv
source .venv/bin/activate

3.安装依赖项

python -m pip install --upgrade pip
python -m pip install 'mcp[cli]' typer web3 eth-utils

4.配置您的以太坊RPC URL

编辑 main.py 或者在运行前设置环境变量:

export ETHEREUM_RPC_URL="https://eth-sepolia.g.alchemy.com/v2/YOUR-API-KEY"

或者使用您的Infura端点。


注册并运行MCP服务器

1.向Claude注册服务器(一次性)

mcp install main.py

2.运行服务器(保持此运行状态)

mcp run main.py

更新Claude MCP配置以获得正确的venv路径

如果你遇到 No module named 'web3' 或类似错误,请确保Claude使用您的venv启动您的服务器 mcp 二元的。编辑您的Claude配置(例如。, ~/Library/Application Support/Claude/claude_desktop_config.json)致:

"Web3Demo": {
  "command": "/Users/tusharchandra/workspace/repos/ekai/ekai/.venv/bin/mcp",
  "args": [
    "run",
    "/Users/tusharchandra/workspace/repos/ekai/ekai/main.py"
  ]
}

编辑此文件后重新启动Claude。


示例用法

  • 取得平衡
    • 输入:以太坊地址
    • 输出:ETH余额
  • 发送交易
    • 输入:私钥、收件人地址、金额(ETH)
    • 输出:交易哈希或错误
  • 获取区块编号/天然气价格/链ID/测试网信息
    • 无需输入
    • 输出:对应区块链信息
  • 获取水龙头信息
    • 无需输入
    • 输出:水龙头URL列表

MCP Server和web3。

谢谢你的时间! :)