pikimon

内容来源：README.md（说明文档） · 原始地址 · 查看安装指南

原始内容

# 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:
   ```bash
   git clone <repository-url>
   cd mcp-server
   ```

2. Install dependencies:
   ```bash
   npm install
   ```

3. Create environment file:
   ```bash
   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:
   ```bash
   git clone <repository-url>
   cd mcp-server
   ```

2. Create and configure environment file:
   ```bash
   cp .env.example .env
   # Edit .env with your configuration
   ```

3. Build the Docker image:
   ```bash
   docker build -t mcp-server .
   ```

4. Run the container:
   ```bash
   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:
```bash
npm run dev
```

Start the production server:
```bash
npm start
```

### Docker Usage

Start the container:
```bash
docker start mcp-server
```

Stop the container:
```bash
docker stop mcp-server
```

View logs:
```bash
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

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

Clone the repository:

git clone <repository-url>
cd mcp-server

Install dependencies:
```
npm install
```
Create environment file:
```
cp .env.example .env
```
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

Clone the repository:

git clone <repository-url>
cd mcp-server

Create and configure environment file:

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

Build the Docker image:
```
docker build -t mcp-server .
```

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