克劳德MCP切换
一个简单的命令行工具，用于管理Claude Code中的MCP（模型上下文协议）服务器。通过智能备份和还原功能打开/关闭服务器，而不会丢失其配置。
它做什么
Claude MCP Toggle通过以下方式帮助您管理MCP服务器：
- 退出：暂时禁用服务器（从配置中删除，保留备份）
- 分期入住：从备份历史记录中重新启用服务器
- 列表：查看所有可用和已启用的服务器
- 恢复：从备份还原完整配置
非常适合需要临时禁用MCP服务器进行测试、调试或性能原因而不会丢失配置的开发人员。
特性
- 🔄 智能切换系统：禁用服务器而不丢失配置
- 📦 自动备份：带有智能清理功能的带时间戳的备份
- 🔍 服务器发现：与集成
claude mcp list命令 - ⚡ 选择性还原：从备份历史记录中还原单个服务器
- 🛡️ 临时运营：多次运行安全
- 📊 状态概述：可用服务器与已启用服务器的清晰视图
安装
克隆并运行-就是这么简单：
git clone https://github.com/yourusername/Claude-MCP-Toggle.git
cd Claude-MCP-Toggle
python mcp_stage.py help用法
列出所有服务器
python mcp_stage.py list显示来自的可用服务器 claude mcp list 以及当前启用了哪些功能。
禁用服务器（退出阶段）
python mcp_stage.py out ServerName从配置中删除服务器并创建备份。
启用服务器（进入阶段）
python mcp_stage.py in ServerName从包含服务器配置的最新备份中还原服务器配置。
还原完整配置
python mcp_stage.py restore从备份中还原完整配置。
获得帮助
python mcp_stage.py help运作原理
Claude MCP Toggle通过操纵您的 ~/.claude.json 配置文件：
- 配置检测：自动检测您的项目路径并读取相应的MCP服务器配置
- 智能备份：在中创建带时间戳的备份
~/.claude/backups/在进行更改之前 - 服务器管理：从中添加/删除服务器
mcpServers部分，同时保留所有其他设置 - 备份清理：自动维护10个最新备份
文件结构
Claude-MCP-Toggle/
├── mcp_stage.py # Main script
├── tests/
│ └── test_mcp_stage.py # Comprehensive test suite
├── README.md # This file
├── CONTRIBUTING.md # Contribution guidelines
└── LICENSE # MIT License需求
- Python 3.6+
- 已安装并配置Claude Code CLI
- 访问
~/.claude.json配置文件
例子
通用工作流
# See what's available
python mcp_stage.py list
# Temporarily disable a heavy server for testing
python mcp_stage.py out Ref
# Re-enable when needed
python mcp_stage.py in Ref
# Check status
python mcp_stage.py list备份管理
该工具自动管理中的备份 ~/.claude/backups/:
- 在更改之前创建带时间戳的备份
- 保留最近的10个备份
- 允许从备份历史记录中选择性恢复服务器
故障排除
找不到服务器
如果您收到“找不到服务器”，请检查：
- 服务器名称拼写（支持不区分大小写的匹配）
- 跑
python mcp_stage.py list查看可用服务器 - 确保Claude Code CLI正常工作：
claude mcp list
配置问题
- 配置文件：
~/.claude.json - 备份目录：
~/.claude/backups/ - 该工具保留所有非MCP设置
需要重新启动
切换服务器后，重新启动Claude Code以使更改生效。
许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。
贡献
欢迎投稿！请阅读 贡献.md 作为指导方针。
支持
- 为bug或功能请求创建问题
- 发布前检查现有问题
- 在bug报告中包含您的Python版本和操作系统