Mpc 0x

🚀 MCP Ethereum Documentation

MCP (Model Context Protocol) Ethereum is an Ethereum-based model context protocol. This document will guide you on how to set up, run, and test the protocol.

🚀 Quick Start

MCP (Model Context Protocol) Ethereum is an Ethereum-based model context protocol. This document will guide you on how to set up, run, and test the protocol.

✨ Features

• Based on the Ethereum platform, providing a model context protocol.
• Support basic blockchain information retrieval, transaction sending, new block monitoring, and custom event subscription.
• Provide automated test scripts to facilitate protocol testing.

📦 Installation

Clone the Repository

1. Open the terminal and clone the MCP Ethereum repository:

   git clone <repository address>
   cd mcp-0x-address
   

2. Create and activate a virtual environment (Python 3.8+ is recommended):

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

3. Install the dependencies:

   pip install -r requirements.txt
   

💻 Usage Examples

Basic Commands

• Get blockchain information:

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

• Send a transaction:

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

Advanced Usage

• Listen for new blocks:

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

• Subscribe to custom events:

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

Example Workflow

Step 1: Initialize the Project

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

Step 2: Start the Service

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

Step 3: Send a Transaction

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

Step 4: Listen for New Blocks

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

Automated Test Script

The following is an example of an automated test script:

#!/bin/bash

# Start the Ethereum node and connect to the MCP service
geth --network development --datadir ./node_data &
GETH_PID=$!

sleep 5

python src/server.py & 
SERVER_PID=$!

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

# Wait a few seconds to confirm the transaction
sleep 5

# Query blockchain information
curl http://localhost:8080/blockchain-info > blockchain_info.json

# Stop the service and clean up
kill $SERVER_PID && kill $GETH_PID
rm -rf ./node_data

📚 Documentation

Running the Server

1. Start the Ethereum node:

   geth --network <network name> --datadir ./node_data
   

2. Start the MCP service:

   python src/server.py
   

⚠️ Important Note

1. Ensure that the Ethereum node and MCP service are started correctly.
2. When handling sensitive operations, ensure that the network environment is secure.
3. If you encounter any problems, check the log files or refer to the official documentation.

Through the above steps, you can easily configure and run the MCP Ethereum protocol.