MCP-JSONRPC-32602 错误排查指南

概述

MCP-JSONRPC-32602 是 MCP（Model Context Protocol）工具调用中最常见的错误之一。当 AI Agent 调用 MCP 工具时，如果提供的参数不符合工具定义的 schema 要求，服务器将返回此错误。

这个错误通常意味着：

• ❌ 缺少必填参数
• ❌ 参数类型不匹配
• ❌ 参数值超出有效范围
• ❌ 参数格式不正确

错误响应格式

当发生此错误时，MCP 服务器返回的标准错误响应结构如下：

{
  "jsonrpc": "2.0",
  "id": 42,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": {
      "param": "connection_string",
      "reason": "missing required parameter"
    }
  }
}

常见原因与解决方案

原因 1：缺少必填参数

解决方案： 检查工具定义中的 required 字段，确保所有必填参数都已提供。

原因 2：参数类型不匹配

解决方案： 确保传递的参数类型与工具定义一致。

原因 3：参数名拼写错误

解决方案： 仔细核对参数名，注意大小写敏感。

原因 4：参数值超出范围

解决方案： 调整参数值到有效范围内。

参考来源

• JSON-RPC 2.0 Specification
• MCP Error Codes - mcpevals.io
• MCP Schema Reference