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 許可證。