読み込み中

MCP(Model Context Protocol)は、クライアントとサーバー間の通信を処理するためにJSONメッセージを使用します。これらのメッセージタイプを理解することは、MCPを扱う上で、特にstreamable HTTPトランスポートのような異なるトランスポート方式を扱う際に非常に重要です。

メッセージフォーマット

すべてのMCP通信はJSONメッセージを通じて行われます。各メッセージタイプは特定の目的を果たします。それがツールの呼び出しであれ、利用可能なリソースの一覧表示であれ、システムイベントに関する通知の送信であれ、それぞれに役割があります。

典型的な例を挙げましょう。Claudeが MCPサーバーによって提供されるツールを呼び出す必要がある場合、クライアントは「Call Tool Request」メッセージを送信します。サーバーはこのリクエストを処理し、ツールを実行し、出力を含む「Call Tool Result」メッセージで応答します。

MCP仕様

メッセージタイプの完全なリストは、GitHub上の公式MCP仕様リポジトリで定義されています。この仕様は、さまざまなSDKリポジトリ(PythonやTypeScriptのSDKなど)とは別のものであり、MCPがどのように動作すべきかについての権威ある情報源として機能します。

メッセージタイプは便宜上TypeScriptで記述されています。これはTypeScriptコードとして実行されるからではなく、TypeScriptがデータ構造と型を記述する明確な方法を提供するためです。

メッセージカテゴリ

MCPメッセージは2つの主要なカテゴリに分類されます。

リクエスト-結果メッセージ

これらのメッセージは常にペアで送られます。リクエストを送信し、結果が返ってくることを期待します。

  • Call Tool Request → Call Tool Result
  • List Prompts Request → List Prompts Result
  • Read Resource Request → Read Resource Result
  • Initialize Request → Initialize Result

通知メッセージ

これらは一方向のメッセージであり、イベントについて通知しますが、応答を必要としません。

  • Progress Notification - 長時間実行される操作に関する更新
  • Logging Message Notification - システムログメッセージ
  • Tool List Changed Notification - 利用可能なツールが変更された場合
  • Resource Updated Notification - リソースが変更された場合

クライアントメッセージとサーバーメッセージ

MCP仕様では、メッセージを送信する側によってメッセージを整理しています。

クライアントメッセージには、クライアントがサーバーに送信するリクエスト(ツール呼び出しなど)と、クライアントが送信する可能性のある通知が含まれます。

サーバーメッセージには、サーバーがクライアントに送信するリクエストと、サーバーがブロードキャストする通知が含まれます。

なぜこれが重要なのか

サーバーがクライアントにメッセージを送信できることを理解することは、異なるトランスポート方式を扱う際に特に重要です。streamable HTTPトランスポートのような一部のトランスポートには、どの方向にどのタイプのメッセージが流れることができるかについて制限があります。

重要な点は、MCPが双方向プロトコルとして設計されているということです。クライアントとサーバーの両方が通信を開始できます。これは、特定の使用事例に適したトランスポート方式を選択する必要がある際に非常に重要になります。