読み込み中

MCPサーバーにおけるstateless_httpとjson_responseのフラグは、サーバーの動作の根本的な側面を制御します。特にサーバーのスケーリングや本番環境へのデプロイを計画している場合、これらをいつ、なぜ使用するのかを理解することが重要です。

ステートレスHTTPが必要になる場合

人気が出るMCPサーバーを構築したとします。最初は、単一のサーバーインスタンスに接続するクライアントがほんの数個かもしれません。

3つのMCPクライアント。1つは「あなた」、2つは「他の誰か」とラベル付けされており、すべてリモートマシン上の1つのMCPサーバーに接続している。

サーバーが成長するにつれて、数千のクライアントが接続しようとするかもしれません。単一のサーバーインスタンスを実行するだけでは、そのすべてのトラフィックを処理するスケールには対応できません。

3つのMCPクライアント(あなたと他の2人)に加えて、99999人の他の人々が、すべてリモートマシン上の1つのMCPサーバーに接続している。

典型的な解決策は水平スケーリング、つまりロードバランサーの背後で複数のサーバーインスタンスを実行することです。

3つのMCPクライアント(あなたと他の2人)が、すべて1つのロードバランサーを経由し、それが3つのMCPサーバーに振り分ける。

しかし、ここで事態が複雑になります。MCPクライアントには2つの別々の接続が必要であることを思い出してください。

  • サーバーからクライアントへのリクエストを受信するためのGET SSE接続
  • ツールを呼び出し、レスポンスを受け取るためのPOSTリクエスト

2つのMCPサーバーのうち1つから、MCPクライアントへ向かう「GET SSE Response」の矢印。両者の間にロードバランサーがある。

ロードバランサーを使用すると、これらのリクエストは異なるサーバーインスタンスにルーティングされる可能性があります。ツールが(サンプリングを通じて)Claudeを使用する必要がある場合、POSTリクエストを処理するサーバーは、GET SSE接続を処理するサーバーと調整する必要があります。これにより、サーバー間で複雑な調整の問題が生じます。

1つのMCPクライアント、2つのサーバー:一方からのGET SSE Response、Create Message RequestとCall Tool Resultを伴うPOST SSE Response。

ステートレスHTTPがこれをどう解決するか

stateless_http=Trueを設定すると、この調整の問題は解消されますが、大きなトレードオフが伴います。

FastMCPコンストラクタにstateless_http=Trueとjson_response=Trueの引数があり、それぞれ下記のトレードオフに結び付けられている。

ステートレスHTTPが有効な場合:

  • クライアントはセッションIDを取得しません - サーバーは個々のクライアントを追跡できません
  • サーバーからクライアントへのリクエストがありません - GET SSEの経路が利用できなくなります
  • サンプリングがありません - Claudeや他のAIモデルを使用できません
  • 進捗レポートがありません - 長時間の処理中に進捗更新を送信できません
  • サブスクリプションがありません - リソースの更新についてクライアントに通知できません

ただし、1つの利点があります。クライアントの初期化が不要になります。クライアントは最初のハンドシェイクプロセスなしで、直接リクエストを行うことができます。

MCPクライアントからサーバーへの実線のPOST SSE Response矢印と、戻り方向の破線のグレーのGET SSE Response矢印を示す図。

JSONレスポンスを理解する

json_response=Trueフラグはよりシンプルです - POSTリクエストのレスポンスに対するストリーミングを単に無効にするだけです。ツールが実行される際に複数のSSEメッセージを受け取る代わりに、最終結果のみをプレーンなJSONとして受け取ります。

ストリーミングが無効な場合:

  • 中間の進捗メッセージはありません
  • 実行中のログ文はありません
  • 最終的なツール結果のみです

これらのフラグをいつ使用するか

次の場合にステートレスHTTPを使用します:

  • ロードバランサーによる水平スケーリングが必要な場合
  • サーバーからクライアントへの通信が不要な場合
  • ツールがAIモデルのサンプリングを必要としない場合
  • 接続のオーバーヘッドを最小限に抑えたい場合

次の場合にJSONレスポンスを使用します:

  • ストリーミングレスポンスが不要な場合
  • よりシンプルな非ストリーミングのHTTPレスポンスを好む場合
  • プレーンなJSONを期待するシステムと統合する場合

開発環境と本番環境

標準入出力トランスポートでローカル開発を行いつつ、HTTPトランスポートでのデプロイを計画している場合は、本番環境で使用するのと同じトランスポートでテストしてください。ステートフルモードとステートレスモードの間の動作の違いは大きくなる可能性があり、デプロイ後ではなく開発中に問題を発見しておく方が良いでしょう。

これらのフラグはMCPサーバーの動作方法を根本的に変えるため、特定のスケーリングと機能の要件に基づいて選択してください。