🚀 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 以太坊协议。