服务器

---

​

获取所有服务器

检索所有已配置的 MCP 服务器的列表，包括其状态和可用工具。

• 端点: /api/servers
• 方法: GET
• 响应:
  {
    "success": true,
    "data": [
      {
        "name": "example-server",
        "status": "connected",
        "tools": [
          {
            "name": "tool1",
            "description": "工具1的描述"
          }
        ],
        "config": {
          "type": "stdio",
          "command": "node",
          "args": ["server.js"]
        }
      }
    ]
  }
  

---

​

创建一个新服务器

将一个新的 MCP 服务器添加到配置中。

• 端点: /api/servers
• 方法: POST
• 正文:
  {
    "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): 远端服务健康检查和自动重连的间隔（毫秒）。默认为 60000。
    • enableKeepAlive (boolean): 是否为远端服务启用周期性健康检查和自动重连。
    • owner (string): 服务器的所有者。默认为当前用户或“admin”。

---

​

更新一个服务器

更新现有 MCP 服务器的配置。

• 端点: /api/servers/:name
• 方法: PUT
• 参数:
  • :name (string, 必填): 要更新的服务器的名称。
• 正文:
  {
    "config": {
      "type": "stdio",
      "command": "node",
      "args": ["new_server.js"]
    }
  }
  
  • config (object, 必填): 更新后的服务器配置对象。详情请参阅“创建一个新服务器”。

---

​

删除一个服务器

从配置中删除一个 MCP 服务器。

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

---

​

切换一个服务器

启用或禁用一个 MCP 服务器。

• 端点: /api/servers/:name/toggle
• 方法: POST
• 参数:
  • :name (string, 必填): 要切换的服务器的名称。
• 正文:
  {
    "enabled": true
  }
  
  • enabled (boolean, 必填): true 启用服务器，false 禁用服务器。

---

​

切换一个工具

启用或禁用服务器上的特定工具。

• 端点: /api/servers/:serverName/tools/:toolName/toggle
• 方法: POST
• 参数:
  • :serverName (string, 必填): 服务器的名称。
  • :toolName (string, 必填): 工具的名称。
• 正文:
  {
    "enabled": true
  }
  
  • enabled (boolean, 必填): true 启用工具，false 禁用工具。

---

​

更新工具描述

更新特定工具的描述。

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

---

​

更新系统配置

更新系统范围的配置设置。

• 端点: /api/system-config
• 方法: PUT
• 正文:
  {
    "openaiApiKey": "sk-...",
    "openaiBaseUrl": "https://api.openai.com/v1",
    "modelName": "gpt-4",
    "temperature": 0.7,
    "maxTokens": 2048
  }
  
  • 所有字段都是可选的。只有提供的字段会被更新。

---

​

获取设置

检索所有服务器设置和配置。

• 端点: /api/settings
• 方法: GET
• 响应:
  {
    "success": true,
    "data": {
      "servers": [...],
      "groups": [...],
      "systemConfig": {...}
    }
  }
  

注意: 有关详细的提示词管理，请参阅 提示词 API 文档。