Claude Code MCP Manager

跨平台桌面应用程序，用于管理 Claude Code MCP 服务器。适用于 Windows、macOS 和 Linux。

停止手动编辑 JSON 配置文件。Claude Code MCP Manager 提供了一个可视界面来配置 MCP 服务器，切换配置文件，并生成启动 Claude Code 所需的 shell 命令。

平台支持

• ✅ Windows 10/11 (PowerShell, Windows Terminal, CMD)
• ✅ macOS 11.0+ (zsh, bash)
• ✅ Linux (bash, zsh, 现代发行版)

为什么使用这个？

手动管理 MCP 服务器配置既繁琐又容易出错。Claude Code MCP Manager 解决了这些问题：

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

主要特性

• ✅ 跨平台 – 在 Windows、macOS 和 Linux 上运行，并检测平台原生 shell
• 📁 项目感知 – 选择工作目录并维护最近项目的列表
• 🔧 服务器管理界面 – 添加、编辑、删除、验证并按类别筛选 MCP 服务器
• 🎭 配置文件 – 保存启用服务器的组合以快速切换上下文
• 📋 命令生成 – 复制可立即运行的 shell 命令以启动 Claude Code
• 💾 持久偏好设置 – 切换主题、保存配置文件、验证缓存和自动配置备份

快速开始

安装

所有平台：

pip install -r requirements.txt

Windows （额外依赖项）：

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

管理器为您生成可复制的命令，以便手动运行。这种方法在各个平台上更可靠，并且让您完全控制 Claude Code 的启动位置和方式。

要求

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

文档

所有项目文档位于 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 服务器所需）
• 您已从管理器复制整个命令

配置问题

配置存储在：

• Windows: %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 许可证下。