はじめに
MCP Listener は、モデル コンテキスト プロトコル (MCP) クライアント初期化リクエストを自動的に処理し、仮想アセットが Server-Sent Events (SSE) を使用した HTTP またはストリーミング可能な HTTP 経由で送信された MCP メッセージを受信して応答できるようにします。
前提条件
- MCP クライアントは、レガシー リクエストの場合は少なくともプロトコル バージョン 2024-11-05 を、ストリーミング可能な HTTP リクエストの場合は少なくとも 2025-03-26 をサポートし、トランスポート タイプ構成に基づいて次のいずれかのトランスポート メカニズムを使用して通信する必要があります。
- Stateful/Stateless: ストリーミング可能な HTTP トランスポート (少なくとも2025年3月26日)
- SSE: Server-Sent Events (SSE) トランスポートを使用した HTTP (少なくとも 2024-11-05)
- このツールを使用するには、SOAtest/Virtualize 2024.1 以降が必要です。SOAtest/Virtualize は、Java 17 以降で実行するように構成する必要があります。
インストール手順
このツールは UI またはコマンドラインからインストールできます。
UI からのインストール
- [Parasoft ] > [設定] を選択し、[システム プロパティ] をクリックします。
- [JAR の追加] をクリックし、com.parasoft.virtualize.listener.mcp-<version>.jar ファイルを選択します。
- [適用] をクリックします。
- SOAtest/Virtualize を再起動します。
コマンドラインからのインストール
設定プロパティ ファイルの system.properties.classpath プロパティに com.parasoft.virtualize.listener.mcp-<version>.jar ファイルを追加します。例:
system.properties.classpath=<PATH_TO_JAR>/com.parasoft.virtualize.listener.mcp-<version>.jar
使用方法
MCP listener をインストールすると、仮想アセット設定パネルの [トランスポート] > [カスタム] で MCP Listener を利用できるようになります。仮想アセットの Virtualize Server ノードをダブルクリックすると、このパネルが開きます。
複数のカスタム リスナーがある場合、[実装の選択] メニューで使用するリスナーを選択できます。
設定
以下のオプションを設定できます。
接続の設定
| Port | リスナーのポートを指定します。値は 1 から 65535 でなければなりません。空の場合、リスナーは開始されません。 |
|---|---|
| Endpoint | MCP サーバーのエンドポイント パスを指定します。デフォルトは /mcp です。 |
| Transport Type | クライアントとサーバー間の通信のトランスポート メカニズムを指定します。以下のトランスポート タイプが利用可能です。
デフォルトは stateful です。 |
| Worker Threads | メッセージの処理に使用するワーカー スレッドの数を指定します。 有効な最小値は デフォルトは |
| Heartbeat Interval | クライアントの応答を必要とする MCP クライアントへの ping 要求の送信間隔を秒単位で指定します。ハートビート間隔は、接続のタイムアウトを防ぐために使用されます。ハートビート メカニズムを無効にする場合は 許容される最小間隔は デフォルトは |
Logging 設定
Log Level | コンソールと[モニターの開始] ビューに表示する情報の量を指定します。以下のレベルを指定できます。
デフォルトは |
|---|
メッセージ レスポンダーの設定
MCP リスナーは、対応するレスポンダーで設定された任意のレスポンスを返しますが、標準的な MCP 通信のためには、レスポンスを JSON-RPC 2.0 仕様に従ってフォーマットすることを推奨します。
レスポンスに id フィールドが含まれている場合、それは無視され、代わりに元のリクエストの id が使用されることに注意してください。また、レスポンスに jsonrpc フィールドが存在しない場合は、値 2.0 で自動的に追加されます。
変更ログ
1.2
- ストリーミング可能な HTTP トランスポートのサポートが追加されました。
1.1
- ハートビート メカニズムを更新し、ハートビートを無効にする機能を追加しました。
1.0
- 初回リリース。
サード パーティのコンテンツ
この拡張機能は、以下のサード パーティのコンテンツを含みます。
- jackson-annotations (Apache License 2.0 この notice と共に)
- jackson-core (Apache License 2.0 この notice と共に)
- jackson-databind (Apache License 2.0 この notice と共に)
- MCP Java SDK (MIT License)
- Byte Buddy (Apache License 2.0 この notice と共に)
- SLF4J (MIT License)
- jackson-dataformat-yaml (Apache License 2.0 この notice と共に)
- SnakeYAML (Apache License 2.0)
- JsonSchemaValidator (Apache License 2.0 この notice と共に)
- Internet Time Utility (Apache License 2.0)
- Reactor Core (Apache License 2.0)
- Reactive Streams (MIT No Attribution)
その他のライセンスの詳細については、拡張機能の licenses フォルダーを参照してください。
