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 ドキュメントを確認できます。次の 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 - 複数のブロックを分析します

環境変数

変数	説明	デフォルト
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