工具

​

调用工具

• 端点: /api/tools/call/:server
• 方法: POST
• 参数:
  • :server (字符串, 必需): MCP 服务器的名称。
• 请求正文:
  {
    "toolName": "tool-name",
    "arguments": {
      "param1": "value1",
      "param2": "value2"
    }
  }
  
  • toolName (字符串, 必需): 要执行的工具名称。
  • arguments (对象, 可选): 传递给工具的参数。默认为空对象。
• 响应:
  {
    "success": true,
    "data": {
      "content": [
        {
          "type": "text",
          "text": "工具执行结果"
        }
      ],
      "toolName": "tool-name",
      "arguments": {
        "param1": "value1",
        "param2": "value2"
      }
    }
  }
  

curl -X POST "http://localhost:3000/api/tools/call/amap" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -d '{
    "toolName": "amap-maps_weather",
    "arguments": {
      "city": "Beijing"
    }
  }'

• 工具参数会根据工具的输入模式自动转换为适当的类型。
• 如果需要，可以使用 x-session-id 请求头在多个工具调用之间维护会话状态。
• 此端点需要身份验证。

​

替代方案：OpenAPI 工具执行

• GET /api/tools/:serverName/:toolName - 用于带查询参数的简单工具
• POST /api/tools/:serverName/:toolName - 用于带 JSON 正文的复杂工具