0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

MCPサーバーに関して②:通信の仕組み

0
Posted at

MCPサーバーに関して②:通信の仕組み

MCPのクライアントとサーバーは、どんな「言葉」で会話しているのでしょうか。第2回は、メッセージの形と接続の流れ、そして2種類の「運び方(トランスポート)」を解説します。

この記事で分かること

  • MCPのメッセージの形(JSON-RPC 2.0)
  • 接続の3段階の流れ
  • 2つのトランスポートの違いと選び方

メッセージの形:JSON-RPC 2.0

MCPのやり取りはすべて JSON-RPC 2.0 という形式のJSONで行われます。トランスポートが何であれ中身の形は同じで、メッセージは3種類だけです。

種類 意味 返信
リクエスト 相手に何かを求める(id付き) 必要
通知(notification) 知らせるだけ(idなし) 不要
レスポンス リクエストへの返事(resultかerror) —

たとえば、ツール一覧を聞くリクエストはこうなります。

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {}
}

サーバーは同じidを付けて返します。

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      { "name": "read_file", "description": "ファイルを読む" }
    ]
  }
}

失敗した場合はresultの代わりにerrorが入り、存在しないメソッドを呼ぶとエラーコード-32601(Method not found)が返ります。メッセージはすべてUTF-8で、MCPでは1つずつ送ります(JSON-RPC 2.0の「バッチ送信」は使いません)。方向も決まっていて、ふつうはクライアントがリクエストを送り、サーバーがレスポンスを返す流れです。サーバーからクライアントへは、返事のいらない通知(進捗やログなど)を送ることができます。

接続の流れ:ライフサイクル

クライアントとサーバーの接続は、必ず次の3段階をたどります。

① 初期化:バージョンと能力の交渉

接続の最初に行うのが初期化です。クライアントがinitializeリクエストで自分の対応バージョン・能力・実装情報を伝え、サーバーが自分の能力と情報を返して使うバージョンを決めます。

バージョン交渉のルールはシンプルです。クライアントは対応する最新のバージョンを送り、サーバーが対応していれば同じバージョンを、対応していなければ対応する別のバージョンを返します。クライアントがそのバージョンに対応していなければ切断します。

次に能力(capabilities)の交渉です。お互いが「何ができるか」を申告し、合意した機能だけを使います。主な能力は次のとおりです。

側 能力 意味
クライアント roots ファイルシステムのルート(作業対象の場所)を提示できる
クライアント sampling LLMへの問い合わせ(サンプリング)を受けられる
サーバー tools 呼び出せるツールを提供する
サーバー resources 読み取れるリソースを提供する
サーバー prompts プロンプトテンプレートを提供する
サーバー logging 構造化ログを送る

初期化が終わったら、クライアントはinitialized通知を送り、ようやく通常の運用が始まります。初期化が終わる前に送っていいのはping(生存確認)などごく一部だけです。

② 運用:合意した範囲でやり取り

運用フェーズでは、合意したバージョンと能力の範囲内でのみやり取りします。実装はすべてのリクエストにタイムアウトを設けるべきとされています。返事が来ないまま待ち続けると接続が詰まるからです。タイムアウトしたら取り消しの通知(notifications/cancelled)を送ります。

③ 終了:専用のメッセージはない

終了に専用のメッセージはなく、トランスポート側の仕組みで切断します。stdioならクライアントがサーバーへの入力を閉じて終了を待ち、HTTPならHTTP接続を閉じます。

運び方:2つのトランスポート

メッセージの中身が同じなら、次は「どう運ぶか」です。MCPの標準トランスポートは2つです。

stdio Streamable HTTP
仕組み クライアントがサーバーを子プロセスとして起動し、標準入出力で通信 HTTPのPOSTで1メッセージずつ送る。サーバーは独立したプロセス
向いている場面 ローカルで動くサーバー リモート(ネットワーク越し)のサーバー
複数のクライアント 1対1(起動したクライアント専用) 複数のクライアントを同時に受けられる
公式の推奨 クライアントは可能な限り対応すべき リモート化するときの標準

stdio:子プロセスとして起動する

