MCP Server

MCP 服务

一个用于与 Monad Testnet 区块链网络交互的 Node.js 服务。此服务为常见的区块链操作提供 REST API 接口。

功能

• Express.js REST API
• 集成 Web3.js 以进行区块链交互
• 环境变量配置
• 基本区块链操作（获取余额、发送交易等）
• 安全中间件（helmet、cors）
• Swagger API 文档
• 支持 Docker

前提条件

• Node.js（v16 或更高版本）或 Docker
• 如果不使用 Docker，则需要 npm（v8 或更高版本）
• 可访问 Monad Testnet 节点

安装

标准安装

1. 克隆代码库：

   git clone <repository-url>
   cd mcp-server
   

2. 安装依赖：

   npm install
   

3. 创建环境文件：

   cp .env.example .env
   

4. 在 .env 中配置环境变量：

   • 将 MONAD_RPC_URL 设置为 Monad Testnet 节点 URL
   • 如果要使用其他端口，请设置 PORT
   • 如果需要签署交易，请添加 PRIVATE_KEY

Docker 安装

1. 克隆代码库：

   git clone <repository-url>
   cd mcp-server
   

2. 创建并配置环境文件：

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

3. 构建 Docker 镜像：

   docker build -t mcp-server .
   

4. 运行容器：

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

使用方法

标准用法

启动开发服务：

npm run dev

启动生产服务：

npm start

Docker 用法

启动容器：

docker start mcp-server

停止容器：

docker stop mcp-server

查看日志：

docker logs mcp-server

API 文档

服务运行时，可通过 /api-docs 查看 API 文档。访问：

http://localhost:3000/api-docs

API 端点

• GET /health - 检查服务健康状态
• GET /blockchain/latest-block - 获取当前区块编号
• GET /blockchain/analyze-block/:blockNumber - 获取区块分析结果
• POST /blockchain/store-data - 在合约中存储数据
• GET /blockchain/get-data - 获取已存储的数据
• POST /actions/execute-chain - 执行一系列操作
• GET /actions/parallel-block-analysis - 分析多个区块

环境变量

变量	描述	默认值
PORT	服务端口	3000
NODE_ENV	环境模式	development
MONAD_RPC_URL	Monad Testnet RPC URL	http://localhost:8545
CONTRACT_ADDRESS	智能合约地址	-
CONTRACT_ABI	智能合约 ABI	-
LOG_LEVEL	日志级别	info

Docker 卷

容器使用以下卷：

• /app/logs：包含应用日志（combined.log 和 error.log）

许可证

ISC