読み込み中

StreamableHTTPは、MCPが抱える根本的な問題に対する解決策です。一部のMCP機能はサーバーがクライアントにリクエストを送る必要がありますが、HTTPではこれが困難です。StreamableHTTPがこの制約をどのように回避しているか、そしてその回避策を破る必要がある場合について見ていきましょう。

核心となる問題

サンプリング、通知、ロギングといった一部のMCP機能は、サーバーがクライアントに対してリクエストを開始することに依存しています。しかし、HTTPはクライアントがサーバーにリクエストを送るように設計されており、その逆ではありません。StreamableHTTPは、Server-Sent Events(SSE)を使った巧妙な回避策でこれを解決しています。

StreamableHTTPの仕組み

その仕組みは、クライアントとサーバー間に永続的な接続を確立する複数ステップのプロセスによって実現されています。

以下に挙げる3つの初期化メッセージ。Initialized Notificationはセッションidを運び、結果は返ってこない。

初期接続のセットアップ

このプロセスは、通常のMCP接続と同じように始まります。

  • クライアントがサーバーにInitialize Requestを送信する
  • サーバーが特別なmcp-session-idヘッダーを含むInitialize Resultで応答する
  • クライアントがセッションIDを含むInitialized Notificationを送信する

このセッションIDは極めて重要です。クライアントを一意に識別するものであり、以降のすべてのリクエストに含める必要があります。

SSEによる回避策

初期化後、クライアントはGETリクエストを送信してServer-Sent Events接続を確立できます。これにより、サーバーがいつでもクライアントにメッセージをストリーミングできる、長時間持続するHTTPレスポンスが作成されます。

mcp-session-idヘッダー付きのGET mcp-server.com/mcp/に対し、任意の長さで開いたままにできるSSEレスポンスが返される。

このSSE接続こそが、サーバーからクライアントへの通信を可能にする鍵です。サーバーはこの永続的なチャネルを通じて、リクエスト、通知、その他のメッセージを送信できるようになります。

ツール呼び出しと二重のSSE接続

クライアントがツール呼び出しを行うと、状況はより複雑になります。システムは2つの別々のSSE接続を作成します。

MCPサーバーからの2つのSSEレスポンスの間で、クライアントはmcp-session-idヘッダー付きのCall Tool Request POSTを送信する。

  • プライマリSSE接続: サーバー起点のリクエストに使用され、無期限に開いたままになる
  • ツール専用SSE接続: ツール呼び出しごとに作成され、ツールの結果が送信されると自動的に閉じる

メッセージのルーティング

メッセージの種類によって、異なる接続を通じてルーティングされます。

  • 進捗通知: プライマリSSE接続を通じて送信される
  • ロギングメッセージとツールの結果: ツール専用SSE接続を通じて送信される

mcp-session-idヘッダー付きでmcp-server.com/mcp/へのCall Tool Request POST。SSEレスポンスは任意の長さで開いたままにできる。

回避策を破る設定フラグ

StreamableHTTPには、2つの重要な設定オプションがあります。

  • stateless_http
  • json_response

これらをTrueに設定すると、SSEによる回避策の仕組みが壊れる可能性があります。特定のシナリオではこれらのフラグを有効にしたい場合もありますが、そうすることで、サーバーからクライアントへの通信に依存する完全なMCP機能が制限されます。

重要なポイント

StreamableHTTPは、HTTPの制約を回避する必要があるため、他のMCPトランスポートよりも複雑です。SSEベースの回避策によってHTTP上で完全なMCP機能が実現されますが、デバッグと最適化のためには、この二重接続モデルを理解することが不可欠です。

StreamableHTTPを使ってMCPアプリケーションを構築する際は、初期化後のすべてのリクエストにセッションIDが必要であること、そしてシステムが異なる種類のサーバーからクライアントへの通信を処理するために複数のSSE接続を自動的に管理していることを覚えておいてください。