クライアントがサーバーを子プロセスとして起動します。サーバーは標準入力(stdin)からメッセージを読み、標準出力(stdout)へ書きます。メッセージは1行が1つのJSONで、改行で区切られます。

決まりは厳格です。サーバーはstdoutにMCPメッセージ以外を一切書いてはいけません(ログはstderrへ)。stdoutは「会話専用の回線」で、余計な出力があると会話が壊れます。ローカル開発ではいちばん手軽です。

Streamable HTTP:HTTPのPOSTで運ぶ

サーバーは独立したプロセスとして動き、1つのMCPエンドポイント(例:https://example.com/mcp)を用意します。クライアントはメッセージごとに新しいHTTP POSTを投げます。

サーバーの返し方は2通りです。1つのJSONオブジェクトで返すか、SSE(Server-Sent Events)のストリームで返すかです。SSEなら進捗の通知を挟みながら最後にレスポンスを返せます。通知だけならHTTP 202 Acceptedを空のボディで返します。

HTTPならではの仕組みもあります。

  • セッション管理:サーバーは初期化時にMcp-Session-IdヘッダーでセッションIDを発行でき、クライアントは以降のリクエストに付けます。明示的に終えるときはHTTP DELETEを使います
  • バージョンのヘッダー:クライアントはすべてのリクエストにMCP-Protocol-Versionヘッダーを付けます
  • サーバーからの連絡:クライアントはHTTP GETで、サーバーからの通知を受け取るSSEストリームを開けます
  • セキュリティ:サーバーはOriginヘッダーを検証してDNSリバインディング攻撃を防ぎ、ローカルでは127.0.0.1だけにバインドすることが求められています

なお、初期のMCPにあった「HTTP+SSE」トランスポートは廃止予定となり、現在の標準はこのStreamable HTTPです。

どちらを選ぶか

選び方の目安はシンプルです。自分のPCだけで使うならstdio、複数の人やアプリから使わせたい、サーバーを常駐させたいならStreamable HTTPです。中身のルールは同じなので、ローカルで作ったサーバーをあとからリモート化しても会話のルールは変わりません。第8回でこのリモート化とデプロイを詳しく解説します。

まとめ

  • MCPのメッセージはJSON-RPC 2.0形式で、リクエスト・通知・レスポンスの3種類
  • 接続は「初期化(バージョンと能力の交渉)→ 運用 → 終了」の3段階
  • 初期化が終わるまではpingなど一部を除いてやり取りできない
  • トランスポートはstdioとStreamable HTTPの2つで、中身のルールは変わらないため移行がしやすい

関連記事

参考リンク

用語集

  • JSON-RPC 2.0:JSONで遠隔の手続きを呼び出すための軽量な仕様。メソッド名・引数・IDを含むJSONを送り、結果またはエラーをJSONで受け取る
  • リクエスト:相手に処理を求めるメッセージ。idが付き、必ずレスポンスが返る
  • 通知(notification):返事を期待しない一方通行のメッセージ。idがない
  • レスポンス:リクエストへの返事。成功ならresult、失敗ならerrorを含む
  • 初期化(initialize):接続開始時にバージョンと能力を交渉する手順
  • 能力(capabilities):クライアントやサーバーが対応している機能の申告。交渉で合意したものだけ使える
  • ライフサイクル:接続の始まりから終わりまでの一連の段階(初期化 → 運用 → 終了)
  • トランスポート:メッセージを運ぶための通信手段。MCPではstdioとStreamable HTTPが標準
  • stdio:標準入出力。プログラムが使う入出力の通り道で、MCPでは子プロセスとの会話に使う
  • 子プロセス:あるプログラムが起動した、別のプログラムの実行単位
  • Streamable HTTP:HTTPのPOSTでメッセージを送り、応答をJSONかSSEストリームで返すMCPのトランスポート
  • SSE(Server-Sent Events):サーバーからクライアントへ、HTTP接続を開いたままイベントを少しずつ送る仕組み
  • セッション:初期化から始まる、クライアントとサーバーの一連のやり取りのまとまり。セッションIDで区別する
  • DNSリバインディング攻撃:攻撃者のドメインを経由して、ブラウザにローカルのサーバーへアクセスさせる攻撃手法
  • ping:相手が生きているか確認するための小さなリクエスト
0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?