Skip to main content

推荐工具

根据自然语言需求推荐 MCP 工具,返回工具名称、描述和入参 schema。

接口

GET /api/v1/mcp/servers/tools/recommend

请求参数

参数类型必填默认值说明
querystring是-自然语言检索需求,不能为空白
topNint否10建议返回数量;小于等于 0 时使用默认值 10
topN 是目标条数,不保证返回数量严格等于该值。

响应

data 为工具数组,每项包含四个字段:
字段类型说明
mcp_codestringMCP 编码,可用于路径参数 mcpCode
tool_namestring工具名称,可用于调用工具的 tool_name
tool_descriptionstring / null工具描述
tool_input_schemaobject / null工具入参 schema,结构与查询工具列表的 inputSchema 相同

示例

curl -G "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/mcp/servers/tools/recommend" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --data-urlencode "query=根据订单号查询订单" \
  --data-urlencode "topN=5"
{
  "success": true,
  "error_code": null,
  "error_msg": null,
  "data": [
    {
      "mcp_code": "mcp-a1b2c3d4e5f6g7h8",
      "tool_name": "getOrder",
      "tool_description": "根据订单号查询订单",
      "tool_input_schema": {
        "type": "object",
        "properties": {
          "orderId": {
            "type": "string",
            "description": "订单号"
          }
        },
        "required": ["orderId"],
        "additionalProperties": false
      }
    }
  ],
  "request_id": "6f1c2a8e-3b0d-4c55-9a0e-2f7d1c9b8a11"
}

错误

HTTP 状态码error_code说明
400InvalidParameterquery 缺失或空白,或携带了不支持的查询参数
502McpUpstreamError下游 MCP 操作失败
推荐结果不代表服务已经开通。调用 One Key MCP 工具时,服务可能自动完成开通并产生费用。