Claude MCP Manager

Claude MCP经理

macOS的命令行工具，用于定义、管理和在不同组之间切换 mcpServers Claude Desktop应用程序的配置文件。

目标

Claude桌面应用程序存储其配置，包括 mcpServers 端点，位于JSON文件中 ~/Library/Application Support/Claude/claude_desktop_config.json此工具允许您定义单个服务器配置并将其分组到命名配置文件中（例如，“默认”、“工作”、“实验”）。激活配置文件会更新 mcpServers 在主Claude配置文件中使用该配置文件中定义的服务器块，自动重启Claude以应用更改。通过分离服务器定义并利用环境变量作为机密（请参阅“它是如何工作的”），您可以轻松地共享服务器配置或将配置文件提交到版本控制，而不会暴露敏感的凭据。

快速安装（推荐）

在macOS终端中运行以下命令：

curl -fsSL https://raw.githubusercontent.com/BLTGV/claude-mcp-manager/main/install.sh | sh

这将下载并执行安装程序脚本，该脚本处理依赖性检查、复制文件和设置命令行工具。

需求

• macOS： 该脚本依赖于macOS特定的路径和命令(pgrep, kill, open). 它不适用于Windows或Linux。
• jq： 脚本使用 jq 用于JSON处理。通过Homebrew安装： brew install jq.
• 猛击： 需要一个相当现代的bash版本（>=3.2）来实现正则表达式匹配等功能(=~).标准的macOS bash就足够了。

安装

手动安装

1. 克隆存储库或下载源代码。
2. 导航到终端中的项目目录。
3. 使安装程序可执行： chmod +x install.sh
4. 运行安装程序：

   ./install.sh

- 脚本将尝试安装到 /usr/local/lib/claude-mcp-manager 并在中创建符号链接 /usr/local/bin。这可能需要 sudo 如果你没有写权限。 - 如果 /usr/local 不可写，它将回退到 $HOME/.local/lib 和 $HOME/.local/bin. - 如果选择了以下选项，安装程序将通知您 bin 目录不在您的 $PATH 并提供添加说明。

原理

• 配置目录： 将所有数据存储在 ~/.config/claude/.
• 服务器目录： 单个服务器定义存储为 .json 文件在 ~/.config/claude/servers/.
• 配置文件目录： 包含服务器名称列表的配置文件存储为 .json 文件在 ~/.config/claude/profiles/.

