# 本地部署、一键安装、分组路由：MCPHub 重塑 MCP 服务器体验

MCPHub 是一个自托管的 MCP 网关与管理平台，用于连接、组织、控制和运行 MCP 服务器，并提供一键安装、分组路由和热插拔配置。

Canonical: https://samanhappy.com/zh/writing/group-routing
Language: zh-CN
作者: 青扬
最后更新: 2025-03-28


## 概述

现代 AI 应用场景中，将大模型（LLM）与各种数据源和工具无缝对接，往往需要手动编写大量胶水代码，并且无法快速复用。MCP（Model Context Protocol）协议由 Anthropic 在 2024 年开源，旨在提供类似"USB-C"接口般的标准化通信方式，简化 AI 助手与内容仓库、业务系统等的集成流程。然而，MCP 服务器部署常常需要大量环境依赖、手动配置及持续运行，开发者常因安装和配置耗费大量时间和精力。MCPHub 是一个自托管的 MCP 网关与管理平台，通过直观的 Web UI、Docker 镜像和热插拔配置，连接、组织、控制和运行多个 MCP 服务器。

## MCPHub 是什么

### MCP 协议简介

Model Context Protocol（MCP）是一种开放标准，类似"USB-C"接口，为 AI 助手与内容仓库、业务系统和第三方服务之间提供统一通信协议。它支持 stdio 与 SSE 两种通信方式，既能满足实时流式数据交换，也可用于批量任务。2024 年由 Anthropic 团队开源发布后，MCP 已在各类 AI 客户端（如 Claude Desktop）中得到应用，成功实现与 GitHub、Slack、网页自动化工具等的无缝对接。

### MCPHub 项目概览

MCPHub 是一个自托管的 MCP 网关与管理平台，内置 MCP 服务器市场实现一键安装。前端基于 React、Vite 和 Tailwind CSS 构建，后端兼容任意使用 npx 或 uvx 命令启动的 MCP 服务器。它通过一个集中式 Dashboard 实时展示各服务器的运行状态，并支持在运行时热插拔增删改服务器配置，无需停机维护。支持分组式访问控制，可以通过独立的 SSE 端点访问不同的 MCP 服务器组合，管理员可灵活定义不同团队或环境的权限策略。官方提供 Docker 镜像，仅需一条命令即可快速启动本地或云端服务。

![MCPHub 控制面板](/blog/images/dashboard.zh.png)

## 为什么要使用 MCPHub

### 1. 复杂的环境依赖与配置

- MCP 服务器常依赖 Node.js、Python 等多种运行时，需手动维护大量命令、参数和环境变量。
- MCPHub 内置 MCP 服务器市场，包含众多常用 MCP 服务器，支持一键安装和自动配置，简化了环境搭建过程。
- 通过 Docker 部署，MCPHub 可在任何支持 Docker 的平台上运行，避免了环境不一致的问题。

![MCPHub 市场](/blog/images/market.zh.png)

### 2. 持续运行的服务压力

- MCP 要求长连接服务常驻内存，重启或升级时需要人工干预，缺乏弹性。
- 借助 Docker 容器化部署，MCPHub 可快速重建环境，享受容器带来的弹性与隔离优势。

### 3. 路由与分组管理缺乏统一视图

- 传统方式下，很难可视化地将不同 MCP 服务按场景分类，容易造成 token 浪费和工具选择精度下降。
- MCPHub 支持动态创建分组（如"地图检索"、"网页自动化"、"聊天"等），为每个分组生成独立的 SSE 端点，实现各类用例的隔离与优化。

![MCPHub 分组](/blog/images/group.zh.png)

## 如何使用 MCPHub

### 快速部署

```bash
docker run -p 3000:3000 samanhappy/mcphub
```

一条命令就可以在本地快速启动 MCPHub，默认监听 3000 端口。

MCPHub 使用 `mcp_settings.json` 保存所有服务器、分组和用户的配置。你可以创建一个 `mcp_settings.json` 文件，并将其挂载到 Docker 容器中，以便在重启时保留配置。

