diff --git a/doc/intro2.md b/doc/intro2.md index b5ecb23..8d30db8 100644 --- a/doc/intro2.md +++ b/doc/intro2.md @@ -4,8 +4,6 @@ 现代 AI 应用场景中，将大模型（LLM）与各种数据源和工具无缝对接，往往需要手动编写大量胶水代码，并且无法快速复用​。MCP（Model Context Protocol）协议由 Anthropic 在 2024 年开源，旨在提供类似“USB‑C”接口般的标准化通信方式，简化 AI 助手与内容仓库、业务系统等的集成流程​。然而，MCP 服务器部署常常需要大量环境依赖、手动配置及持续运行，开发者常因安装和配置耗费大量时间和精力​。MCPHub 作为一款开源的一站式聚合平台，通过直观的 Web UI、Docker 镜像和热插拔配置，实现本地或容器里的“一键安装”与“分组路由”，大幅降低 MCP 服务器的使用门槛和运维成本​。 -尽管目前各家平台都在陆续推出各类 MCP 云服务，但在数据隐私、合规性和定制化需求日益增长的背景下，MCPHub 仍然是一个值得关注的本地部署解决方案​。本文将深入探讨 MCPHub 的设计理念、使用场景和技术架构，帮助开发者快速上手并充分利用这一强大工具​。 - ## MCPHub 是什么 ### MCP 协议简介 @@ -14,7 +12,7 @@ Model Context Protocol（MCP）是一种开放标准，类似“USB‑C”接口 ### MCPHub 项目概览 -MCPHub 是一个统一的 MCP 服务器聚合平台，内置 MCP 服务器市场实现一键安装。前端基于 React、Vite 和 Tailwind CSS 构建，后端兼容任意使用 npx 或 uvx 命令启动的服务器。它通过一个集中式 Dashboard 实时展示各服务器的运行状态，并支持在运行时热插拔增删改服务器配置，无需停机维护。支持分组式访问控制，可以通过独立的 SSE 端点访问不同的 MCP 服务器组合，管理员可灵活定义不同团队或环境的权限策略。官方提供 Docker 镜像，仅需一条命令即可快速启动本地或云端服务。 +MCPHub 是一个统一的 MCP 服务器聚合平台，内置 MCP 服务器市场实现一键安装。前端基于 React、Vite 和 Tailwind CSS 构建，后端兼容任意使用 npx 或 uvx 命令启动的 MCP 服务器。它通过一个集中式 Dashboard 实时展示各服务器的运行状态，并支持在运行时热插拔增删改服务器配置，无需停机维护。支持分组式访问控制，可以通过独立的 SSE 端点访问不同的 MCP 服务器组合，管理员可灵活定义不同团队或环境的权限策略。官方提供 Docker 镜像，仅需一条命令即可快速启动本地或云端服务。 ![MCPHub 控制面板](../assets/dashboard.zh.png) @@ -23,10 +21,10 @@ MCPHub 是一个统一的 MCP 服务器聚合平台，内置 MCP 服务器市场 ### 1. 复杂的环境依赖与配置 - MCP 服务器常依赖 Node.js、Python 等多种运行时，需手动维护大量命令、参数和环境变量。 -- MCPHub 内置 MCP 服务器市场，包含多种常用 MCP 服务器，支持一键安装和自动配置，简化了环境搭建过程。 +- MCPHub 内置 MCP 服务器市场，包含众多常用 MCP 服务器，支持一键安装和自动配置，简化了环境搭建过程。 - 通过 Docker 部署，MCPHub 可在任何支持 Docker 的平台上运行，避免了环境不一致的问题。 - ![MCPHub 市场](../assets/market.zh.png) +![MCPHub 市场](../assets/market.zh.png) ### 2. 持续运行的服务压力 @@ -35,10 +33,10 @@ MCPHub 是一个统一的 MCP 服务器聚合平台，内置 MCP 服务器市场 ### 3. 路由与分组管理缺乏统一视图 -- 传统方式下，很难可视化地将不同 MCP 服务按场景分类，容易造成请求混淆和性能瓶颈。 +- 传统方式下，很难可视化地将不同 MCP 服务按场景分类，容易造成 token 浪费和工具选择精度下降。 - MCPHub 支持动态创建分组（如“地图检索”、“网页自动化”、“聊天”等），为每个分组生成独立的 SSE 端点，实现各类用例的隔离与优化。 - ![MCPHub 分组](../assets/group.zh.png) +![MCPHub 分组](../assets/group.zh.png) ## 如何使用 MCPHub @@ -48,7 +46,7 @@ MCPHub 是一个统一的 MCP 服务器聚合平台，内置 MCP 服务器市场 docker run -p 3000:3000 samanhappy/mcphub ``` -这样就可以在本地快速启动 MCPHub，默认监听 3000 端口。 +一条命令就可以在本地快速启动 MCPHub，默认监听 3000 端口。 MCPHub 使用`mcp_settings.json`保存所有服务器、分组和用户的配置。你可以创建一个 `mcp_settings.json` 文件，并将其挂载到 Docker 容器中，以便在重启时保留配置。 @@ -115,7 +113,7 @@ http://localhost:3000/sse http://localhost:3000/sse/{groupId} ``` -其中 `{groupId}` 是分组的唯一标识符，可以从控制台获取。比如我创建了一个名为 `map` 的分组，选择了 `amap` 和 `sequential-thinking` 两个服务器，那么可以通过以下 URL 访问这个分组的 SSE 端点： +其中 `{groupId}` 是分组的唯一标识符，可以从控制台获取。比如我在上面的截图中创建了一个名为 `map` 的分组，选择了 `amap` 和 `sequential-thinking` 两个服务器，那么可以通过以下 URL 访问这个分组的 SSE 端点： ``` http://localhost:3000/sse/a800bef7-c4c1-4460-9557-5f4404cdd0bd @@ -135,17 +133,17 @@ http://localhost:3000/sse/a800bef7-c4c1-4460-9557-5f4404cdd0bd } ``` -配置完成后，可以从 `Cursor` 中看到所有可用的 MCP 服务器，并可以直接使用它们。 +配置完成后，可以从 `Cursor` 中看到所有可用的 MCP 服务器工具列表。 -![Cursor 中的 MCPHub 分组](../assets/cursor-mcp.png) +![Cursor 中的 MCP 配置](../assets/cursor-mcp.png) 然后，我们可以测试一下，比如输入：深度思考一下，帮我制定一个五一假期从南京出发的自驾行出游计划，要求避开拥堵路线，结合天气情况，并且可以体验到不同的自然风光。 -![Cursor 中的 MCPHub 分组](../assets/cursor-query.png) +![Cursor 中的测试输入](../assets/cursor-query.png) 接着可以看到，`Cursor` 在运行过程中调用了多个工具。 -![Cursor 中的 MCPHub 分组](../assets/cursor-tools.png) +![Cursor 中的工具调用](../assets/cursor-tools.png) 最终生成结果如下： @@ -221,11 +219,13 @@ http://localhost:3000/sse/a800bef7-c4c1-4460-9557-5f4404cdd0bd 既避开了主要拥堵路段，又能欣赏到不同的自然风光。 ``` -结果中可以看到，`Cursor` 通过调用 `amap` 和 `sequential-thinking` 两个服务器，成功生成了一个五一假期的自驾游行程方案，并且避开了拥堵路线，结合了天气情况。但是细心的同学可能发现，计划中的开始时间是 4 月 29 日，而今年的五一假期是 5 月 1 日开始的，产生偏差的原因是 `sequential-thinking` 使用了错误的假期时间。如何解决这个问题呢？我们可以尝试在分组中添加支持搜索的 MCP 服务器，这样就可以在查询时自动纠正错误的假期时间了，具体就不在这里展开了。 +可以看到，`Cursor` 通过调用 `amap` 和 `sequential-thinking` 两个服务器，成功生成了一个五一假期的自驾游行程方案，并且避开了拥堵路线，结合了天气情况。但是细心的同学可能发现，计划中的开始时间是 4 月 29 日，而今年的五一假期是 5 月 1 日开始的，产生偏差的原因是 `sequential-thinking` 使用了错误的假期时间。如何解决这个问题呢？我们可以尝试在分组中添加支持搜索的 MCP 服务器，这样就可以在查询时自动纠正错误的假期时间了，具体就不在这里展开了。 ## 结语 -MCPHub 将本地部署、一键安装、分组路由和可视化管理融为一体，以简洁而强大的设计，彻底解决了 MCP 服务器的部署、配置与运维难题。无论是追求快速验证的开发者，还是需要稳定可靠 AI 工具链的企业用户，都能通过 MCPHub 专注于核心业务与创新，而无需被底层细节所困扰。立即体验 MCPHub，开启高效易用的 MCP 服务器管理之旅！ +MCPHub 将本地部署、一键安装、分组路由和可视化管理融为一体，以简洁而强大的设计，彻底解决了 MCP 服务器的部署、配置与运维难题。无论是追求快速验证的开发者，还是需要稳定可靠 AI 工具链的企业用户，都能通过 MCPHub 专注于核心业务与创新，而无需被底层细节所困扰。 + +尽管目前各家平台都在陆续推出各类 MCP 云服务，但在数据隐私、合规性和定制化需求日益增长的背景下，MCPHub 仍然是一个值得关注的本地部署解决方案​。 MCPHub 只是我一时兴起开发的小项目，没想到竟收获了这么多关注，非常感谢大家的支持！目前 MCPHub 还有不少地方需要优化和完善，我也专门建了个交流群，方便大家交流反馈。如果你也对这个项目感兴趣，欢迎一起参与建设！项目地址为：https://github.com/samanhappy/mcphub。