MCP 协议详解（Model Context Protocol）

// 请求
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_github",
    "arguments": {
      "query": "MCP protocol",
      "language": "python"
    }
  }
}

// 成功响应
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "找到 3 个相关仓库：..."
      }
    ]
  }
}

// 错误响应
{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid arguments: 'query' is required"
  }
}

// 通知（无 id，不需要响应）
{
  "jsonrpc": "2.0",
  "method": "notifications/tools/list_changed"
}

// tools/list 返回
{
  "tools": [
    {
      "name": "query_database",
      "description": "执行 SQL 查询并返回结果",
      "inputSchema": {
        "type": "object",
        "properties": {
          "sql": {
            "type": "string",
            "description": "SQL 查询语句"
          },
          "database": {
            "type": "string",
            "enum": ["production", "analytics"]
          }
        },
        "required": ["sql"]
      }
    }
  ]
}

// tools/call 请求
{
  "method": "tools/call",
  "params": {
    "name": "query_database",
    "arguments": {
      "sql": "SELECT * FROM users LIMIT 10",
      "database": "analytics"
    }
  }
}

// tools/call 响应
{
  "result": {
    "content": [
      {"type": "text", "text": "查询结果: ..."},
      {"type": "image", "data": "base64...", "mimeType": "image/png"}
    ],
    "isError": false
  }
}

// resources/list 返回
{
  "resources": [
    {
      "uri": "file:///project/src/main.py",
      "name": "main.py",
      "mimeType": "text/x-python",
      "description": "项目入口文件"
    },
    {
      "uri": "db://analytics/sales_summary",
      "name": "销售汇总数据",
      "mimeType": "application/json"
    }
  ]
}

// resources/read 请求
{
  "method": "resources/read",
  "params": {
    "uri": "file:///project/src/main.py"
  }
}

// 资源模板（动态资源）
{
  "resourceTemplates": [
    {
      "uriTemplate": "db://analytics/{table_name}",
      "name": "数据库表数据",
      "description": "读取指定数据库表的内容"
    }
  ]
}

// prompts/list 返回
{
  "prompts": [
    {
      "name": "code_review",
      "description": "代码审查提示词模板",
      "arguments": [
        {
          "name": "language",
          "description": "编程语言",
          "required": true
        },
        {
          "name": "code",
          "description": "要审查的代码",
          "required": true
        }
      ]
    }
  ]
}

// prompts/get 请求
{
  "method": "prompts/get",
  "params": {
    "name": "code_review",
    "arguments": {
      "language": "Python",
      "code": "def hello(): pass"
    }
  }
}

// prompts/get 响应
{
  "messages": [
    {
      "role": "user",
      "content": {
        "type": "text",
        "text": "请审查以下 Python 代码的质量和安全性：\n```python\ndef hello(): pass\n```"
      }
    }
  ]
}

1. 最小权限原则
   Server 只暴露必要的工具和资源
   客户端只能访问被授权的能力

2. 用户确认机制
   高风险工具调用需要用户显式确认
   如：删除文件、发送邮件、修改数据库

3. 沙箱隔离
   文件系统访问限制在指定目录
   代码执行在隔离容器中
   网络访问受白名单控制

4. 能力协商
   初始化时 Client 和 Server 协商各自支持的能力
   不支持的能力不会被调用

{
  "serverInfo": {
    "name": "filesystem-server",
    "version": "1.0.0"
  },
  "capabilities": {
    "tools": {
      "listChanged": true
    },
    "resources": {
      "subscribe": true,
      "listChanged": true
    }
  }
}