Cc MCP Manager

克劳德代码MCP经理

](https://www.python.org/downloads/)  

跨平台 用于管理的桌面应用程序 克劳德代码 MCP服务器。适用于Windows、macOS和Linux。

停止手动编辑JSON配置文件。Claude Code MCP Manager为您提供了一个可视化界面，用于配置MCP服务器、在配置文件之间切换，以及生成准备运行的shell命令，以便使用您所需的服务器配置启动Claude Code。

平台支持

• ✅ 视窗 10/11（PowerShell、Windows终端、CMD）
• ✅ macOS 10.15+（zsh、bash）
• ✅ Linux （bash、zsh、现代发行版）

为什么使用这个？

手动管理MCP服务器配置既繁琐又容易出错。Claude Code MCP Manager通过以下方式解决了这个问题：

• 视觉界面 -不再手动编辑JSON文件或纠结于命令行语法
• 多项目支持 –在不同的项目配置之间快速切换
• 服务器验证 –启动前检查MCP服务器是否可用
• 配置文件管理 –保存和调用不同工作流的服务器组合
• 平台原生 –为PowerShell（Windows）或bash/zsh（macOS/Linux）生成命令

主要特点

• ✅ 跨平台 –适用于Windows、macOS和Linux，具有平台原生shell检测功能
• 📁 项目意识 –选择一个工作目录并维护最近的项目列表
• 🔧 服务器管理UI –按类别添加、编辑、删除、验证和过滤MCP服务器
• 🎭 档案 –保存已启用服务器的组合，以便快速切换上下文
• 📋 命令生成 –复制准备运行的shell命令以启动Claude Code
• 💾 持续偏好 –主题切换、保存的配置文件、验证缓存和自动配置备份

快速开始

安装

所有平台：

pip install -r requirements.txt

视窗 （其他依赖关系）：

pip install -r requirements-windows.txt

macOS/Linux （其他依赖关系）：

pip install -r requirements-unix.txt

跑步

python main.py

管理器将配置文件存储在 ~/.claude （Windows： %USERPROFILE%\.claude)并将日志写入 cc-launcher.log 在同一个目录中。

请注意： 系统托盘图标仅在桌面环境公开托盘支持时显示。在Linux上，这通常意味着在X11/Wayland下运行托盘小程序。当不可用时，应用程序将继续运行，不带托盘，并自动禁用该功能以用于未来的会话。

用法

1. 选择项目目录 –选择Claude Code应该运行的位置
2. 启用MCP服务器 –检查要使用的服务器
3. 复制命令 –该工具生成适用于平台的shell命令
4. 在终端中运行 –粘贴并执行命令

生成的命令将：

• 切换到项目目录
• 启动克劳德代码 --mcp-config 指向临时配置文件

管理器会生成复制就绪命令，供您手动运行。这种方法在跨平台上更可靠，并让您完全控制Claude Code的发布位置和方式。

需求

• Python 3.11+
• Tkinter（通常与Python捆绑在一起）
• psutil（通过安装 requirements.txt)
• Node.js和npm（用于MCP服务器）
• Claude Code CLI已安装并位于PATH中

文档

所有项目文件都保存在 docs/:

• product-overview.md –当前产品愿景、支持的工作流程和功能摘要。
• architecture.md –高级系统设计、模块职责和持久性模型。
• ui-guide.md –浏览界面，包括MCP服务器类别过滤器和启动控件。
• developer-guide.md –环境设置、编码模式、测试命令和贡献指南。
• testing.md –自动和手动测试覆盖率以及执行说明。
• changelog.md –各版本的主要变化。

故障排除

系统托盘图标未出现（Linux）

一些Linux桌面环境（尤其是GNOME 3.26+）不支持传统系统托盘图标。应用程序将检测到这一点，显示一次警告，并在没有托盘图标的情况下继续正常工作。

macOS上的权限错误

首次选择项目目录时，macOS可能会提示输入文件夹访问权限。授予允许应用程序访问您的项目文件的权限。

命令在终端中不起作用

确保：

• claude CLI已安装并位于PATH中
• 安装了Node.js和npm（MCP服务器需要）
• 您已从管理器复制了整个命令

配置问题

配置存储在：

• 视窗: %USERPROFILE%\.claude\
• macOS/Linux: ~/.claude/

检查 cc-launcher.log 在此目录中查看详细的错误消息。

贡献

欢迎投稿！请看 CONTRIBUTING.md 作为指导方针。

快速启动：

1. 安装依赖项 pip install -r requirements.txt （加上平台特定要求）
2. 运行完整的测试套件： python -m pytest tests/ -v
3. 看 docs/developer-guide.md 用于编码约定

许可证

该项目发布于 MIT许可证.