MCP 工具参数默认值与必填校验:为什么 inputSchema 里省略的字段会让服务端收到 undefined
Agent 调用带可选参数的 MCP 工具时,模型省略字段常让服务端收到缺键参数对象,引发解引用报错或空值写入。文章从 JSON Schema 中 required 与 default 的语义边界出发,说明缺键如何产生、校验点应放在哪里,并比较客户端预填与服务端容错解析的取舍。
共 6 篇文章
Agent 调用带可选参数的 MCP 工具时,模型省略字段常让服务端收到缺键参数对象,引发解引用报错或空值写入。文章从 JSON Schema 中 required 与 default 的语义边界出发,说明缺键如何产生、校验点应放在哪里,并比较客户端预填与服务端容错解析的取舍。
Agent 调用带数值与布尔参数的 MCP 工具时,模型常把 5 写成 "5"、把 true 写成 "true",服务端按 inputSchema 严格校验就会直接拒绝。本文用一个库存查询工具贯穿全文,梳理类型声明、序列化路径、隐式转换歧义与枚举大小写问题,并对比客户端预校验与服务端宽松解析的取舍。
远程 MCP Server 返回结构化工具结果时,outputSchema 声明返回结构,structuredContent 承载实际负载。本文用一个订单查询工具贯穿全文,分析二者不一致、schema 未声明、客户端只读 content 文本分支时各自的解析失败路径,对比纯文本封装与严格校验两种方案,并给出服务端与客户端的校验点和可观测指标。
工具跑到一半才发现缺少必填参数,直接报错会让用户重来一遍。本文以订位工具为例,拆解 MCP elicitation/create 如何暂停调用、用受限 JSON Schema 收集结构化输入并恢复执行,分析 accept、decline、cancel 三条路径、schema 校验失败与超时处理、敏感字段为何必须走 URL 模式,并给出可观测指标与适用边界。
接入多个 MCP Server 的 Agent 为什么越接越笨?本文从工具名、描述与 JSON Schema 被序列化进系统提示并随每轮请求重复计费讲起,分析工具数量增长带来的上下文挤占与选择准确率下降,对比全量注入、检索式筛选与动态发现三种加载策略的延迟与可靠性权衡,并给出可观测指标与适用边界。
本文以自动生成可解析的 JSON 和 SQL 为场景,解释约束解码如何在前向传播时屏蔽非法 Token,对比后处理修复与重试的失败模式,分析对生成质量、延迟和实现复杂度的影响,并给出适用边界。