MCP 工具参数怎么设计?用 JSON Schema 在调用前拦住无效输入

解释 inputSchema 应怎样表达必填字段、枚举、范围和额外字段,并给出调用前校验的验收方法。

解释 inputSchema 应怎样表达必填字段、枚举、范围和额外字段,并给出调用前校验的验收方法。

这篇要解决什么

搜索这个问题的读者通常正在尝试:为 MCP 工具建立可测试的参数契约,减少模型传错字段后才进入业务系统。。先在测试环境用只读或模拟数据完成链路,再考虑接入真实业务。

MCP 工具参数怎么设计?用 JSON Schema 在调用前拦住无效输入

按步骤完成

  1. 先为一个工具列出最小必填字段和每个字段允许的格式,不把自然语言描述当成输入规则。
  2. 用 schema 表达对象、字符串、数字、枚举和 required;是否允许额外字段也要明确。
  3. 客户端与服务器都保留校验:客户端减少无效请求,服务器负责最终拒绝。

用一条固定消息检查链路

以下只是协议层示例,展示要记录的字段,不代表已经连到你的服务器:

{"type":"object","properties":{"priority":{"enum":["low","high"]}},"required":["priority"],"additionalProperties":false}

把其中的工具名、参数和允许范围替换成自己的清单。不要把密钥、客户资料、订单号或生产地址写进演示文件。

怎样验收结果

准备正确参数、少必填字段、错误枚举和多余字段四组样本。验收记录应写明每组在客户端和服务器分别得到的结果。

失败边界

schema 能校验形状,不能证明参数代表的业务事实正确。比如存在的字符串不等于有权限读取该工单。

依据与核验日期

以上官方资料于 2026-10-01 核对。协议、SDK 和客户端界面会更新;实施前应再次阅读对应版本的官方说明。

相关问答

工具返回成功就能说明业务完成吗?

不能。工具返回只说明该调用得到响应;涉及写入时还要核对业务系统的最终状态、权限和审计记录。

Ai菜鸟网。发布者:AI小管家,转载请注明出处:https://www.alyyhw.com/32565.html

赞 (0)
AI小管家的头像AI小管家
MCP 怎么为智能体创建工具?先写清名称、输入和只读结果
上一篇 1小时前
MCP 怎么接入智能体?发现工具后做白名单、确认和结果回传
下一篇 1小时前

相关推荐

联系我们

联系我们

1

在线咨询: QQ交谈

邮件:admin@example.com

工作时间:周一至周五,9:30-18:30,节假日休息

关注微信
关注微信
分享本页
返回顶部