Pikimon MCP Server

🚀 MCP 服务器

这是一个借助 Node.js 构建的服务器，主要用于与 Monad 测试网区块链网络进行交互。该服务器提供了 REST API 接口，可用于执行常见的区块链操作，为区块链开发和应用提供了便利。

🚀 快速开始

MCP 服务器是一个与 Monad 测试网区块链网络交互的工具。你可以通过克隆仓库、安装依赖项并配置环境变量来启动服务器。若使用 Docker，还能更便捷地部署和管理。

✨ 主要特性

• 基于 Express.js 的 REST API，提供简洁高效的接口服务。
• 集成 Web3.js 进行区块链交互，方便实现区块链操作。
• 支持环境变量配置，灵活调整服务器参数。
• 支持基本的区块链操作，如获取余额、发送交易等。
• 配备安全中间件（helmet、cors），保障服务器安全。
• 提供 Swagger API 文档，便于开发者理解和使用接口。
• 支持 Docker，方便部署和管理。

📦 安装指南

标准安装

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 许可证。