JinDaGe - mpc-0x MCP Details

article

README

🚀 MCP 以太坊文档

MCP（Model Context Protocol）以太坊是一个基于以太坊的模型上下文协议。本文档将为你详细指导该协议的设置、运行和测试方法，助你快速上手。

🚀 快速开始

克隆仓库

打开终端，克隆 MCP 以太坊仓库：

git clone <仓库地址>
cd mcp-0x-address

创建并激活虚拟环境（推荐使用 Python 3.8+）：

python -m venv .venv
source .venv/bin/activate  # 对于 Linux/Mac
.\.env\Scripts\activate  # 对于 Windows

安装依赖项：
```
pip install -r requirements.txt
```

运行服务器

启动以太坊节点：

geth --network <网络名称> --datadir ./node_data

启动 MCP 服务：
```
python src/server.py
```

✨ 主要特性

本协议提供了丰富的功能，涵盖基本命令操作和高级功能使用，能够满足不同场景下的需求。

💻 使用示例

基本用法

获取区块链信息：

curl http://localhost:8080/blockchain-info

发送交易：

curl -X POST http://localhost:8080/send-transaction \
  -H "Content-Type: application/json" \
  -d '{"from":"0x123...", "to":"0x456...", "value":100}'

高级用法

监听新区块：

curl http://localhost:8080/new-blocks/websocket

自定义事件订阅：

curl -X POST http://localhost:8080/subscribe-events \
  -H "Content-Type: application/json" \
  -d '{"event":"Transfer","address":"0x123..."}'

📚 详细文档

示例工作流程

步骤 1：初始化项目

git clone <仓库地址>
cd mcp-0x-address
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

步骤 2：启动服务

geth --network development --datadir ./node_data
python src/server.py

步骤 3：发送交易

curl -X POST http://localhost:8080/send-transaction \
  -H "Content-Type: application/json" \
  -d '{"from":"0x123...", "to":"0x456...", "value":100}'

步骤 4：监听新区块

curl http://localhost:8080/new-blocks/websocket

自动化测试脚本

以下是一个自动化测试脚本示例：

#!/bin/bash

# 启动以太坊节点并连接到 MCP 服务
geth --network development --datadir ./node_data &
GETH_PID=$!

sleep 5

python src/server.py & 
SERVER_PID=$!

# 发送测试交易
curl -X POST http://localhost:8080/send-transaction \
  -H "Content-Type: application/json" \
  -d '{"from":"0x123...", "to":"0x456...", "value":100}'

# 等待几秒钟确认交易
sleep 5

# 查询区块链信息
curl http://localhost:8080/blockchain-info > blockchain_info.json

# 停止服务并清理
kill $SERVER_PID && kill $GETH_PID
rm -rf ./node_data

⚠️ 注意事项

⚠️ 重要提示

确保以太坊节点和 MCP 服务已正确启动。

处理敏感操作时，请确保网络环境安全。

如遇问题，请检查日志文件或查阅官方文档。

通过以上步骤，你可以轻松配置并运行 MCP 以太坊协议。

mpc-0x