根据自然语言需求推荐 MCP 工具,返回工具名称、描述和入参 schema。
接口
GET /api/v1/mcp/servers/tools/recommend
请求参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| query | string | 是 | - | 自然语言检索需求,不能为空白 |
| topN | int | 否 | 10 | 建议返回数量;小于等于 0 时使用默认值 10 |
topN 是目标条数,不保证返回数量严格等于该值。
响应
data 为工具数组,每项包含四个字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| mcp_code | string | MCP 编码,可用于路径参数 mcpCode |
| tool_name | string | 工具名称,可用于调用工具的 tool_name |
| tool_description | string / null | 工具描述 |
| tool_input_schema | object / null | 工具入参 schema,结构与查询工具列表的 inputSchema 相同 |
示例
错误
| HTTP 状态码 | error_code | 说明 |
|---|---|---|
| 400 | InvalidParameter | query 缺失或空白,或携带了不支持的查询参数 |
| 502 | McpUpstreamError | 下游 MCP 操作失败 |
推荐结果不代表服务已经开通。调用 One Key MCP 工具时,服务可能自动完成开通并产生费用。