消息

協議版本: 草案

MCP 中的所有消息必須遵循 JSON-RPC 2.0 規範。協議定義了三種類型的消息:

請求

請求從客戶端發送到服務器或相反。

{
  jsonrpc: "2.0";
  id: string | number;
  method: string;
  params?: {
    [key: string]: unknown;
  };
}
  • 請求必須包含字符串或整數 ID。
  • 與基本 JSON-RPC 不同,ID不得null
  • 請求 ID不得是請求方在同一會話中先前使用過的。

響應

響應作為對請求的回覆發送。

{
  jsonrpc: "2.0";
  id: string | number;
  result?: {
    [key: string]: unknown;
  }
  error?: {
    code: number;
    message: string;
    data?: unknown;
  }
}
  • 響應必須包含與它們對應的請求相同的 ID。
  • 必須設置 resulterror。響應不得同時設置兩者。
  • 錯誤代碼必須是整數。

通知

通知從客戶端發送到服務器或相反。接收者不得發送響應。

{
  jsonrpc: "2.0";
  method: string;
  params?: {
    [key: string]: unknown;
  };
}
  • 通知不得包含 ID。