読み込み中

MCPクライアントとサーバーはJSONメッセージを交換することで通信しますが、これらのメッセージは実際にはどのように伝送されるのでしょうか。使用される通信チャネルはトランスポートと呼ばれ、これを実装する方法はいくつもあります。HTTPリクエストからWebSocket、さらにはJSONを葉書に書くという方法まで(ただし最後の方法は本番環境での使用にはお勧めしません)。

Stdioトランスポート

MCPサーバーやクライアントを最初に開発する際、最もよく使われるトランスポートはstdioトランスポートです。このアプローチは単純明快で、クライアントがMCPサーバーをサブプロセスとして起動し、標準入力と標準出力のストリームを通じて通信します。

stdioトランスポートの図: MCPクライアントはサーバーのstdinを通じてメッセージをMCPサーバーに送信し、サーバーはstdoutを通じてメッセージを送り返す。どちらの側もいつでもメッセージを送信でき、両者が同じマシン上で動作している場合にのみ機能する

仕組みは次のとおりです。

  • クライアントはサーバーのstdinを使ってサーバーにメッセージを送信します
  • サーバーはstdoutに書き込むことで応答します
  • サーバーまたはクライアントのどちらも、いつでもメッセージを送信できます
  • クライアントとサーバーが同じマシン上で動作している場合にのみ機能します

Stdioの動作を見てみる

実は、別途クライアントを書かなくても、ターミナルから直接MCPサーバーをテストできます。uv run server.pyでサーバーを実行すると、サーバーはstdinを待ち受け、stdoutに応答を書き込みます。つまり、JSONメッセージをターミナルに直接貼り付けて、サーバーの応答をすぐに確認できるということです。

ターミナルの出力には、初期化やツール呼び出しの例を含む、メッセージ交換の全体が表示されます。

MCP接続シーケンス

すべてのMCP接続は、特定の3つのメッセージから成るハンドシェイクで開始する必要があります。

MCPハンドシェイクのシーケンス図: クライアントがサーバーにInitialize Requestを送信し、サーバーはInitialize Resultで応答し、その後クライアントはInitialized Notificationを送信するが、これに対する応答は返ってこない

  1. Initialize Request - クライアントが最初に送信します
  2. Initialize Result - サーバーが機能(capabilities)を返して応答します
  3. Initialized Notification - クライアントが確認を送ります(応答は期待されません)

このハンドシェイクが完了した後にのみ、ツール呼び出しやプロンプト一覧取得などの他のリクエストを送信できます。

メッセージの種類とフロー

MCPは、双方向に流れるさまざまな種類のメッセージをサポートしています。

クライアントとサーバー間のMCPメッセージ種類の図: Call Tool Request → Call Tool Resultのようなクライアント起点のリクエスト/結果のペア、Create Message RequestやList Roots Requestのようなサーバー起点のペア、さらに応答を必要としない各側からの一方向の通知

重要なポイントは、一部のメッセージは応答を必要とする(リクエスト→結果)一方で、そうでないもの(通知)もあるということです。クライアントとサーバーのどちらも、いつでも通信を開始できます。

4つの通信シナリオ

どのトランスポートを使う場合でも、4つの異なる通信パターンを処理する必要があります。

「これらをstdioでどう実装できるか?」というタイトルの図: クライアントからサーバーへの最初のリクエスト、サーバーからクライアントへの応答、サーバーからクライアントへの最初のリクエスト、クライアントからサーバーへの応答という4つのパターンが、stdinとstdoutを持つMCPサーバーに接続されたMCPクライアントの隣に列挙されている

  • クライアント → サーバー リクエスト: クライアントがstdinに書き込みます
  • サーバー → クライアント 応答: サーバーがstdoutに書き込みます
  • サーバー → クライアント リクエスト: サーバーがstdoutに書き込みます
  • クライアント → サーバー 応答: クライアントがstdinに書き込みます

stdioトランスポートの美しさは、そのシンプルさにあります。どちらの側も、この2つのチャネルを使っていつでも通信を開始できます。

なぜこれが重要なのか

stdioトランスポートを理解することは非常に重要です。なぜなら、これは双方向通信がシームレスに行われる「理想的な」ケースを表しているからです。HTTPのような他のトランスポートに移行すると、サーバーが常にクライアントへリクエストを開始できるとは限らないという制約に直面することになります。stdioトランスポートは、他のトランスポート方式の制約に取り組む前に、完全なMCP通信がどのようなものかを理解するための基準となります。

開発やテストには、stdioトランスポートが最適です。クライアントとサーバーを異なるマシン上で動作させる必要がある本番環境のデプロイでは、それぞれにトレードオフのある他のトランスポートオプションを検討する必要があります。