MCP Stateful Example

MCP Stateful Example

Model Context Protocol (MCP) を使用した、セッションベースのツール呼び出しワークフローを調査・検証するための、最小限で完全に MCP に準拠したサーバーとクライアントの構成です。

特徴

• ステートフル MCP サーバーのサンプル：セッション処理を実装した最小限の MCP サーバーです
• テスト用ツール：セッション状態をテストするための imagine ツールと isLessThan ツールが含まれています
• 統合テスト：サーバーの動作とセッションの永続性を検証する Python ベースのテストです
• ヘルスチェック：サーバーの状態を監視するための /health エンドポイントが組み込まれています

前提条件

• Node.js 18+
• Python 3.8+（統合テスト用）
• npm または yarn

はじめに

1. リポジトリをクローンします
2. Node.js の依存関係をインストールします：

   npm install
   

3. 統合テスト用の Python の依存関係をインストールします：

   pip install -r test/integration/requirements.txt
   

4. プロジェクトのルートに、以下の内容で .env.test ファイルを作成します：

   PORT=3088
   

5. 開発サーバーを起動します：

   npm run dev
   

テストの実行

ユニットテスト

npm test

統合テスト

# Run all integration tests
npm run itest

# Or run a specific test
cd test/integration
python test_initialize.py

プロジェクト構成

• src/ - ソースコード
  • server/ - MCP サーバーの実装
    • tools/ - ツールの定義
  • client/ - テスト用クライアントの実装
• test/ - テストファイル
  • integration/ - Python ベースの統合テスト
• scripts/ - ビルドおよびユーティリティ用スクリプト

利用可能なツール

imagine

指定された下限と上限の間からランダムな数値を選び、セッションに保存します。

パラメーター：

• lower：下限（この値を含みます）
• upper：上限（この値を含みます）

isLessThan

現在のセッションで以前に生成した数値より、指定した数値が小さいかどうかを確認します。

パラメーター：

• number：生成した数値と比較する数値

API エンドポイント

GET /health

サーバーの状態を返すヘルスチェックエンドポイントです。

POST /mcp

MCP に準拠したリクエストを処理するための、メインの MCP プロトコルエンドポイントです。

環境変数

• PORT：サーバーがリッスンするポート番号（デフォルト：3000）
• NODE_ENV：環境モード（例：'development'、'production'）

ライセンス

ISC