Ethereum MCP Server

Ethereum MCP Server

警告：此仓库处于高度实验阶段，目前很可能无法运行。项目仍在积极开发中；待确认可以安全运行后，我们会更新此警告。

这是一个功能全面的 Ethereum MCP 服务实现，支持钱包管理、交易处理和合约交互。基于 FastAPI 和 Web3.py 构建。

功能

钱包管理

• 创建新钱包
• 导入现有钱包
• 列出已管理的钱包
• 查询 ETH 余额
• 安全处理私钥

交易管理

• 发送 ETH 交易
• 获取交易详情
• 获取交易回执
• 估算 Gas
• 管理 Nonce
• 监控交易

合约交互

• 使用 ABI 部署合约
• 加载现有合约
• 调用会改变状态的方法
• 读取合约状态
• 查询合约事件
• 管理 ABI

部署合约

使用字节码和 ABI 部署新合约：

{
  "method": "eth_deployContract",
  "params": {
    "from": "0x742d35Cc6634C0532925a3b844Bc9e7595f62b8e",
    "abi": [...],  // Contract ABI array
    "bytecode": "0x608060...",  // Contract bytecode
    "constructorArgs": ["arg1", 123]  // Optional constructor arguments
  }
}

加载合约

加载已部署的现有合约：

{
  "method": "eth_loadContract",
  "params": {
    "address": "0x1234567890123456789012345678901234567890",
    "abi": [...]  // Contract ABI array
  }
}

调用合约方法（改变状态）

执行会改变合约状态的交易：

{
  "method": "eth_callContractMethod",
  "params": {
    "contractAddress": "0x1234567890123456789012345678901234567890",
    "methodName": "transfer",
    "args": ["0x742d35Cc6634C0532925a3b844Bc9e7595f62b8e", 1000],
    "from": "0x742d35Cc6634C0532925a3b844Bc9e7595f62b8e"
  }
}

读取合约状态

调用 view/pure 函数，无需发送交易：

{
  "method": "eth_readContract",
  "params": {
    "contractAddress": "0x1234567890123456789012345678901234567890",
    "methodName": "balanceOf",
    "args": ["0x742d35Cc6634C0532925a3b844Bc9e7595f62b8e"]
  }
}

查询合约事件

检索合约的历史事件：

{
  "method": "eth_getContractEvents",
  "params": {
    "contractAddress": "0x1234567890123456789012345678901234567890",
    "eventName": "Transfer",
    "fromBlock": 0,
    "toBlock": "latest",
    "filters": {  // Optional event filters
      "from": "0x742d35Cc6634C0532925a3b844Bc9e7595f62b8e"
    }
  }
}

注意： 所有合约交互方法都需要合约 ABI（应用程序二进制接口），以便正确编码/解码函数调用和事件。ABI 必须以符合 Ethereum 标准 ABI 格式的 JSON 数组提供。

代币管理（即将推出）

• 查询 ERC20 余额
• 转账 ERC20
• 获取 NFT 元数据
• 转移 NFT
• 管理代币授权

高级功能（即将推出）

• EIP-7702 委托
• 获取事件日志
• 部分提现
• 全额提现
• 批量操作

快速开始

1. 安装依赖项：

uv venv
source .venv/bin/activate
uv pip install -e .

2. 设置环境变量：

cp .env.example .env
# Edit .env with your configuration

3. 运行服务：

python src/server.py

API 方法

钱包方法

{
  "method": "eth_createWallet",
  "params": {}
}

{
  "method": "eth_importWallet",
  "params": {
    "privateKey": "0x..."
  }
}

{
  "method": "eth_listWallets",
  "params": {}
}

{
  "method": "eth_getBalance",
  "params": {
    "address": "0x..."
  }
}

交易方法

{
  "method": "eth_sendTransaction",
  "params": {
    "from": "0x...",
    "to": "0x...",
    "value": "0x...",
    "gas": "0x...",
    "gasPrice": "0x..."
  }
}

{
  "method": "eth_getTransaction",
  "params": {
    "hash": "0x..."
  }
}

{
  "method": "eth_getTransactionReceipt",
  "params": {
    "hash": "0x..."
  }
}

{
  "method": "eth_estimateGas",
  "params": {
    "from": "0x...",
    "to": "0x...",
    "value": "0x..."
  }
}

开发

项目结构

src/
├── server.py           # Main FastAPI server
├── core/              # Core functionality
│   ├── wallet.py      # Wallet management
│   ├── transaction.py # Transaction handling
│   ├── contract.py    # Contract interaction
│   └── token.py       # Token/NFT handling
├── models/            # Data models
└── utils/             # Utilities

运行测试

pytest

代码风格

ruff check .
ruff format .

贡献

1. Fork 此仓库
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建 Pull Request

许可证

MIT