如何在10分钟内高效部署MCPHub服务器管理平台

MCPHub是一款能够将多个MCP服务器整合到单一SSE端点的统一中心服务器，通过Docker容器化技术实现零门槛部署，帮助用户轻松管理分布式服务器资源。本文将提供一套新手友好的部署方案，从环境检查到功能验证，全程无需专业运维知识。

核心价值解析

MCPHub作为轻量级服务器管理中枢，核心优势在于：

• 统一管控：将分散的MCP服务器整合为单一管理界面
• 实时监控：通过SSE协议实现服务器状态实时同步
• 灵活扩展：支持动态添加服务器节点与工具集成
• 简化运维：Docker容器化部署降低环境配置复杂度

环境检查步骤

在开始部署前，请确认系统已满足以下条件：

• Docker Engine 20.10+
• Docker Compose v2+
• 至少2GB可用内存
• 网络连接（用于拉取镜像）

检查Docker版本的命令：

docker --version && docker compose version

分步骤部署流程

1. 获取项目代码

git clone https://gitcode.com/gh_mirrors/mc/mcphub
cd mcphub

2. 启动容器集群

项目提供预配置的Docker Compose文件，包含PostgreSQL数据库和MCPHub应用：

docker-compose -f docker-compose.db.yml up -d

3. 验证服务状态

查看容器运行状态：

docker-compose -f docker-compose.db.yml ps

正常输出应显示两个运行中的服务：mcphub-app和mcphub-db

功能验证清单

部署完成后，通过以下步骤确认系统功能：

1. 访问管理界面：http://localhost:3000
2. 使用默认账户登录（admin/admin123）
3. 验证仪表盘数据加载正常

仪表盘关键指标说明：

• Total Servers：已注册服务器总数
• Online Servers：当前在线服务器数量
• Recent Servers：最近活动服务器列表

个性化配置方案

基础配置修改

创建.env文件自定义环境变量：

# 配置文件路径：./.env
DB_PASSWORD=your_secure_password
MCPHUB_PORT=3000

修改后需重启服务：

docker-compose -f docker-compose.db.yml down && docker-compose -f docker-compose.db.yml up -d

服务器市场使用

通过市场功能添加预设服务器：

1. 点击左侧导航栏"Market"
2. 浏览分类或搜索服务器
3. 点击卡片安装所需服务

分组管理设置

创建服务器分组提高管理效率：

1. 进入"Groups"页面
2. 点击"+ 添加"创建分组
3. 将服务器拖拽至目标分组

故障排查手册

服务启动失败

查看应用日志定位问题：

docker-compose -f docker-compose.db.yml logs app

常见原因及解决方案：

• 端口冲突：修改.env中的MCPHUB_PORT
• 数据库连接失败：检查DB_URL配置
• 资源不足：确保系统内存不低于2GB

登录异常处理

若无法登录管理界面：

1. 确认容器正常运行
2. 清除浏览器缓存
3. 检查数据库服务状态

进阶使用建议

• 数据备份：定期备份PostgreSQL数据卷
• 安全加固：修改默认管理员密码
• 性能优化：根据服务器数量调整资源分配
• 日志监控：配置日志轮转防止磁盘占满

官方文档：docs/configuration/docker-setup.mdx 配置示例：examples/mcp_settings_with_env_vars.json