AI导哈

MCP服务器管理工具

一个用于管理Claude Desktop和Claude Code中MCP服务器的命令行工具，支持自动检测、多级配置管理和交互式操作。

  • by KalinYorgov
  • Python
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 KalinYorgov/mcp-server-manager

使用说明

Claude的MCP服务器管理器🎛️

一个强大的CLI工具，用于管理跨平台的MCP（模型上下文协议）服务器 克劳德桌面 和 克劳德代码.启用、禁用和管理您的MCP服务器，而不会丢失配置！

🌟 特性

  • 🔍 自动检测 Claude桌面和Claude代码安装
  • 🎯 管理所有配置级别的服务器 （桌面、用户、项目、本地）
  • 🎨 彩色编码显示器 -不同配置源的不同颜色
  • 💾 保留配置 禁用服务器时
  • 🔄 交互模式 便于管理
  • 📁 在任何项目目录中工作 全局安装后
  • 🔐 自动备份 在进行更改之前

📸 截图

列表视图

显示所有MCP服务器及其状态和配置源

交互模式

通过交互式选择轻松切换多个服务器

详细视图

每台服务器的详细配置信息

🚀 快速开始

1.克隆存储库

git clone https://github.com/yourusername/mcp-server-manager.git
cd mcp-server-manager

2.全局安装（推荐）

# Automatic installation
chmod +x install.sh
./install.sh

# OR Manual installation
sudo cp mcp_manager.py /usr/local/bin/mcp-manager
sudo chmod +x /usr/local/bin/mcp-manager
sudo ln -s /usr/local/bin/mcp-manager /usr/local/bin/mcp

3.从任何项目中使用！

cd /any/project/directory
mcp list  # See all MCP servers for this context

🎮 用法

基本命令

# List all MCP servers
mcp list

# Detailed view with configuration info
mcp list -d

# Interactive mode (easiest way to manage servers)
mcp interactive

# Toggle a specific server
mcp toggle github

# Get help
mcp --help

按应用程序管理服务器

# Manage only Claude Desktop servers
mcp --app desktop list
mcp --app desktop interactive

# Manage only Claude Code servers
mcp --app code list
mcp --app code interactive

# Auto-detect (default)
mcp list

🎯 交互模式

交互模式是管理服务器的最简单方法：

mcp interactive

您将看到：

Interactive MCP Server Manager
Select servers to toggle (space-separated numbers, 'q' to quit, 'a' to apply changes):

  1. [ON ] [D] brave-search
  2. [ON ] [D] github
  3. [OFF] [D] puppeteer
  4. [ON ] [L] sequential-thinking
  5. [ON ] [P] project-specific-server

Levels: [D]esktop, [L]ocal, [P]roject, [U]ser/Global

Enter selection (numbers/q/a): 1 3 4
  • 输入数字 用空格分隔以切换服务器
  • 按 a 应用和保存更改
  • 按 q 退出

📊 了解配置级别

MCP服务器可以配置在不同的级别，具有不同的优先级：

克劳德桌面

  • 位置: ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）
  • 指标: [D] 紫色的
  • 范围：可在Claude Desktop应用程序中使用

克劳德代码级别（优先级顺序）

  1. 本地 [L] -特定项目 ~/.claude.json
  2. 项目 [P] - .mcp.json 或 .claude/settings.json 在项目中
  3. 用户/全局 [U] - ~/.claude.json 全局块

较高的优先级会覆盖较低的优先级。

🔍 查找MCP服务器源

使用附带的检测器查找WHERE服务器来自：

cd /your/project
python3 ~/path/to/mcp-server-manager/claude_mcp_detector.py

这表明：

  • 所有配置文件
  • 每个文件中都有哪些服务器
  • 哪些服务器实际上处于活动状态
  • 优先级顺序

💡 常见用例

禁用项目中未使用的服务器

cd ~/Projects/MyProject
mcp interactive
# Select servers to disable
# Press 'a' to apply

查看Claude Code看到了什么

# In your project directory
claude mcp list  # What Claude Code actually uses
mcp list         # What our tool detects

清理重复的服务器

如果您在Desktop和Code中都有相同的服务器：

mcp interactive
# Disable the duplicate you don't need

项目特定配置

cd ~/Projects/MyProject
# Add a project-specific server
claude mcp add github --scope local
# Now manage it with
mcp interactive

🛠️ 高级功能

备份管理

每次更改都会创建一个带时间戳的备份：

~/.claude.json.backup.20250110_143022

已禁用服务器存储

禁用的服务器存储在 _disabled_mcpServers 部分，保留其配置：

{
  "mcpServers": {
    "active-server": { ... }
  },
  "_disabled_mcpServers": {
    "disabled-server": { ... }
  }
}

直接配置编辑

该工具可以直接修改您的配置文件，因此您还可以：

  1. 使用 mcp list 查看当前状态
  2. 如果需要，手动编辑JSON文件
  3. 使用 mcp list 验证更改

🐛 故障排除

“未找到MCP服务器”

  • 检查是否安装了Claude Desktop或Claude Code
  • 跑 mcp list -d 查看正在检查哪些配置文件
  • 确保配置文件存在并且是有效的JSON

更改未生效

  • 克劳德桌面：重新启动应用程序
  • 克劳德代码：重新启动 claude 项目中的命令

权限不足

# Use sudo for system directories
sudo cp mcp_manager.py /usr/local/bin/mcp-manager

# Or install in user directory
mkdir -p ~/.local/bin
cp mcp_manager.py ~/.local/bin/mcp-manager
export PATH="$PATH:~/.local/bin"

Claude Code与工具中的不同服务器

  • Claude Code合并来自多个源的配置
  • 使用 claude_mcp_detector.py 查看所有来源
  • 较高优先级的配置会覆盖较低优先级的配置

📁 配置文件位置

克劳德桌面

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

克劳德代码

  • 用户/全局: ~/.claude.json
  • 用户设置: ~/.claude/settings.json
  • 项目: .mcp.json 或 .claude/settings.json
  • 本地项目: .claude/settings.local.json

🤝 贡献

欢迎投稿！请随时提交拉取请求。

  1. 分叉存储库
  2. 创建功能分支(git checkout -b feature/AmazingFeature)
  3. 提交您的更改(git commit -m 'Add some AmazingFeature')
  4. 推到分支(git push origin feature/AmazingFeature)
  5. 打开拉取请求

📜 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢

  • 专为Claude Desktop和Claude Code社区打造
  • 受更好的MCP服务器管理需求的启发
  • 感谢Anthropic的Claude和MCP协议

🆕 新增功能

v2.0.0（最新）

  • ✨ 添加了克劳德桌面支持
  • ✨ 克劳德桌面与克劳德代码的自动检测
  • ✨ 多级配置支持
  • ✨ 全局安装脚本
  • ✨ 用于查找服务器源的MCP检测器工具
  • 🐛 修复了macOS兼容性问题

v1.0.0

  • 支持Claude Code的初始版本

📝 未来功能

  • []服务器组/配置文件
  • []导入/导出配置
  • []服务器健康检查
  • []GUI版本
  • []桌面和代码之间的同步
  • []服务器模板

由以下材料制成❤️ 适用于各地的Claude用户

如果你觉得这个工具有用，请⭐ 将存储库星化！

相关 MCP