MCP 服务器

这是一个使用 Node.js 构建的与Monad 测试网区块链网络交互的服务器。该服务器提供了一个 REST API 接口，用于常见的区块链操作。

特性

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

先决条件

• Node.js (v16 或更高版本) 或 Docker
• 如果不使用 Docker，则需要 npm (v8 或更高版本)
• 获取Monad 测试网节点的访问权限

安装

标准安装

1. 克隆仓库：

   git clone <repository-url>
   cd mcp-server
   

2. 安装依赖项：

   npm install
   

3. 创建环境文件：

   cp .env.example .env
   

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

   • 将 MONAD_RPC_URL 设置为您的Monad 测试网节点 URL
   • 如果需要更改端口，请设置 PORT
   • 添加 PRIVATE_KEY 以便签名交易

Docker 安装

1. 克隆仓库：

   git clone <repository-url>
   cd mcp-server
   

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

   cp .env.example .env
   # 编辑 `.env` 以进行配置
   

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 文档可以在 /api-docs 访问，服务器运行时。访问地址：

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 - 并行分析多个块

环境变量

Docker 卷

容器使用以下卷：

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

许可证

ISC