Pikimon MCP Server

🚀 MCP Server

This is a server built with Node.js to interact with the Monad testnet blockchain network. It provides a REST API for common blockchain operations.

🚀 Quick Start

This server is designed to interact with the Monad testnet blockchain network. It offers a REST API for performing common blockchain operations.

✨ Features

• REST API based on Express.js
• Integration of Web3.js for blockchain interaction
• Configuration via environment variables
• Support for basic blockchain operations (e.g., getting balance, sending transactions)
• Security middleware (helmet, cors)
• Swagger API documentation
• Docker support

📦 Installation

Prerequisites

• Node.js (v16 or higher) or Docker
• If not using Docker, npm (v8 or higher) is required
• Access to a Monad testnet node

Standard Installation

1. Clone the repository:

   git clone <repository-url>
   cd mcp-server
   

2. Install dependencies:

   npm install
   

3. Create an environment file:

   cp .env.example .env
   

4. Configure environment variables in .env:
   • Set MONAD_RPC_URL to your Monad testnet node URL.
   • Set PORT if you need to change the port.
   • Add PRIVATE_KEY for signing transactions.

Docker Installation

1. Clone the repository:

   git clone <repository-url>
   cd mcp-server
   

2. Create and configure the environment file:

   cp .env.example .env
   # Edit `.env` for 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 Examples

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

📚 Documentation

API Documentation

The API documentation can be accessed at /api-docs when the server is running. Access URL:

http://localhost:3000/api-docs

API Endpoints

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

Environment Variables

Docker Volumes

The container uses the following volume:

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

📄 License

ISC