- 每个配置文件看起来像： {\"servers\": [\"server1_name\", \"server2_name\"]}

• 目标文件： 脚本修改了 mcpServers Claude官方配置文件中的key： ~/Library/Application Support/Claude/claude_desktop_config.json.
• 秘密(.env 文件）： 您可以将敏感值（如API密钥）存储在 ~/.config/claude/.env服务器定义文件可以使用占位符引用这些文件，例如 {{ENV:YOUR_API_KEY}} 或 {{DOTENV:YOUR_API_KEY}}。当配置文件被激活时，这些问题就会得到解决。
• 追踪(loaded 文件）： 脚本跟踪 *名字* 中当前活动的配置文件 ~/.config/claude/loaded.
• 备份(last.json): 在应用新配置文件之前，脚本会保存 *当前的* mcpServers 从目标文件到 ~/.config/claude/last.json，允许使用轻松回滚 last 命令。
• 首次运行： 安装程序正在运行 claude-mcp-manager server list 以确保在成功安装后创建配置目录。

用法

claude-mcp-manager 

主要命令

• `

：激活指定的配置文件。读取配置文件中列出的服务器定义，解析机密，构造 mcpServers` block，备份主配置中的当前块，写入新块，并重新启动Claude。

• last：恢复 mcpServers 上次配置文件激活之前处于活动状态的块（来自 last.json)并重新启动克劳德。
• server ：管理服务器定义。跑 claude-mcp-manager server help 了解详情。
• profile ：管理配置文件。跑 claude-mcp-manager profile help 了解详情。

服务器子命令(claude-mcp-manager server ...)

• list：列出在中找到的可用服务器定义文件 ~/.config/claude/servers/.
• show ：显示指定服务器定义文件的JSON内容。
• `add --file

：通过从以下位置复制内容来添加新的服务器定义 `.

• add --json '{\"key\":\"value\"}'：使用提供的JSON字符串添加新的服务器定义。
• edit ：在您的 $EDITOR （或默认为vim/nano）。
• remove ：删除指定的服务器定义文件（提示确认）。
• extract [--profile ]：阅读 mcpServers 从主Claude配置块中，将每个服务器另存为单独的文件 ~/.config/claude/servers/。（可选）创建或更新指定的配置文件 `` 列出所有提取的服务器。

配置文件子命令(claude-mcp-manager profile ...)

• list：列出在中找到的可用配置文件 ~/.config/claude/profiles/.
• show ：列出指定配置文件中包含的服务器名称，并指示相应的服务器定义文件是否存在。
• create ：创建一个新的空配置文件。
• copy ：将现有配置文件复制到新名称。
• edit ：在您的 $EDITOR （或默认为vim/nano）手动编辑服务器列表。
• `add

：将一个或多个服务器名称添加到指定配置文件的 "servers"` 阵列。

• `remove

：从指定的配置文件中删除一个或多个服务器名称 "servers"` 阵列。

• delete ：删除指定的配置文件（提示确认）。

选项

• help, -h, --help：显示主要帮助消息。
• version, -v：显示脚本版本。

致谢

壳体完井（可选）

选项卡补全可用于Bash和Zsh shell。

首先，确保 claude-mcp-manager 已安装并可在PATH中访问。

猛击

1. 安装 bash-completion@2: 如果还没有，请使用Homebrew安装最新的bash完成系统：

   brew install bash-completion@2

1. 增添 .bash_profile: 按照打印的说明进行操作 brew info bash-completion@2 将必要的行添加到您的 ~/.bash_profile （或 ~/.bashrc).它通常看起来像这样：

   # Add the following line (or similar) to ~/.bash_profile
   export BASH_COMPLETION_COMPAT_DIR="$(brew --prefix)/etc/bash_completion.d"
   [[ -r "$(brew --prefix)/etc/profile.d/bash_completion.sh" ]] && . "$(brew --prefix)/etc/profile.d/bash_completion.sh"

1. 生成并安装脚本： 运行以下命令以生成完成脚本并将其放置在正确的目录中：

   # Determine the completion directory
   COMPLETION_DIR="$(brew --prefix)/etc/bash_completion.d"
   # Ensure the directory exists
   mkdir -p "$COMPLETION_DIR"
   # Generate the script
   claude-mcp-manager completion bash > "${COMPLETION_DIR}/claude-mcp-manager"

1. 重新加载外壳： 打开新的终端窗口或运行 source ~/.bash_profile.

原有的质量

Zsh具有内置的补全支持。

1. 确保 compinit: 确保你的 ~/.zshrc 文件包括 autoload -U compinit && compinit 某处（通常在开头或结尾附近）。
2. 选择完成目录： Zsh补全通常存储在您的 $fpath 变量。一个常见的用户特定位置是 ~/.zsh/completion。如果它不存在，请创建它：

   mkdir -p ~/.zsh/completion

1. 将目录添加到 fpath: 确保此目录已添加到您的Zsh函数路径中 ~/.zshrc *之前* 召唤 compinit:

   # Add near the top of ~/.zshrc
   fpath=(~/.zsh/completion $fpath)

   # ... other zsh config ...

   # Ensure compinit is loaded
   autoload -U compinit && compinit

1. 生成并安装脚本： 运行以下命令以生成完成脚本。请注意，文件名以下划线开头(_):

   claude-mcp-manager completion zsh > ~/.zsh/completion/_claude-mcp-manager

1. 重新加载外壳： 打开新的终端窗口或运行 source ~/.zshrc.

安装后，您应该能够使用选项卡完成命令、子命令、配置文件名称和服务器名称。

卸载

要卸载，请运行以下命令：

claude-mcp-manager uninstall

这将删除脚本和命令符号链接。它将首先要求确认。

向 *也* 删除配置目录(~/.config/claude)，其中包含您的所有配置文件、服务器定义、日志和 .env 文件（可能包含机密），使用：

claude-mcp-manager uninstall --remove-config

警告： 删除配置目录是永久性的，需要单独确认。