{
  "jsonrpc": "2.0",
  "id": "req-1", // 必须是字符串或数字，不能是 null，且会话内唯一
  "method": "methodName",
  "params": { ... }
}

{
  "jsonrpc": "2.0",
  "id": "req-1", // 与请求 ID 相同
  "result": { ... }, // 成功时设置
  "error": { // 失败时设置
    "code": -32600,
    "message": "Error description",
    "data": { ... }
  }
}

{
  "jsonrpc": "2.0",
  "method": "notificationName",
  "params": { ... }
}

{
  "jsonrpc": "2.0",
  "id": 1, // 初始化请求ID
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-03-26", // 客户端支持的最新版本
    "capabilities": { // 客户端声明的能力
      "roots": { // 支持根目录功能
        "listChanged": true // 支持根目录列表变化通知
      },
      "sampling": {} // 支持采样功能
    },
    "clientInfo": { // 客户端信息
      "name": "mcp-example-client",
      "version": "1.0.0"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1, // 与请求 ID 相同
  "result": {
    "protocolVersion": "2025-03-26", // 服务器确认或选择的版本
    "capabilities": { // 服务器声明的能力
      "logging": {}, // 支持日志
      "prompts": { // 支持提示
        "listChanged": true // 支持提示列表变化通知
      },
      "resources": { // 支持资源
        "subscribe": true, // 支持资源订阅
        "listChanged": true // 支持资源列表变化通知
      },
      "tools": { // 支持工具
        "listChanged": true // 支持工具列表变化通知
      },
      "completion": {} // 支持自动完成
    },
    "serverInfo": { // 服务器信息
      "name": "mcp-example-server",
      "version": "1.0.0"
    },
    "instructions": "Optional instructions for the client" // 可选的服务器指令
  }
}

{
  "jsonrpc": "2.0",
  "method": "notifications/initialized"
}

// 请求
{
  "jsonrpc": "2.0",
  "id": "res-list-1",
  "method": "resources/list",
  "params": { "cursor": "optional-cursor" }
}

// 响应
{
  "jsonrpc": "2.0",
  "id": "res-list-1",
  "result": {
    "resources": [
      {
        "uri": "file:///project/src/main.rs",
        "name": "main.rs",
        "description": "Primary application entry point",
        "mimeType": "text/x-rust"
      }
      // ... 其他资源
    ],
    "nextCursor": "next-page-cursor" // 如果有更多结果
  }
}

// 请求
{
  "jsonrpc": "2.0",
  "id": "res-read-1",
  "method": "resources/read",
  "params": { "uri": "file:///project/src/main.rs" }
}

// 响应 (文本)
{
  "jsonrpc": "2.0",
  "id": "res-read-1",
  "result": {
    "contents": [
      {
        "uri": "file:///project/src/main.rs",
        "mimeType": "text/x-rust",
        "text": "fn main() { ... }"
      }
    ]
  }
}

// 响应 (二进制)
{
  "jsonrpc": "2.0",
  "id": "res-read-2",
  "result": {
    "contents": [
      {
        "uri": "file:///project/logo.png",
        "mimeType": "image/png",
        "blob": "base64-encoded-data"
      }
    ]
  }
}

// 请求
{
  "jsonrpc": "2.0",
  "id": "res-sub-1",
  "method": "resources/subscribe",
  "params": { "uri": "file:///project/src/main.rs" }
}
// 响应 (成功)
{
  "jsonrpc": "2.0",
  "id": "res-sub-1",
  "result": {}
}

{
  "jsonrpc": "2.0",
  "method": "notifications/resources/updated",
  "params": { "uri": "file:///project/src/main.rs" }
}

{
  "jsonrpc": "2.0",
  "method": "notifications/resources/list_changed"
}

// 请求
{
  "jsonrpc": "2.0",
  "id": "tool-list-1",
  "method": "tools/list"
}

// 响应
{
  "jsonrpc": "2.0",
  "id": "tool-list-1",
  "result": {
    "tools": [
      {
        "name": "get_weather",
        "description": "Get current weather for a location",
        "inputSchema": { /* JSON Schema for input */ },
        "annotations": { /* 行为描述，如 isReadOnly, isDestructive */ }
      }
      // ... 其他工具
    ],
    "nextCursor": "...
  }
}

// 请求
{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "get_weather",
    "arguments": { "location": "New York" }
  }
}

// 响应 (成功)
{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "result": {
    "content": [
      { "type": "text", "text": "Weather in NY: ..." }
      // 可以包含 text, image, audio, resource
    ],
    "isError": false
  }
}

// 响应 (工具执行错误)
{
  "jsonrpc": "2.0",
  "id": "tool-call-2",
  "result": {
    "content": [
      { "type": "text", "text": "API rate limit exceeded" }
    ],
    "isError": true
  }
}

{
  "jsonrpc": "2.0",
  "method": "notifications/tools/list_changed"
}

// 请求
{
  "jsonrpc": "2.0",
  "id": "prompt-list-1",
  "method": "prompts/list"
}

