MCP Server Manager for Claude 🎛️

A powerful CLI tool to manage MCP (Model Context Protocol) servers across Claude Desktop and Claude Code. Enable, disable, and manage your MCP servers without losing configuration!

🌟 Features

• 🔍 Auto-detects Claude Desktop and Claude Code installations
• 🎯 Manages servers across all configuration levels (Desktop, User, Project, Local)
• 🎨 Color-coded display - Different colors for different configuration sources
• 💾 Preserves configurations when disabling servers
• 🔄 Interactive mode for easy management
• 📁 Works in any project directory after global installation
• 🔐 Automatic backups before making changes

📸 Screenshots

List View

Shows all MCP servers with their status and configuration source

Interactive Mode

Toggle multiple servers easily with interactive selection

Detailed View

Detailed configuration information for each server

🚀 Quick Start

1. Clone the Repository

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

2. Install Globally (Recommended)

# 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. Use from Any Project!

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

🎮 Usage

Basic Commands

# 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

Managing Servers by Application

# 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

🎯 Interactive Mode

The interactive mode is the easiest way to manage your servers:

mcp interactive

You'll see:

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

• Enter numbers separated by spaces to toggle servers
• Press a to apply and save changes
• Press q to quit

📊 Understanding Configuration Levels

MCP servers can be configured at different levels, with different priorities:

Claude Desktop

• Location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
• Indicator: [D] in purple
• Scope: Available in Claude Desktop app

Claude Code Levels (Priority Order)

1. Local [L] - Project-specific in ~/.claude.json
2. Project [P] - .mcp.json or .claude/settings.json in project
3. User/Global [U] - ~/.claude.json global section

Higher priority levels override lower ones.

🔍 Finding MCP Server Sources

Use the included detector to find WHERE servers come from:

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