ekai (Me Tusharchandra)

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 
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。

谢谢你的时间！ :)