5分钟高效部署MCPHub：零基础也能掌握的Docker部署指南

MCPHub作为一款统一的中心服务器，能够将多个MCP服务器整合到单一的SSE端点，实现高效的服务器管理和资源整合。本文将为您提供一种简单快速的Docker一键安装方法，即使是新手也能在5分钟内完成部署，轻松掌握这一强大工具的使用。

核心价值解析：为什么选择MCPHub

在现代服务器管理中，面对众多分散的MCP服务器，管理效率和资源整合成为关键挑战。MCPHub应运而生，它通过将多个MCP服务器整合到单一的SSE端点，为用户带来了诸多核心价值。

首先，MCPHub实现了服务器的集中化管理，让管理员能够在一个统一的界面上监控和管理所有MCP服务器，极大地提高了管理效率。其次，它优化了资源分配，通过智能路由等功能，确保资源得到最合理的利用。再者，MCPHub提供了丰富的功能扩展，满足不同场景下的需求。

环境适配指南：部署前的准备工作

在开始部署MCPHub之前，确保您的系统满足以下环境要求，以保证部署过程顺利进行。

系统要求

• 操作系统：Linux、Windows或macOS均可，但推荐使用Linux系统以获得最佳性能。
• Docker版本：Docker 20.10.0及以上。
• Docker Compose版本：Docker Compose 2.0.0及以上。

安装Docker和Docker Compose

如果您的系统尚未安装Docker和Docker Compose，可以按照以下步骤进行安装。

对于Ubuntu系统，打开终端并执行以下命令：

sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

对于CentOS系统，执行以下命令：

sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install docker-ce docker-ce-cli containerd.io docker-compose-plugin

安装完成后，启动Docker服务并设置开机自启：

sudo systemctl start docker
sudo systemctl enable docker

如何确认Docker和Docker Compose安装成功？您可以分别执行docker --version和docker compose version命令，如果能显示相应的版本信息，则说明安装成功。

可视化部署流程：一步到位的安装步骤

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

这个命令会自动拉取所需的Docker镜像，并在后台启动PostgreSQL数据库和MCPHub应用服务。

3. 验证部署

部署完成后，打开浏览器，访问http://localhost:3000。如果看到MCPHub的登录界面，则说明部署成功。

使用默认管理员账户（用户名：admin，密码：admin）登录后，将进入MCPHub的仪表盘。

功能探索地图：MCPHub的强大功能

MCPHub提供了丰富的功能，让您能够轻松管理和扩展MCP服务器。

仪表盘

仪表盘是MCPHub的核心界面，展示了服务器总数、在线服务器、离线服务器和连接中服务器的状态，以及最近的服务器列表。通过仪表盘，您可以快速了解整个系统的运行状况。

服务器管理

在服务器管理页面，您可以添加、编辑、禁用和删除服务器。通过直观的界面，轻松管理所有MCP服务器。

分组管理

分组管理功能允许您将服务器进行分组，便于更好地组织和管理服务器资源。您可以根据不同的业务需求创建多个分组，并将服务器分配到相应的分组中。

市场

市场是发现和安装新的MCP服务器的地方。在这里，您可以浏览各种类型的服务器，查看详细信息，并一键安装所需的服务器。

故障诊断手册：常见问题及解决方法

服务无法启动

症状：执行启动命令后，服务没有正常启动。 原因：可能是Docker镜像拉取失败、端口冲突或配置文件错误等。 对策：首先，通过docker compose -f docker-compose.db.yml logs -f命令查看日志，确定具体错误原因。如果是镜像拉取失败，可以尝试重新拉取镜像；如果是端口冲突，可以修改配置文件中的端口映射；如果是配置文件错误，检查配置文件中的参数是否正确。

数据库连接问题

症状：MCPHub应用无法连接到PostgreSQL数据库。 原因：数据库服务未启动、数据库连接信息配置错误或数据库用户权限不足等。 对策：检查数据库服务是否正常运行，执行docker ps命令查看数据库容器状态。如果数据库服务未启动，执行docker compose -f docker-compose.db.yml start postgres命令启动数据库服务。检查配置文件中的数据库连接信息，确保DB_URL参数正确。如果是数据库用户权限问题，登录数据库并为用户授予相应的权限。

登录问题

症状：使用默认管理员账户登录时提示用户名或密码错误。 原因：可能是密码被修改或账户被锁定。 对策：如果密码被修改，您可以通过修改数据库中的用户表来重置密码。如果账户被锁定，等待一段时间后再尝试登录，或者通过数据库解锁账户。

进阶学习路径图

为了帮助您更好地学习和使用MCPHub，我们为您提供了以下进阶学习路径：

入门阶段

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

中级阶段

• 深入了解MCPHub的架构：docs/development/architecture.mdx
• 学习如何开发自定义插件：docs/development/contributing.mdx

高级阶段

• 参与MCPHub社区讨论，与其他开发者交流经验。
• 阅读MCPHub的源代码，深入理解其内部实现机制。

通过本教程，您已经成功部署了MCPHub服务，并对其主要功能有了一定的了解。现在，您可以开始添加和管理您的MCP服务器，享受统一管理带来的便利。如果您在使用过程中遇到任何问题，可以参考官方文档或社区论坛获取帮助。