
MCPHub-Desktop
本地一键管理 MCP 服务器、Skills 和 RAG 知识库
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-02 · 当前星标 ★ 1061
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Windows / macOS / Linux 桌面系统
- 从 GitHub Releases 页面下载对应平台的安装包
- 普通用户无需预装 Node、UV、Bun,运行时随包分发
- 如需自行构建,需先获取源码并具备 bash 脚本执行环境
安装与启动步骤
-
1下载安装包
打开项目 GitHub Releases 页面,按自己的操作系统下载对应安装包,注意与平台架构匹配。
-
2安装并启动应用
运行安装包完成安装,安装方式为按用户安装、不提权;装好后手动打开 MCPHub Desktop。
-
3确认首次启动正常
少数 Windows 机器从安装程序直接打开会闪退,手动重新打开一次通常即可正常进入主界面。
-
4查看崩溃日志
若反复闪退,进入应用数据目录(mcphub.db 所在目录)查看 crash.log 并反馈给开发者。
-
5获取项目源码
开发者可克隆仓库,后续操作只在本项目目录内进行,不要改动 mcphub-origin 目录。
git clone https://github.com/skrstop/MCPHub-Desktop.git cd MCPHub-Desktop -
6准备运行时
首次构建前运行仓库内脚本,把随包分发的 Node / UV / Bun 运行时下载到指定目录。
bash scripts/download-runtimes.sh
如何确认成功
应用成功打开并显示主界面即安装成功;若闪退,检查应用数据目录下是否生成 crash.log。
常见问题
Q:Windows 安装后第一次打开闪退怎么办?
A:这是已知情况,多为从安装程序直接启动导致,手动重新打开一次应用通常即可恢复;仍失败则查看 crash.log。
Q:需要自己安装 Node、UV 或 Bun 吗?
A:不需要。运行时随包分发,位于项目 src-tauri/runtimes 目录;自行构建时才需执行下载运行时脚本。
Q:mcphub-origin 目录可以直接修改吗?
A:不可以。它是第三方项目 samanhappy/mcphub 的源码快照,仅用于比对与离线查阅,本项目代码只在 frontend、src-tauri、scripts、locales 等目录。
Q:配置和知识库数据保存在哪里?
A:全部保存在本机,配置、密钥与向量数据不上传远端;应用数据目录即 mcphub.db 与 crash.log 所在目录。
注意事项
- 仓库内 mcphub-origin 目录不属于本项目,严禁修改其中任何文件。
- Windows 安装为按用户安装(currentUser),不触发提权,可减少启动失败。
- 崩溃日志位置:Windows 为 %APPDATA%\app.mcphub.desktop\crash.log,macOS 为 ~/Library/Application Support/app.mcphub.desktop/crash.log,Linux 为 ~/.local/share/app.
- README 中依赖安装部分未给出具体命令,请以仓库实际脚本与文档为准。
核心亮点
- 用图形界面统一管理 MCP 服务器进程、配置和密钥,省去手动改 JSON 的麻烦
- 基于 Tauri 2,安装包小、资源占用低,比 Electron 方案更轻
- 所有数据本地存储、不依赖远端服务,隐私和可控性有保障
不足之处
- 项目处于早期阶段,570 星标,功能与稳定性仍在迭代
- 文档和社区生态相对薄弱,遇到问题可参考的资料有限
适用场景
- 本地开发多个 MCP 服务,需要集中启停和查看运行状态
- 搭建个人 RAG 知识库,管理向量数据与嵌入配置
- 统一存放和管理各类 AI Skills 与 API 密钥,避免散落各处
替代项目
Claude Desktop、Cherry Studio
上一篇:buywise-agent
下一篇:gov_AP
同类项目推荐
wrench-board
开源
让每个维修店都拥有顶级微焊接专家,随时指导维修。
A senior microsoldering technician, available to every repair shop from the seasoned···
cronalytics
开源
给 Hermes 智能体定时任务装上监控仪表盘,运行状态一目了然。
Hermes Agent plugin for cron analytics and observability. The dashboard for agentic ···
san
开源
12MB 单文件终端智能体,零依赖极速运行,全链路开放可定制
Open-source terminal agent runtime. Lean context, native speed, open all the way dow···
octomind
开源
即插即用的 Rust AI 智能体,快速部署到任何领域
Open-source AI coding agent and agent runtime: one binary, any model, MCP-native. Ru···
py-xiaozhi
开源
一套 Python 框架,把语音、多模态和硬件设备接成 AI 助手
Open-source AI assistant ecosystem with MCP integrations, multimodal workflows, IoT ···
alphaclaw
开源
免命令行,几分钟部署 OpenClaw,自动守护长期运行
The ultimate setup harness for OpenClaw. Deploy in minutes. Stay running for months.···
id-agent
开源
用更短 ID 省 token,让 AI 代理跑得更快更省钱。
Token efficient IDs for AI agents. UUID alternative for the agentic era.
zenith
开源
把多个AI智能体编排成团队,自动搞定长期复杂任务
Zenith: a continuous-improvement harness for long-running agent tasks. Turns Claude ···
pydantic-ai-rlm
开源
让任意 LLM 轻松处理超长上下文,省 token 又高效
Pydantic AI RLM - Handle Extremely Large Contexts with Any LLM Provider