MCP 以太坊文档

简介

MCP（Model Context Protocol）以太坊是一个基于以太坊的模型上下文协议。本文档将指导你如何设置、运行和测试该协议。

安装与配置

克隆仓库

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

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

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

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

3. 安装依赖项：

   pip install -r requirements.txt
   

运行服务器

1. 启动以太坊节点：

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

2. 启动 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

注意事项

1. 确保以太坊节点和 MCP 服务已正确启动。
2. 处理敏感操作时，请确保网络环境安全。
3. 如遇问题，请检查日志文件或查阅官方文档。

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