操作场景
当您使用 HTTP 转 MCP 方式将已有的 RESTful 接口封装为 MCP 工具时,工具对外暴露的参数结构与后端接口的实际报文格式往往并不一致。通过 报文动态调整 功能,您可以在不改动后端服务的前提下,对工具的请求参数和响应内容进行重命名、定位、固定注入和模板化改写,使 MCP 工具的输入输出更符合大模型调用习惯。
前提条件
已创建云原生 AI 网关实例。
已创建 HTTP 转 MCP 类型的 MCP Server 及其工具。
操作步骤
1. 登录 微服务平台控制台 ,在左侧导航栏单击 云原生智能网关 > 实例列表。
2. 在实例列表页面,单击需要配置的网关实例的"ID",进入该网关实例的基本信息页面。
3. 在左侧导航栏单击 MCP 管理,在服务列表中单击目标 HTTP 转 MCP 服务的 ID/名称,进入服务详情页。
4. 在服务详情页顶部单击 Tools 管理 页签,在 Tools 列表页面选择目标 Tool 后进入到 Tool 基本信息页面。
5. 在 tool 详情页面选择「参数改写」tab 页面后,单击配置参数改写。
请求参数改写:
参数重命名:为对外参数设置映射到后端的真实字段名(后端字段名)。
参数位置(Position):指定参数在后端请求中的位置(如 Query、Header、Body 等)。
固定注入字段(InjectFields):为后端请求注入固定值字段(如固定的鉴权头、渠道标识等)。
响应模版改写:
响应模板(Response Body):使用 GJSON 语法从后端响应中提取并重组返回内容。
错误响应模板:自定义错误场景下返回给客户端的内容。
6. 单击 保存 使配置生效。
相关说明
配置时请遵守以下限制:
配置项 | 取值范围 / 限制 |
工具参数数量 | ≤ 20 个 |
标签键长度 | ≤ 128 字符 |
标签值长度 | ≤ 4096 字符 |
请求 Body 模板长度 | ≤ 16384 字符 |
响应 Body 模板长度 | ≤ 16384 字符 |
错误响应模板长度 | ≤ 2048 字符 |
响应模板采用 GJSON 语法提取字段,配置后建议在调试中验证输出是否符合预期。