MCPHub本地搭建MCP平台完整教程

通过MCPHub，构建安全可控的AI大模型管理平台，实现本地化部署与统一管理。

阿里云百炼MCP平台虽便捷易用，但潜在风险不容忽视：三大隐患分别为生态封闭（工具链锁定）、数据安全（敏感信息需经第三方流转）、成本风险（未来收费政策可能突变）。MCPHub作为本地化替代方案，助您打造真正可控的MCP集成管理平台。

一、百炼MCP平台潜在风险分析

• 工具链锁定风险：生态封闭性强，迁移成本高。
• 安全隐患：敏感数据必须流经第三方平台，存在泄露风险。
• 成本架构突变风险：未来收费政策变化可能增加预算压力。

二、MCPHub功能介绍

MCPHub是一个统一的MCP（Model Context Protocol，模型上下文协议）服务器聚合平台，能够根据业务场景将多个MCP服务器聚合至不同的流式HTTP（SSE）端点。

• 集中式管理控制台：通过简洁的Web UI实时监控所有服务器的运行状态与性能指标。
• 基于分组的访问控制：支持自定义分组，灵活管理服务器访问权限。
• 安全认证机制：内置用户管理系统，基于JWT和bcrypt，实现精细的角色权限控制。

三、MCPHub本地部署

MCPHub支持Docker方式部署，仅需拉取镜像并运行容器即可：

docker pull samanhappy/mcphub:0.5.4-full
docker run -d --restart unless-stopped --name mcphub -p 10086:3000 samanhappy/mcphub:0.5.4-full

容器启动后，通过浏览器访问 http://服务器IP:10086 即可进入MCPHub管理界面。默认管理员账户为 admin / admin123。

小提示：首次登录后请尽快修改默认密码，以保障系统安全。

四、管理本地MCP服务

4.1 本地MCP服务介绍

下面以两个MCP服务为例进行说明：

• MCP服务一：Coze联网检索（参考《零成本搭建联网智能体：Dify+Coze改造MCP》）
  需提供两个参数：search_content（检索文本）和 n（返回网页数量）。
• MCP服务二：本地数据库查询
  两个接口：查询某天销售数据（参数date_start）、查询商品信息（参数item_name）。

4.2 启动本地MCP服务

在同一台服务器上启动MCPHub和这两个服务。先创建 docker-compose.yml 文件，内容如下：

version: '3'

services:
  mcphub:
    image: samanhappy/mcphub:0.5.4-full
    container_name: mcphub
    restart: unless-stopped
    ports:
      - 10086:3000
    networks:
      - default
      - local_network

  cozemcp:
    image: cozemcp:v0.1
    restart: always
    networks:
      - local_network
      - default

  fastapimcp:
    image: fastapimcp:v0.1
    restart: always
    networks:
      - local_network

networks:
  local_network:
    driver: bridge
    internal: true  

切换至该文件所在目录（例如 mcphubrun），并执行：

cd mcphubrun/
docker compose up -d

小提示：这里使用 local_network 作为内部网络，可防止MCP服务被外部直接访问，仅允许MCPHub调用，从而提升安全性。

4.3 MCPHub添加本地MCP服务

在 服务器 页面，点击 添加服务器，依次添加两个MCP服务。添加成功后，状态显示为 在线 即表示配置生效。

五、大模型测试

5.1 Cherry Studio 测试

在 设置 → MCP服务器 → 添加服务器，选择 服务器发送事件（SSE），在URL栏填入您部署的MCPHub地址（如 http://服务器IP:10086）。

在 工具 标签页中查看可用的工具列表。

随后可在聊天对话中进行功能测试：

• Coze联网检索测试
• 本地数据库查询测试

5.2 Dify 测试

六、常见问题

Q1：部署后无法访问MCPHub页面？
A：请检查防火墙是否放行了端口 10086，并使用 docker ps 命令确认容器运行状态。

Q2：如何修改MCPHub的默认密码？
A：登录后可在管理控制台的 用户管理 中修改，或通过API接口进行更改。

Q3：添加MCP服务时提示连接失败？
A：请确认MCP服务已正常启动，并确保MCPHub所在容器可以访问该服务的地址和端口（可通过网络连通性测试验证）。

总结：MCPHub让您轻松实现多个MCP服务的统一管理，结合本地部署方案，完全掌控数据与工具链，是替代百炼MCP平台的安全高效选择。立即动手，搭建属于您的专属AI大模型管理平台吧！

你是一名 AI 行业编辑，请围绕下面这条热点输出一份资讯解读：
热点：MCPHub本地搭建MCP平台完整教程要求：
1. 先用一句话解释这条热点在讲什么
2. 再总结它为什么重要
3. 说明会影响哪些 AI 产品或内容方向
4. 最后给出 3 个适合资讯站使用的标题