Mpc 0x

🚀 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 以太坊協議。