MCP の仕様 (3) - 基本プロトコル - 概要

以下の記事が面白かったので、簡単にまとめました。

前回

1. 基本プロトコルの概要

「MCP」は、連携して動作する複数の主要コンポーネントで構成されています。

すべての実装は、基本プロトコルとライフサイクル管理コンポーネントをサポートする必要があります。その他のコンポーネントは、アプリケーションの特定のニーズに基づいて実装できます。

これらのプロトコル層は、クライアントとサーバ間の高度なインタラクションを可能にしながら、明確な関心事の分離を確立します。モジュール設計により、実装は必要な機能だけをサポートできます。

2. メッセージ

MCPクライアントとサーバ間のすべてのメッセージは、JSON-RPC 2.0 に準拠する必要があります。このプロトコルでは、以下の種類のメッセージが定義されています。

2-1. Requests

Requests は、操作を開始するためにクライアントからサーバに、またはその逆に送信されます。

{
  jsonrpc: "2.0";
  id: string | number;
  method: string;
  params?: {
    [key: string]: unknown;
  };
}

2-2. Responses

Responses はリクエストへの応答として送信され、操作の結果またはエラーが含まれます。

{
  jsonrpc: "2.0";
  id: string | number;
  result?: {
    [key: string]: unknown;
  }
  error?: {
    code: number;
    message: string;
    data?: unknown;
  }
}

2-3. Notifications

Notifications は、クライアントからサーバへ、またはサーバからクライアントへ、一方向のメッセージとして送信されます。受信者は応答を送信してはなりません。

{
  jsonrpc: "2.0";
  method: string;
  params?: {
    [key: string]: unknown;
  };
}

4. 認証

「MCP」は、HTTP で使用するための認可フレームワークを提供します。HTTPベースのトランスポートを使用する実装は、この仕様に準拠する必要があります（SHOULD）。一方、STDIO トランスポートを使用する実装は、この仕様に従わず、代わりに環境から資格情報を取得する必要があります（SHOULD）。
さらに、クライアントとサーバは、独自のカスタム認証および認可戦略をネゴシエートできます（MAY）。

5. スキーマ

プロトコルの完全な仕様はTypeScriptスキーマとして定義されています。これは、すべてのプロトコルメッセージと構造の信頼できる情報源です。
また、TypeScriptの信頼できる情報源から自動生成されるJSONスキーマもあり、さまざまな自動化ツールで使用できます。

5-1. 一般フィールド

・_meta
_meta プロパティ/パラメータは、クライアントとサーバーが相互作用に追加のメタデータを添付できるようにするために、「MCP」によって予約されています。
特定のキー名は、以下に指定されているように、プロトコルレベルのメタデータ用に「MCP」によって予約されています。実装では、これらのキーの値について想定してはなりません（MUST NOT）。
さらに、スキーマ内の定義では、定義内で宣言されているように、目的固有のメタデータ用に特定の名前を予約できます。

キー名の形式は、有効な _meta キー名は、オプションのプレフィックスと名前の2つのセグメントで構成されます。

次回