Claudecode MCP Manager

ClaudeCode MCP 管理器

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

⚠️ 开发状态这是一个正在积极开发中的项目，已在有限环境中进行了测试。虽然核心功能运行正常，但可能仍存在漏洞或边缘情况。请谨慎使用，并始终备份您的Claude配置文件。

特点/功能

• 🎨 表示“美术”或“艺术创作”的符号。 美丽的TUI（或根据上下文，可译为“优美的TUI”等，具体译法视“TUI”在此处的具体含义而定） - 使用Bubble Tea构建，以提供流畅的终端体验
• 🔄 翻译成中文是：🔄（这个符号本身没有直接对应的中文含义，但可以理解为“循环”或“重复”的概念，具体翻译需结合上下文） 切换MCPs（注：MCPs可能指某种特定的控制面板、模式选择器或相关设备，具体含义需根据上下文确定） - 通过单键操作即时启用/禁用MCPs（多控制协议/模块）
• 👤（这个符号代表一个人的轮廓，常用于表示“用户”或“某人”） 配置文件支持 - 为不同的Claude实例管理不同的MCP集合（例如。， glm 对阵 claude)
• 💾 磁盘 自动备份 - 每次更改前自动备份，轻松恢复
• ⚡（闪电符号，常用于表示速度、能量或警示等） 实时状态 - 查看哪些MCP（管理控制平面）正在运行、已停止或已失败
• 🎯（目标、瞄准） 简洁的界面 - Vim风格导航，无需手册

安装

建议：使用安装脚本

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

# Build and install to ~/.local/bin (no sudo needed)
./scripts/install.sh --build --local

# Or install to /usr/local/bin (requires 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

# Install to ~/.local/bin
cp mcp-manager ~/.local/bin/
chmod +x ~/.local/bin/mcp-manager

# On macOS: Remove Gatekeeper quarantine
xattr -d com.apple.quarantine ~/.local/bin/mcp-manager 2>/dev/null || true

# Or install to /usr/local/bin (requires sudo)
sudo mv mcp-manager /usr/local/bin/

使用Go安装

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

快速入门

# Launch the TUI (default profile)
mcp-manager

# Launch with specific profile
mcp-manager --profile glm

# Or switch profiles from within the app:
# 1. Launch mcp-manager
# 2. Press 'p' to view profiles
# 3. Select desired profile and press Enter
# 4. App will quit and show you the command to switch

用法

键盘快捷键

简介/个人资料

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

# Method 1: Use --profile flag (recommended)
mcp-manager --profile glm

# Method 2: Set environment variable
CLAUDE_CONFIG_DIR=~/.claude-glm mcp-manager

# Method 3: Switch from within the app
# Press 'p', select profile, press Enter

# Profile naming:
# --profile default → ~/.claude
# --profile glm     → ~/.claude-glm
# --profile work    → ~/.claude-work

交互式配置文件切换：

1. 新闻界；媒体 p 在应用程序中
2. 导航到所需的配置文件
3. 新闻界；按压 Enter
4. 应用程序退出并显示命令： mcp-manager --profile
5. 运行该命令以切换配置文件

它是如何运作的

经理通过管理来修改您的Claude代码配置 mcpServers 对象：

默认配置文件： ~/.claude.json GLM配置文件： ~/.claude-glm/.claude.json 自定义配置文件： ~/.claude-/.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 翻译为中文是：“文档/开发指南.md” 或者更简洁地 “开发文档.md”（如果上下文明确指的是开发相关的文档）。这里，“docs”通常表示“文档”（documents），“development”表示“开发”，“.md”是Markdown文件格式的扩展名 用于开发环境设置和贡献指南。

文档

• 建筑学 - 系统设计和数据流
• 用户指南 - 详细的使用指南
• 个人资料指南 - 配置文件管理与设置
• 发展 - 贡献与开发环境设置
• 故障排除 - 常见问题及解决方案

看 CLAUDE.md（文件名可译为“克劳德.md”） 在处理这个项目时，请遵循以下关键指示。

要求

• Go 1.21或更高版本
• Claude 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 许可证 - 参见 许可证 查看详情

功劳/学分

构建于：

• 珍珠奶茶 - TUI框架
• 唇彩 - 终端样式
• 气泡 - TUI组件

支持

• 问题
• 讨论