零基础掌握MCPHub智能路由：从部署到实战全指南

MCPHub作为统一的中心服务器，能够将多个MCP服务器整合到单一的SSE端点，实现高效的服务器管理和资源整合。本文将带你零基础掌握MCPHub的部署流程、深度配置及场景应用，让你轻松上手这一强大工具。

部署决策指南：选择适合你的安装方案

在开始部署MCPHub之前，让我们先了解不同的安装方案，以便选择最适合你的方式：

• Docker Compose一键部署：适合快速体验和测试，无需复杂配置
• 手动部署：适合需要深度定制和优化的生产环境
• Kubernetes部署：适合大规模集群环境

本指南将重点介绍Docker Compose一键部署方案，这是新手入门的最佳选择。

环境准备指南：部署前的必要检查

在开始部署MCPHub之前，请确保你的系统已经满足以下要求：

• Docker Engine 20.10.0+
• Docker Compose 2.0+
• 至少2GB可用内存
• 10GB以上可用磁盘空间

你可以通过以下命令检查Docker和Docker Compose是否已安装：

docker --version
docker-compose --version

如果尚未安装，可以参考Docker官方文档进行安装。

快速部署流程：5分钟启动MCPHub

1. 获取项目代码

首先，克隆MCPHub项目仓库到本地：

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

2. 启动服务

MCPHub提供了便捷的docker-compose.db.yml配置文件，包含PostgreSQL数据库和MCPHub应用服务：

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

这个命令会执行以下操作：

• 构建MCPHub应用镜像（如果本地没有）
• 拉取PostgreSQL数据库镜像
• 启动两个服务：PostgreSQL数据库和MCPHub应用
• 将服务设置为后台运行

3. 验证部署

部署完成后，可以通过访问以下地址来验证MCPHub是否正常运行：

http://localhost:3000

成功部署后，你将看到MCPHub的登录界面。使用默认管理员账户（用户名：admin，密码：admin）登录后，将进入MCPHub的仪表盘：

仪表盘显示了服务器总数、在线服务器、离线服务器和连接中服务器的状态，以及最近的服务器列表。

深度配置指南：从基础到进阶

基础配置

MCPHub的基础配置可以通过环境变量来实现。创建.env文件并设置以下常用参数：

# 数据库配置
DB_PASSWORD=your_secure_password
DB_HOST=postgres
DB_PORT=5432
DB_NAME=mcphub

# 应用配置
MCPHUB_PORT=3000
NODE_ENV=production

修改配置后，需要重启服务使配置生效：

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

进阶配置

对于更高级的配置需求，可以直接编辑mcp_settings.json文件。这个文件包含了MCPHub的详细配置，包括服务器设置、认证配置、日志选项等。

例如，配置智能路由功能：

智能路由功能允许MCPHub根据输入自动搜索最合适的工具，提高服务器资源的利用效率。

场景应用指南：MCPHub的实际使用

服务器管理

MCPHub提供了直观的服务器管理界面，可以轻松添加、编辑和删除MCP服务器。在"服务器"标签页中，你可以查看所有已连接的服务器状态，并进行管理操作。

服务器市场

MCPHub的服务器市场功能让你可以发现和安装新的MCP服务器。市场中提供了各种类别的服务器，包括AI系统、分析工具、数据库等：

分组管理

通过分组功能，你可以将服务器按照不同的用途或项目进行分类管理，提高管理效率。在"分组"标签页中，你可以创建新的分组并将服务器添加到相应的分组中。

生产环境优化建议

当你准备将MCPHub部署到生产环境时，考虑以下优化建议：

1. 使用专用数据库：考虑使用独立的数据库服务器，而不是Docker Compose中内置的数据库
2. 启用HTTPS：配置SSL证书，确保数据传输安全
3. 设置定期备份：定期备份数据库和配置文件，防止数据丢失
4. 配置监控：使用Prometheus等工具监控MCPHub的运行状态
5. 调整资源限制：根据实际需求调整Docker容器的CPU和内存限制

问题排查技巧：常见问题解决

服务无法启动

如果服务无法启动，可以通过以下命令查看日志：

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

端口冲突

如果3000端口已被占用，可以修改.env文件中的MCPHUB_PORT参数，使用其他端口：

MCPHUB_PORT=3001

然后重新启动服务：

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

数据库连接问题

如果遇到数据库连接问题，请检查DB_URL环境变量是否正确配置，确保数据库服务已正常启动。

学习路径图

为了帮助你进一步掌握MCPHub，以下是推荐的学习资源：

• 官方文档：docs/configuration/docker-setup.mdx
• 配置示例：examples/mcp_settings_with_env_vars.json
• API参考：docs/api-reference/introduction.mdx
• 开发指南：docs/development/getting-started.mdx

通过本指南，你已经掌握了MCPHub的基本部署和使用方法。随着你对MCPHub的深入了解，你将能够充分利用其强大功能，实现高效的服务器管理和资源整合。