消息

協議版本: 2024-11-05

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。