​
概述

MCPHub 的服务器管理系统允许您从单个仪表板集中配置、监控和控制多个 MCP（模型上下文协议）服务器。所有更改都会实时应用，无需重启服务器。

​
添加 MCP 服务器

​
通过仪表板

  1. 访问仪表板: 导航到 http://localhost:3000 并登录
  2. 点击”添加服务器”: 位于服务器部分
  3. 填写服务器详细信息:
    • 名称: 服务器的唯一标识符
    • 命令: 可执行命令（例如 npx、uvx、python）
    • 参数: 命令参数数组
    • 环境变量: 环境设置的键值对
    • 工作目录: 命令的可选工作目录

​
通过配置文件

编辑您的 mcp_settings.json 文件： 
{
  "mcpServers": {
    "server-name": {
      "command": "command-to-run",
      "args": ["arg1", "arg2"],
      "env": {
        "API_KEY": "your-api-key",
        "CONFIG_VALUE": "some-value"
      },
      "cwd": "/optional/working/directory"
    }
  }
}

​
通过 API

使用 REST API 以编程方式添加服务器： 
curl -X POST http://localhost:3000/api/servers \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -d '{
    "name": "fetch-server",
    "command": "uvx",
    "args": ["mcp-server-fetch"],
    "env": {}
  }'

​
流行的 MCP 服务器示例

​
服务器生命周期管理

​
启动服务器

服务器会在以下情况下自动启动：
  • MCPHub 启动时
  • 通过仪表板或 API 添加服务器时
  • 服务器配置更新时
  • 手动重启已停止的服务器时

​
停止服务器

您可以通过以下方式停止服务器：
  • 通过仪表板: 切换服务器状态开关
  • 通过 API: 发送 POST 请求到 /api/servers/{name}/toggle
  • 自动停止: 服务器崩溃或遇到错误时会自动停止

​
重启服务器

服务器会在以下情况下自动重启：
  • 配置更改时
  • 环境变量更新后
  • 通过仪表板或 API 手动触发时

​
服务器状态监控

​
状态指示器

每个服务器都显示状态指示器：
  • 🟢 运行中: 服务器处于活动状态并响应
  • 🟡 启动中: 服务器正在初始化
  • 🔴 已停止: 服务器未运行
  • ⚠️ 错误: 服务器遇到错误

​
实时日志

实时查看服务器日志：
  1. 仪表板日志: 点击服务器查看其日志
  2. API 日志: 通过 /api/logs 端点访问日志
  3. 流式日志: 通过 WebSocket 订阅日志流

​
健康检查

MCPHub 自动执行健康检查：
  • 初始化检查: 验证服务器成功启动
  • 工具发现: 确认检测到可用工具
  • 响应检查: 测试服务器响应性
  • 资源监控: 跟踪 CPU 和内存使用情况

​
配置管理

​
环境变量

服务器可以使用环境变量进行配置： 
{
  "server-name": {
    "command": "python",
    "args": ["server.py"],
    "env": {
      "API_KEY": "${YOUR_API_KEY}",
      "DEBUG": "true",
      "MAX_CONNECTIONS": "10"
    }
  }
}
环境变量展开:
  • ${VAR_NAME}: 展开为环境变量值
  • ${VAR_NAME:-default}: 如果变量未设置则使用默认值
  • ${VAR_NAME:+value}: 如果变量已设置则使用指定值

​
命令变体

指定服务器命令的不同方式： 
{
  "npm-server": {
    "command": "npx",
    "args": ["-y", "package-name", "--option", "value"]
  }
}

​
高级功能

​
热重载

MCPHub 支持服务器配置的热重载：
  1. 仪表板更新: 立即应用通过 Web 界面进行的更改
  2. API 更新: 通过 REST API 调用进行实时更新
  3. 零停机时间: 优雅的服务器重启，不影响其他服务器

​
故障排除

​
下一步

分组管理

将服务器组织成逻辑分组

智能路由

设置 AI 驱动的工具发现

API 参考

服务器管理 API 文档

配置指南

详细配置选项