游乐游手机版
首页/AI热点日报/热点详情

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

类型:热点整理2026-07-11
MCPHub作为本地化MCP集成平台,可替代阿里云百炼,避免工具链锁定、数据外泄和成本突变风险。支持Docker部署、集中管理控制台、分组访问控制及JWT认证,实现多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大模型管理平台吧!

来源:https://www.53ai.com/news/zhinengyingjian/2025051818496.html

相关热点

继续查看同栏目近期热点。

延伸阅读

补充最近整理过的热点入口。