MCP Server

A Node.js server for interacting with the Monad Testnet blockchain network. This server provides a REST API interface for common blockchain operations.

Features

• Express.js REST API
• Web3.js integration for blockchain interaction
• Environment variable configuration
• Basic blockchain operations (get balance, send transactions, etc.)
• Security middleware (helmet, cors)
• Swagger API documentation
• Docker support

Prerequisites

• Node.js (v16 or higher) OR Docker
• npm (v8 or higher) if not using Docker
• Access to a Monad Testnet node

Installation

Standard Installation

1. Clone the repository:

   git clone <repository-url>
   cd mcp-server
   

2. Install dependencies:

   npm install
   

3. Create environment file:

   cp .env.example .env
   

4. Configure your environment variables in .env:

   • Set MONAD_RPC_URL to your Monad Testnet node URL
   • Set PORT if you want to use a different port
   • Add PRIVATE_KEY if needed for signing transactions

Docker Installation

1. Clone the repository:

   git clone <repository-url>
   cd mcp-server
   

2. Create and configure environment file:

   cp .env.example .env
   # Edit .env with your configuration
   

3. Build the Docker image:

   docker build -t mcp-server .
   

4. Run the container:

   docker run -d \
     --name mcp-server \
     -p 3000:3000 \
     --env-file .env \
     -v $(pwd)/logs:/app/logs \
     mcp-server
   

Usage

Standard Usage

Start the development server:

npm run dev

Start the production server:

npm start

Docker Usage

Start the container:

docker start mcp-server

Stop the container:

docker stop mcp-server

View logs:

docker logs mcp-server

API Documentation

The API documentation is available at /api-docs when the server is running. Visit:

http://localhost:3000/api-docs

API Endpoints

• GET /health - Check server health
• GET /blockchain/latest-block - Get current block number
• GET /blockchain/analyze-block/:blockNumber - Get block analysis
• POST /blockchain/store-data - Store data in contract
• GET /blockchain/get-data - Get stored data
• POST /actions/execute-chain - Execute chain of operations
• GET /actions/parallel-block-analysis - Analyze multiple blocks

Environment Variables

Variable	Description	Default
PORT	Server port	3000
NODE_ENV	Environment mode	development
MONAD_RPC_URL	Monad Testnet RPC URL	http://localhost:8545
CONTRACT_ADDRESS	Smart contract address	-
CONTRACT_ABI	Smart contract ABI	-
LOG_LEVEL	Logging level	info

Docker Volumes

The container uses the following volume:

• /app/logs: Contains application logs (combined.log and error.log)

License

ISC