服务器

​

获取所有服务器

• 端点: /api/servers
• 方法: GET
• 响应:
  Copy

  {
    "success": true,
    "data": [
      {
        "name": "example-server",
        "status": "connected",
        "tools": [
          {
            "name": "tool1",
            "description": "工具1的描述"
          }
        ],
        "config": {
          "type": "stdio",
          "command": "node",
          "args": ["server.js"]
        }
      }
    ]
  }
  

​

创建一个新服务器

• 端点: /api/servers
• 方法: POST
• 正文:
  Copy

  {
    "name": "my-new-server",
    "config": {
      "type": "stdio",
      "command": "python",
      "args": ["-u", "my_script.py"],
      "owner": "admin"
    }
  }
  

  • name (string, 必填): 服务器的唯一名称。
  • config (object, 必填): 服务器配置对象。
    • type (string): stdio、sse、streamable-http 或 openapi。
    • command (string): stdio 类型要执行的命令。
    • args (array of strings): 命令的参数。
    • url (string): sse、streamable-http 或 openapi 类型的 URL。
    • openapi (object): OpenAPI 配置。
      • url (string): OpenAPI 模式的 URL。
      • schema (object): OpenAPI 模式对象本身。
    • headers (object): sse、streamable-http 和 openapi 类型请求要发送的标头。
    • keepAliveInterval (number): sse 类型的保持活动间隔（毫秒）。默认为 60000。
    • owner (string): 服务器的所有者。默认为当前用户或“admin”。

​

更新一个服务器

• 端点: /api/servers/:name
• 方法: PUT
• 参数:
  • :name (string, 必填): 要更新的服务器的名称。
• 正文:
  Copy

  {
    "config": {
      "type": "stdio",
      "command": "node",
      "args": ["new_server.js"]
    }
  }
  

  • config (object, 必填): 更新后的服务器配置对象。详情请参阅“创建一个新服务器”。

​

删除一个服务器

• 端点: /api/servers/:name
• 方法: DELETE
• 参数:
  • :name (string, 必填): 要删除的服务器的名称。

​

切换一个服务器

• 端点: /api/servers/:name/toggle
• 方法: POST
• 参数:
  • :name (string, 必填): 要切换的服务器的名称。
• 正文:
  Copy

  {
    "enabled": true
  }
  

  • enabled (boolean, 必填): true 启用服务器，false 禁用服务器。

​

切换一个工具

• 端点: /api/servers/:serverName/tools/:toolName/toggle
• 方法: POST
• 参数:
  • :serverName (string, 必填): 服务器的名称。
  • :toolName (string, 必填): 工具的名称。
• 正文:
  Copy

  {
    "enabled": true
  }
  

  • enabled (boolean, 必填): true 启用工具，false 禁用工具。

​

更新工具描述

• 端点: /api/servers/:serverName/tools/:toolName/description
• 方法: PUT
• 参数:
  • :serverName (string, 必填): 服务器的名称。
  • :toolName (string, 必填): 工具的名称。
• 正文:
  Copy

  {
    "description": "新的工具描述"
  }
  

  • description (string, 必填): 工具的新描述。