HTTP转MCP配置字段参考(1) 本文档提供 HTTP 转 MCP 配置的字段说明与参考,帮助您通过自定义 YAML 为 MCP 服务集成工具。 配置字段 服务器配置 名称 数据类型 是否必填 描述 server.name string 必填 HTTP to MCP 场景,此字段可以填写任意值。 server.securitySchemes array[object] 选填 定义可重用的认证方案,供工具引用。详见下方的认证与安全 允许的工具配置 名称 数据类型 是否必填 描述 allowTools array[string] 选填 允许调用的工具列表。如不指定,则允许所有工具。 HTTP to MCP 工具配置 名称 数据类型 是否必填 描述 tools array[object] 选填 HTTP to MCP 工具配置列表。 tools[].name string 必填 工具名称。 tools[].description string 必填 工具功能描述。 tools[].args array[object] 必填 工具参数定义。 tools[].args[].name string 必填 参数名称。 tools[].args[].description string 必填 参数描述。 tools[].args[].type string 选填 参数类型(string, number, integer, boolean, array, object)。默认是string。 tools[].args[].required boolean 选填 参数是否必需。默认是false。 tools[].args[].default any 选填 参数默认值。 tools[].args[].enum array 选填 参数允许的值列表。 tools[].args[].items object 选填 数组项的模式(当type为array时)。 tools[].args[].properties object 选填 对象属性的模式(当type为object时)。 tools[].args[].position string 选填 参数在请求中的位置(query, path, header, cookie, body)。 tools[].requestTemplate object 必填 HTTP 请求模板。 tools[].requestTemplate.url string 必填 请求 URL 模板。 tools[].requestTemplate.method string 必填 HTTP 方法(GET/POST等)。 tools[].requestTemplate.headers array[object] 选填 请求头模板。 tools[].requestTemplate.headers[].key string 必填 请求头名称。 tools[].requestTemplate.headers[].value string 必填 请求头值模板。 tools[].requestTemplate.body string 选填 请求体模板(与argsToJsonBody、argsToUrlParam、argsToFormBody互斥)。 tools[].requestTemplate.argsToJsonBody boolean 选填 默认是false。当为true时,参数将直接用作JSON请求体(与body、argsToUrlParam、argsToFormBody互斥)。 tools[].requestTemplate.argsToUrlParam boolean 选填 默认是false。当为true时,参数将作为查询参数添加到URL中(与body、argsToJsonBody、argsToFormBody互斥)。 tools[].requestTemplate.argsToFormBody boolean 选填 默认是false。当为true时,参数将以application/xwwwformurlencoded格式编码在请求体中(与body、argsToJsonBody、argsToUrlParam互斥)。 tools[].requestTemplate.security object 选填 HTTP 请求模板的安全配置,用于定义 MCP Server 和 HTTP API 之间的认证方式。 tools[].requestTemplate.security.id string 当 tools[].requestTemplate.security 配置时必填 引用在 server.securitySchemes 中定义的认证方案 ID。 tools[].requestTemplate.security.credential string 选填 覆盖 server.securitySchemes 中定义的默认凭证。
来自: