CC MCP Toggling

MCP服务器切换管理器

一个基于终端的用户界面工具，用于在Claude Code中管理MCP（模型上下文协议）服务器。可以轻松地开启/关闭服务器，无需手动编辑JSON配置文件。

特点/特性

• 基于curses的交互式终端用户界面
• 在活动状态和非活动状态之间切换MCP服务器
• 自动管理 ~/.claude.json 和 ~/.claude-toggled.json
• 彩色状态指示灯
• 键盘导航

要求

• Python 3.13（或 Python 3.6+）
• curses 模块（通常在类 Unix 系统上预装）

安装

1. 安装 Python 3.13

apt-get update && \
apt-get install -y software-properties-common curl && \
add-apt-repository -y ppa:deadsnakes/ppa && \
apt-get update && \
apt-get install -y python3.13 python3.13-venv python3.13-dev build-essential libssl-dev libffi-dev cargo && \
apt-get remove -y python3-blinker && \
curl -sS https://bootstrap.pypa.io/get-pip.py | python3.13

2. 克隆或下载此仓库

git clone https://github.com/Parham125/CC-MCP-Toggling
cd CC-MCP-Toggling

3. 使脚本可执行

chmod +x main.py

使用方法

直接运行

./main.py

创建一个全局命令

要在任何地方运行该工具，请在您的 PATH 中创建一个 bash 脚本：

1. 创建一个用于存放本地二进制文件的目录（如果该目录不存在）：

mkdir -p ~/.local/bin

1. 创建包装脚本（请将路径替换为您的实际安装路径）：

cat > ~/.local/bin/mcp-toggle  \[!NOTE\]（注：此标记通常用于表示以下内容为重要提示或注意事项）
> 替换 `/path/to/CC-MCP-Toggling/` 以及你克隆仓库的实际路径。

3. 使其可执行：

chmod +x ~/.local/bin/mcp-toggle

4. 确保 `~/.local/bin` 在你的PATH中。添加到 `~/.bashrc` 或者 `~/.zshrc`：

export PATH="$HOME/.local/bin:$PATH"

5. 重新加载您的shell配置：

source ~/.bashrc # or source ~/.zshrc

现在你可以跑了 `mcp-toggle` 随时随地！

### 控制（部件）

- **上/下** - 在服务器之间导航
- **太空** - 开启/关闭服务器
- **q** - 退出

### 状态指示器

- **\[✓\]（正确）** 绿色表示 - 服务器处于活动状态
- **\[ \]** 红色表示 - 服务器未激活

## 它是如何工作的

该工具管理两个JSON配置文件：

- `~/.claude.json` - 活跃的MCP服务器（由Claude Code使用）
- `~/.claude-toggled.json` - 不活跃的MCP服务器（已关闭）

当你切换服务器时：

- **激活 → 非激活**服务器配置已从 `.claude.json` to `.claude-toggled.json`
- **非活跃 → 活跃**服务器配置从（原位置）迁移至 `.claude-toggled.json` 到；向；对于；在……方面 `.claude.json`

## 备注

- 如果配置文件不存在，该工具会自动创建它们
- 所有更改立即保存
- 切换时服务器配置保持不变
- 切换服务器后，重启Claude代码以使更改生效