Pikimon MCP Server

🚀 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 からアクセスできます。アクセス URL は次の通りです：

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