AI导哈

MCP服务器切换管理工具

一个基于终端的UI工具，用于管理Claude Code中的MCP（Model Context Protocol）服务器，无需手动编辑JSON配置文件即可轻松切换服务器状态。

  • by Parham125
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Parham125/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 << 'EOF'
#!/bin/bash
exec python3.13 /path/to/CC-MCP-Toggling/main.py "$@"
EOF

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

  1. 使其可执行：
chmod +x ~/.local/bin/mcp-toggle
  1. 确保 ~/.local/bin 在你的PATH中。添加到 ~/.bashrc 或者 ~/.zshrc：
export PATH="$HOME/.local/bin:$PATH"
  1. 重新加载您的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代码以使更改生效

相关 MCP