已关闭
[MCP] 工具调用参数缺少 JSON Schema 校验:无效参数直接透传至 Handler 导致静默失败 #30
张鑫宇创建于  6月16日关闭于  19 天前
张鑫宇
张鑫宇成员
6月16日 创建

问题描述

当前 MCP Server 在处理 tools/call 请求时,未对客户端传入的工具参数(arguments)进行 JSON Schema 校验。工具定义(ToolDefinition)中明确声明了 inputSchema(JSON Schema),但在实际调用链路中,参数直接透传至注册的 Handler 函数,Handler 内部需要自行处理参数校验逻辑。

这导致以下问题:

  1. 静默失败:当客户端传入缺少必填字段、字段类型错误或格式不符合预期的参数时,Handler 内部若未做充分校验,可能以非预期的行为继续执行或直接崩溃,而客户端收到的是语义模糊的错误响应。
  2. 代码重复:每个 Tool Handler 都需要重复编写参数校验代码,违背 DRY 原则,也容易遗漏边界情况。
  3. 违反协议规范:MCP 协议规范明确要求 Server 应返回标准化的 InvalidParams 错误码,当前实现未遵循。

期望行为

  1. 在 MCP Server 调用 Handler 之前,自动对 arguments 进行 JSON Schema 校验(使用 inputSchema 中定义的 Schema)。
  2. 校验失败时,返回标准化的 JSON-RPC 错误响应,错误码为 -32602(InvalidParams),错误消息中详细说明哪个字段不符合要求。
  3. 可提供可选的严格模式开关,在 Schema 中设置了 additionalProperties: false 时,拒绝未在 Schema 中声明的额外字段。

建议实现方案

  1. 引入轻量级 JSON Schema 校验库(如 nlohmann/json-schema-validator 或 valijson),或自行实现核心校验逻辑(避免新增重度依赖)。
  2. 在 RequestHandler::HandleToolCall 或对应的请求分发入口处,在调用 Handler 前插入校验步骤。
  3. 将校验错误信息格式化后填入 JSON-RPC Error 的 data 字段,便于客户端定位问题。
  4. 添加相应的单元测试覆盖:合法参数通过、缺少必填字段、类型不匹配、额外字段(严格模式)等场景。

影响范围

  • mcp-cpp-sdk 模块
  • Tool Call 请求处理链路
  • 所有已注册的 Tool Handler(收益者,无需再自行校验)
likedislike
OopenJiuwen-bot成员
6月16日 添加了label:sig/sig-agent-protocol
openJiuwen-bot成员
6月16日 评论:

欢迎来到 openJiuwen 社区

Hey @xinyu-jiuwen , 感谢你对社区的贡献.

机器人使用手册

有关指令的使用,可以点击 此处 查看详情。开发人员可以在每个PR或Issue下方评论特定指令来触发机器人任务。

联系指引

有疑问可以联系 SIG: sig-agent-protocol ,
维护者是: @YiyangShao, @xinyu-jiuwen ,
审核者是: @gcw_hx9prznZ, @mingo007 .

likedislike
Zzhuyutong888成员
19 天前 关联了pull request:fix(mcp): add structured data for tool input validation errors
OopenJiuwen-bot成员
19 天前 关闭了 issue