MCP错误处理

错误代码

MCP服务器使用标准JSON-RPC 2.0错误码：

• -32700：解析错误 - 无效的JSON
• -32600: 无效请求 - 缺少必填字段
• -32601: 方法未找到 - 未知方法名
• -32602: 参数无效 - 参数格式错误
• -32001: 未授权或作用域不足

-32001 错误码涵盖身份验证失败和授权问题。 当您缺少工具所需的范围时，错误信息会包含您需要的范围详情：

{
  "jsonrpc": "2.0",
  "id": 5,
  "error": {
    "code": -32001,
    "message": "insufficient_scope",
    "data": {
      "tool": "add_application",
      "granted_scopes": ["read:application"],
      "required_scope": "write:application"
    }
  }
}

常见错误示例

无效的JSON会触发解析错误：

{
  "jsonrpc": "2.0",
  "id": null,
  "error": {
    "code": -32700,
    "message": "Parse error",
    "data": "unexpected character at position 12"
  }
}

未知方法返回“方法未找到”：

{
  "jsonrpc": "2.0",
  "id": 8,
  "error": {
    "code": -32601,
    "message": "Method not found",
    "data": "Method 'unknown_method' not found"
  }
}

附加功能

MCP 服务器实现了完整的 JSON-RPC 2.0 规范，包括通知（无 id 字段的请求）和批量请求。 “ping”方法提供了一种简单的健康检查：

{
  "jsonrpc": "2.0",
  "id": 9,
  "method": "ping"
}

在演示模式下运行时，服务器会限制写操作，以保护演示实例，同时允许所有读操作和身份验证流程。