claude-mcp-manager

Claude MCP Profile Manager

A shell script to manage Claude Desktop's MCP (Model Control Protocol) profiles. This tool allows you to easily switch between different MCP configurations for Claude Desktop.

Features

• List available MCP profiles
• Switch between different MCP profiles
• Save current configuration as a new profile
• Disable MCP configuration
• Check current MCP status
• Automatic profile directory creation
• Automatic Claude app restart when changing profiles or disabling MCP

Prerequisites

• macOS (tested on macOS 14.0+)
• Claude Desktop installed
• Zsh shell

Installation

1. Clone this repository:

git clone https://github.com/YUZongmin/claude-mcp-manager.git
cd claude-mcp-manager

2. Create a .env file in the project root with your configuration:

# Claude Desktop Configuration Path
CLAUDE_CONFIG="/path/to/your/claude_desktop_config.json"

# Profiles Directory Path
PROFILES_DIR="/path/to/your/profiles/directory"

3. Make the script executable:

chmod +x mcp.sh

4. Add the script to your .zshrc:

source "/path/to/claude-mcp-manager/mcp.sh"

5. Reload your shell configuration:

source ~/.zshrc

Usage

The script provides the following commands:

mcp ls         # List all available profiles
mcp status     # Show current MCP configuration status
mcp off        # Disable MCP configuration and restart Claude
mcp save NAME  # Save current configuration as a new profile
mcp PROFILE    # Switch to specified profile and restart Claude

Example Usage

1. First, save your current Claude configuration as a profile:

mcp save default

2. List available profiles:

mcp ls

3. Switch between profiles (this will automatically restart Claude):

mcp default

4. Check current status:

mcp status

5. Disable MCP (this will automatically restart Claude):

mcp off

Automatic App Restart

The script automatically handles Claude app lifecycle:

• When switching profiles (mcp profile_name), Claude will restart to apply the new configuration
• When disabling MCP (mcp off), Claude will restart with the default configuration
• The restart process includes:
  1. Gracefully closing Claude if it's running
  2. Waiting for proper shutdown
  3. Reopening Claude with the new configuration

Directory Structure

claude-mcp-manager/
├── mcp.sh           # Main script file
├── .env             # Configuration file (create this)
├── .gitignore       # Git ignore file
├── README.md        # This file
└── profiles/        # Directory for storing profiles (created automatically)

Configuration

Environment Variables

Create a .env file in the project root with the following variables:

• CLAUDE_CONFIG: Path to your Claude Desktop configuration file
  • Default location: ~/Library/Application Support/Claude/claude_desktop_config.json
• PROFILES_DIR: Path to the directory where you want to store your MCP profiles
  • This directory will be created automatically if it doesn't exist

Profile Format

Profiles are stored as JSON files in the profiles/ directory. Each profile should follow the Claude Desktop configuration format:

{
  "globalShortcut": "Control+Option+Space",
  "mcpServers": {
    // Your MCP server configurations here
  }
}

Troubleshooting

1. If you get "command not found: mcp":

   • Make sure you've sourced the script in your .zshrc
   • Run source ~/.zshrc to reload your shell configuration

2. If you get "Error: .env file not found":

   • Make sure you've created the .env file in the same directory as mcp.sh
   • Check that the paths in your .env file are correct

3. If profiles aren't showing up:

   • Check that the PROFILES_DIR path in your .env file is correct
   • Make sure you've saved at least one profile using mcp save NAME

4. If Claude doesn't restart properly:

   • Make sure Claude is installed in your Applications folder
   • Try increasing the sleep duration in the script if needed
   • Check if you have sufficient permissions to control the app

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Claude Desktop team for the MCP feature
• The open-source community for inspiration and tools