// 响应
{
  "jsonrpc": "2.0",
  "id": "prompt-list-1",
  "result": {
    "prompts": [
      {
        "name": "code_review",
        "description": "Review code quality",
        "arguments": [ { "name": "code", ... } ]
      }
      // ... 其他提示
    ],
    "nextCursor": "...
  }
}

// 请求
{
  "jsonrpc": "2.0",
  "id": "prompt-get-1",
  "method": "prompts/get",
  "params": {
    "name": "code_review",
    "arguments": { "code": "..." }
  }
}

// 响应
{
  "jsonrpc": "2.0",
  "id": "prompt-get-1",
  "result": {
    "description": "Code review prompt",
    "messages": [
      {
        "role": "user", // 或 "assistant"
        "content": {
          "type": "text", // 或 image, audio, resource
          "text": "Please review: ..."
        }
      }
      // ... 其他消息
    ]
  }
}

{
  "jsonrpc": "2.0",
  "method": "notifications/prompts/list_changed"
}

// 请求
{
  "jsonrpc": "2.0",
  "id": "roots-list-1",
  "method": "roots/list"
}

// 响应
{
  "jsonrpc": "2.0",
  "id": "roots-list-1",
  "result": {
    "roots": [
      {
        "uri": "file:///home/user/projects/myproject",
        "name": "My Project"
      }
      // ... 其他根目录
    ]
  }
}

{
  "jsonrpc": "2.0",
  "method": "notifications/roots/list_changed"
}

// 请求
{
  "jsonrpc": "2.0",
  "id": "sampling-1",
  "method": "sampling/createMessage",
  "params": {
    "messages": [
      {
        "role": "user",
        "content": { "type": "text", "text": "Capital of France?" }
      }
      // 可以包含 text, image, audio 内容
    ],
    "modelPreferences": { // 客户端如何选择模型
      "hints": [ { "name": "claude-3-sonnet" } ], // 建议的模型 (可选，客户端决定)
      "intelligencePriority": 0.8, // 0-1
      "speedPriority": 0.5, // 0-1
      "costPriority": 0.3 // 0-1
    },
    "systemPrompt": "You are helpful.", // 可选
    "maxTokens": 100 // 可选
    // ... 其他 LLM 参数
  }
}

// 响应
{
  "jsonrpc": "2.0",
  "id": "sampling-1",
  "result": {
    "role": "assistant",
    "content": { "type": "text", "text": "Paris." },
    "model": "claude-3-sonnet-20240307", // 实际使用的模型
    "stopReason": "endTurn" // 或其他停止原因
  }
}

// 请求 (双向)
{
  "jsonrpc": "2.0",
  "id": "ping-1",
  "method": "ping"
}

// 响应
{
  "jsonrpc": "2.0",
  "id": "ping-1",
  "result": {}
}

// 请求 (例如 tool/call)
{
  "jsonrpc": "2.0",
  "id": "long-op-1",
  "method": "tools/call",
  "params": {
    "name": "run_analysis",
    "arguments": { ... },
    "_meta": {
      "progressToken": "analysis-job-123"
    }
  }
}

{
  "jsonrpc": "2.0",
  "method": "notifications/progress",
  "params": {
    "progressToken": "analysis-job-123",
    "progress": 50, // 当前进度值
    "total": 100, // 总量 (可选)
    "message": "Processing data..." // 描述信息 (可选)
  }
}

// 请求
{
  "jsonrpc": "2.0",
  "id": "log-level-1",
  "method": "logging/setLevel",
  "params": { "level": "info" }
}

{
  "jsonrpc": "2.0",
  "method": "notifications/message",
  "params": {
    "level": "error",
    "logger": "database", // 可选的日志记录器名称
    "data": { // 任意 JSON 数据
      "error": "Connection failed",
      "details": { "host": "..." }
    }
  }
}

{
  "jsonrpc": "2.0",
  "method": "notifications/cancelled",
  "params": {
    "requestId": "long-op-1", // 要取消的请求 ID
    "reason": "User requested cancellation" // 可选原因
  }
}

// 请求 (为提示参数 'language' 获取建议)
{
  "jsonrpc": "2.0",
  "id": "complete-1",
  "method": "completion/complete",
  "params": {
    "ref": { "type": "ref/prompt", "name": "code_review" },
    "argument": { "name": "language", "value": "py" }
  }
}

// 响应
{
  "jsonrpc": "2.0",
  "id": "complete-1",
  "result": {
    "completion": {
      "values": ["python", "pytorch"], // 建议列表 (最多100)
      "total": 5, // 可选的总匹配数
      "hasMore": true // 是否还有更多结果
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": "list-page-1",
  "result": {
    "items": [...], // 当前页结果
    "nextCursor": "opaque-cursor-string"
  }
}

{
  "jsonrpc": "2.0",
  "id": "list-page-2",
  "method": "resources/list",
  "params": {
    "cursor": "opaque-cursor-string"
  }
}

// 示例：资源未找到
{
  "jsonrpc": "2.0",
  "id": "read-error-1",
  "error": {
    "code": -32002,
    "message": "Resource not found",
    "data": { "uri": "file:///nonexistent.txt" }
  }
}