AI导哈

MCP服务器管理工具

一个用于管理Claude Code中MCP服务器的命令行工具，提供服务器启用/禁用、备份恢复等功能，适合开发人员临时禁用服务器进行测试或调试。

  • by RoXsaita
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 RoXsaita/Claude-MCP-Toggle

使用说明

克劳德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 配置文件：

  1. 配置检测：自动检测您的项目路径并读取相应的MCP服务器配置
  2. 智能备份：在中创建带时间戳的备份 ~/.claude/backups/ 在进行更改之前
  3. 服务器管理：从中添加/删除服务器 mcpServers 部分，同时保留所有其他设置
  4. 备份清理：自动维护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版本和操作系统

相关 MCP