Supergateway Zi4

🚀 SuperGateway 紹介

このツールは、標準入出力（stdio）をサーバー送信イベント（SSE）に変換するゲートウェイです。stdio ベースの MCP（モデルコンテキストプロトコル）サーバーを実行し、SSE を通じてリモートアクセスできるようにします。

✨ 主な機能

• stdio ベースの MCP サーバーを SSE サービスに変換します。
• 複数のクライアントが同時に接続できます。
• JSON 形式の出力を自動的に識別して転送します。
• クロスオリジンリクエスト（CORS）をサポートします。
• ヘルスチェックエンドポイントをサポートします。
• ログレベルを設定できます。

📦 インストール

システム要件

• Java 17 以上
• Maven 3.6 以上

ビルドと実行

1. プロジェクトをビルドします。

cd src/java
mvn clean package

2. アプリケーションを実行します。

java -jar target/supergateway-1.0.0.jar [オプション]

コマンドラインオプション

• --version: バージョン番号を表示します。
• --stdio: 実行する MCP サーバーコマンド
• --sse: SSE URL 接続アドレス
• --port: (stdio→SSE) サーバーのリスニングポート [デフォルト: 8000]
• --baseUrl: (stdio→SSE) SSE クライアントのベース URL
• --ssePath: (stdio→SSE) SSE サブスクリプションパス [デフォルト: "/sse"]
• --messagePath: (stdio→SSE) SSE メッセージパス [デフォルト: "/message"]
• --logLevel: ログレベルを設定します: "info" または "none" [デフォルト: "info"]
• --cors: CORS を有効にします [デフォルト: false]
• --healthEndpoint: ヘルスチェックエンドポイントを追加します。複数のエンドポイントはカンマで区切ります。
• --help: ヘルプ情報を表示します。

💻 使用例

java -jar target/supergateway-1.0.0.jar \
  --stdio "java -jar your-mcp-server.jar" \
  --port 8000 \
  --baseUrl http://localhost:8000 \
  --ssePath /sse \
  --messagePath /message

📚 ドキュメント

API インターフェース

1. SSE 接続

• URL: GET /sse
• 説明: プロセスの出力を受信するための SSE 接続を確立します。
• 応答: サーバーはメッセージ送信エンドポイントを含む SSE イベントを返します。

2. メッセージ送信

• URL: POST /message?sessionId=<session_id>
• Content-Type: application/json
• 説明: プロセスに JSON 形式のメッセージを送信します。
• 応答:
  • 200: メッセージの送信に成功しました。
  • 400: 無効な JSON メッセージです。
  • 503: セッションが存在しないか、プロセスが準備できていません。

3. ヘルスチェック

• URL: GET /health (ヘルスチェックエンドポイントが設定されている場合)
• 説明: サービスが正常に動作しているかを確認します。
• 応答: "ok" を返します。

⚠️ 重要提示

• プロセスの出力は JSON 形式でなければ SSE クライアントに転送されません。
• 各 SSE クライアントには自動的に一意の sessionId が割り当てられます。
• すべてのメッセージは有効な JSON 形式でなければなりません。
• メッセージを送信する際には、SSE 接続から取得した正しい sessionId を使用する必要があります。
• MCP サーバーは標準入出力を通じた通信をサポートしている必要があります。