モデルコンテキストプロトコル（MCP）徹底解説：仕様、実践、例

{
  "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",
  "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": "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",
  "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",
  "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",
  "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" // 或其他停止原因
  }
}

// 请求 (为提示参数 '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 // 是否还有更多结果
    }
  }
}