```json
{
  "mcpServers": {
    "amap": {
      "command": "npx",
      "args": ["-y", "@amap/amap-maps-mcp-server"],
      "env": {
        "AMAP_MAPS_API_KEY": "your-api-key"
      }
    },
    "time-mcp": {
      "command": "npx",
      "args": ["-y", "time-mcp"]
    },
    "sequential-thinking": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
    }
  }
}
```

然后挂载配置文件启动：

```bash
docker run -p 3000:3000 -v $(pwd)/mcp_settings.json:/app/mcp_settings.json samanhappy/mcphub
```

> 注意：首次运行时，MCPHub 会自动下载并安装所需的依赖包，可能需要一些时间。

### 访问控制台

启动后访问 `http://localhost:3000` 即可进入控制台。

> 默认用户名为 `admin`。首次启动时，如果未设置 `ADMIN_PASSWORD` 环境变量，系统将自动生成随机密码并输出到服务器日志中。登录后请及时修改密码以确保安全。

控制台提供了服务器管理、分组管理和市场管理等功能，你可以在这里查看所有已安装的 MCP 服务器、创建新的分组、添加或删除服务器等。

### 分组路由 & SSE 端点

#### 全局 SSE 端点

```
http://localhost:3000/sse
```

通过全局 SSE 端点可以访问所有已启用的 MCP 服务器。

#### 基于分组的 SSE 端点

除了全局 SSE 端点，MCPHub 还支持基于分组的 SSE 端点。你可以为每个分组创建独立的 SSE 端点，以便更好地管理和路由请求。

分组的 SSE 端点格式如下：

```
http://localhost:3000/sse/{groupId}
```

其中 `{groupId}` 是分组的唯一标识符，可以从控制台获取。

#### 使用分组路由

创建了路由分组后，我们就可以在任意支持 MCP 的客户端中使用这个分组的 SSE 端点了。比如在 `Cursor` 中，我们可以在配置文件中指定分组的 SSE 端点：

```json
{
  "mcpServers": {
    "mcphub": {
      "url": "http://localhost:3000/sse/a800bef7-c4c1-4460-9557-5f4404cdd0bd"
    }
  }
}
```

配置完成后，可以从 `Cursor` 中看到所有可用的 MCP 服务器工具列表。

![Cursor 中的 MCP 配置](/blog/images/cursor-mcp.png)

然后，我们可以测试一下，比如输入：深度思考一下，帮我制定一个五一假期从南京出发的自驾行出游计划，要求避开拥堵路线，结合天气情况，并且可以体验到不同的自然风光。

![Cursor 中的测试输入](/blog/images/cursor-query.png)

接着可以看到，`Cursor` 在运行过程中调用了多个工具。

![Cursor 中的工具调用](/blog/images/cursor-tools.png)

可以看到，`Cursor` 通过调用 `amap` 和 `sequential-thinking` 两个服务器，成功生成了一个五一假期的自驾游行程方案，并且避开了拥堵路线，结合了天气情况。

## 结语

MCPHub 将本地部署、一键安装、分组路由和可视化管理融为一体，以简洁而强大的设计，彻底解决了 MCP 服务器的部署、配置与运维难题。无论是追求快速验证的开发者，还是需要稳定可靠 AI 工具链的企业用户，都能通过 MCPHub 专注于核心业务与创新，而无需被底层细节所困扰。

尽管目前各家平台都在陆续推出各类 MCP 云服务，但在数据隐私、合规性和定制化需求日益增长的背景下，MCPHub 仍然是一个值得关注的本地部署解决方案。

MCPHub 只是我一时兴起开发的小项目，没想到竟收获了这么多关注，非常感谢大家的支持！目前 MCPHub 还有不少地方需要优化和完善，我也专门建了个交流群，方便大家交流反馈。如果你也对这个项目感兴趣，欢迎一起参与建设！项目地址为：https://github.com/samanhappy/mcphub。