MCP服务器管理器

Name: MCP服务器管理器
Author: KalinYorgov

作者：KalinYorgov7 星标更新：2025-09-12

安装使用来源：spider==github.com

项目介绍

MCP Server Manager for Claude 🎛️

一个强大的CLI工具，用于管理跨Claude Desktop和Claude Code的MCP（模型上下文协议）服务器。启用、禁用并管理您的MCP服务器，同时不会丢失配置！

🌟 功能

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

📸 屏幕截图

列表视图

MCP 列表视图 显示所有MCP服务器及其状态和配置来源

交互模式

交互模式 轻松切换多个服务器

详细视图

详细视图 每个服务器的详细配置信息

🚀 快速开始

1. 克隆仓库

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

2. 全局安装（推荐）

# 自动安装
chmod +x install.sh
./install.sh

# 或手动安装
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  # 查看此上下文中的所有MCP服务器

🎮 使用方法

基本命令

# 列出所有MCP服务器
mcp list

# 详细视图，带有配置信息
mcp list -d

# 交互模式（最简单的管理方式）
mcp interactive

# 切换特定服务器
mcp toggle github

# 获取帮助
mcp --help

按应用管理服务器

# 仅管理Claude Desktop服务器
mcp --app desktop list
mcp --app desktop interactive

# 仅管理Claude Code服务器
mcp --app code list
mcp --app code interactive

# 自动检测（默认）
mcp list

🎯 交互模式

交互模式是最简单的管理方式：

mcp interactive

你会看到：

交互式MCP服务器管理器
选择要切换的服务器（空格分隔的数字，'q'退出，'a'应用更改）：

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

级别：[D]esktop, [L]ocal, [P]roject, [U]ser/Global

输入选择（数字/q/a）：1 3 4

输入数字，以空格分隔，切换服务器
按 a 应用并保存更改
按 q 退出

📊 理解配置级别

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

Claude Desktop

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

Claude Code 级别（优先级顺序）

本地 [L] - 项目特定的 ~/.claude.json
项目 [P] - 项目中的 .mcp.json 或 .claude/settings.json
用户/全局 [U] - ~/.claude.json 的全局部分

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

🔍 查找MCP服务器来源

使用内置检测器查找服务器来自何处：

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

这会显示：

所有配置文件
每个文件中的哪些服务器
实际活跃的哪些服务器
优先级顺序

💡 常见用例

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

cd ~/Projects/MyProject
mcp interactive
# 选择要禁用的服务器
# 按 'a' 应用

检查Claude Code实际使用什么

# 在你的项目目录中
claude mcp list  # Claude Code 实际使用什么
mcp list         # 我们的工具检测到什么

清理重复的服务器

如果你在桌面和代码中都有相同的服务器：

mcp interactive
# 禁用不需要的重复项

项目特定配置

cd ~/Projects/MyProject
# 添加项目特定的服务器
claude mcp add github --scope local
# 现在使用
mcp interactive

🛠️ 高级功能

备份管理

每次更改都会创建时间戳备份：

~/.claude.json.backup.20250110_143022

禁用服务器存储

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

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

直接配置编辑

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

使用 mcp list 查看当前状态
如需手动编辑JSON文件
使用 mcp list 验证更改

🐛 故障排除

“未找到MCP服务器”

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

更改未生效

Claude Desktop：重启应用程序
Claude Code：在项目中使用 claude 命令重启

权限被拒绝

# 对于系统目录使用sudo
sudo cp mcp_manager.py /usr/local/bin/mcp-manager

# 或安装在用户目录
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 查看所有来源
较高优先级的配置覆盖较低优先级的配置

📁 配置文件位置

Claude Desktop

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json
Linux：~/.config/Claude/claude_desktop_config.json

Claude Code

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

🤝 贡献

欢迎贡献！请随意提交Pull Request。

分叉仓库
创建你的功能分支（git checkout -b feature/AmazingFeature）
提交你的更改（git commit -m 'Add some AmazingFeature'）
推送到分支（git push origin feature/AmazingFeature）
打开Pull Request

📜 许可证

该项目采用MIT许可证 - 详情请参阅LICENSE文件。

🙏 致谢

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

🆕 新特性

v2.0.0（最新）

✨ 增加了对Claude Desktop的支持
✨ 自动检测Claude Desktop与Claude Code
✨ 多级配置支持
✨ 全局安装脚本
✨ MCP检测工具，查找服务器来源
🐛 修复了macOS兼容性问题

v1.0.0

初始发布，支持Claude Code

📝 未来功能

为全球Claude用户制作 ❤️

如果您发现这个工具很有帮助，请给仓库⭐点赞！