返回 MCP 目录
public公开dns本地运行

mpc-0x

一个基于MCP协议的以太坊地址信息服务,提供多链地址信息查询和实时更新功能。

article

README

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

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端