ClaudeCode MCP Manager

一个用于管理Claude Code中的模型上下文协议（MCP）服务器的漂亮终端用户界面。

⚠️ 开发状态：这是一个正在积极开发的项目，并已在有限的环境中进行了测试。虽然核心功能正常工作，但可能包含错误或特殊情况。使用时请谨慎，并始终备份您的Claude配置文件。

功能

• 🎨 漂亮的TUI - 使用Bubble Tea构建，提供流畅的终端体验
• 🔄 切换MCP - 单击按键即可即时启用或禁用MCP
• 👤 配置文件支持 - 管理不同Claude实例的不同MCP集合（例如，glm与claude）
• 💾 自动备份 - 每次更改前自动备份，易于恢复
• ⚡ 实时状态 - 查看哪些MCP正在运行、已停止或失败
• 🎯 简单的界面 - 类似Vim的导航，无需手册

安装

推荐：使用安装脚本

git clone https://github.com/donmecca/claudecode-mcp-manager
cd claudecode-mcp-manager

# 构建并安装到~/.local/bin（不需要sudo）
./scripts/install.sh --build --local

# 或者安装到/usr/local/bin（需要sudo）
sudo ./scripts/install.sh --build

安装脚本会自动处理macOS Gatekeeper隔离解除。

从源代码安装（手动）

git clone https://github.com/donmecca/claudecode-mcp-manager
cd claudecode-mcp-manager
go build -o mcp-manager

# 安装到~/.local/bin
cp mcp-manager ~/.local/bin/
chmod +x ~/.local/bin/mcp-manager

# 在macOS上：解除Gatekeeper隔离
xattr -d com.apple.quarantine ~/.local/bin/mcp-manager 2>/dev/null || true

# 或者安装到/usr/local/bin（需要sudo）
sudo mv mcp-manager /usr/local/bin/

使用Go安装

go install github.com/donmecca/claudecode-mcp-manager@latest

快速开始

# 启动TUI（默认配置文件）
mcp-manager

# 使用特定配置文件启动
mcp-manager --profile glm

# 或在应用内切换配置文件：
# 1. 启动mcp-manager
# 2. 按下'p'查看配置文件
# 3. 选择所需的配置文件并按下回车键
# 4. 应用程序将退出并显示切换命令

使用方法

键盘快捷键

键	动作
↑ / k	向上移动
↓ / j	向下移动
空格	切换MCP开关
a	添加新的MCP
d	删除MCP
r	从备份恢复
p	切换配置文件
h / ?	显示帮助
q / Ctrl+C	退出

配置文件

管理不同Claude Code实例的不同MCP配置：

# 方法1：使用--profile标志（推荐）
mcp-manager --profile glm

# 方法2：设置环境变量
CLAUDE_CONFIG_DIR=~/.claude-glm mcp-manager

# 方法3：在应用程序内切换
# 按下'p'，选择配置文件，按下回车键

# 配置文件命名：
# --profile default → ~/.claude
# --profile glm     → ~/.claude-glm
# --profile work    → ~/.claude-work

交互式配置文件切换：

1. 在应用程序中按下p
2. 导航到所需的配置文件
3. 按下Enter
4. 应用程序退出并显示命令：mcp-manager --profile <name>
5. 运行该命令以切换配置文件

工作原理

管理器通过管理mcpServers对象来修改您的Claude Code配置：

默认配置文件：~/.claude.json GLM配置文件：~/.claude-glm/.claude.json 自定义配置文件：~/.claude-<name>/.claude.json

{
  "mcpServers": {
    "fetch-mcp": { "type": "stdio", "command": "node", "args": [...] },
    "brave-search": { "type": "stdio", "command": "npx", "args": [...] }
  },
  "_mcpManagerDisabledServers": {
    "context7-mcp": { "type": "stdio", "command": "npx", "args": [...] }
  }
}

关闭切换将MCP移到_mcpManagerDisabledServers（保存上下文令牌）。 开启切换将其移回到mcpServers。 删除完全移除服务器配置。

开发

参见docs/development.md了解开发设置和贡献指南。

文档

• 架构 - 系统设计和数据流
• 用户指南 - 详细使用指南
• 配置文件指南 - 配置文件管理和设置
• 开发 - 贡献和开发设置
• 故障排除 - 常见问题及解决方案

参见CLAUDE.md了解在此项目上工作的关键指令。

要求

• Go 1.21或更高版本
• 已安装并配置好的Claude Code CLI
• macOS、Linux或Windows

macOS用户：Gatekeeper问题

如果您在运行二进制文件时看到[1] killed mcp-manager，则macOS Gatekeeper正在阻止它。

自动修复（推荐）： 使用安装脚本自动处理此问题：

./scripts/install.sh --build --local

手动修复：

xattr -d com.apple.quarantine ~/.local/bin/mcp-manager

我们的构建和安装脚本现在会自动移除隔离属性以防止此问题。

许可证

MIT许可证 - 详情请参阅LICENSE

致谢

使用以下工具构建：

• Bubble Tea - TUI框架
• Lip Gloss - 终端样式
• Bubbles - TUI组件

支持

• 问题
• 讨论