Claude MCP Manager

What is Claude MCP Manager?

A command-line tool for macOS to define, manage, and switch between different sets of mcpServers configurations (profiles) for the Claude Desktop application. It is for users who want to organize multiple MCP server setups and easily activate them.

How to use Claude MCP Manager?

Install via the provided one-liner or manually, then run claude-mcp-manager <command | profile_name | option> in the terminal. Activate a profile by passing its name as the first argument; manage server definitions and profiles using the server and profile subcommands.

Key features of Claude MCP Manager

• Define individual MCP server configurations as separate JSON files.
• Group servers into named profiles (e.g., 'default', 'work', 'experimental').
• Activate a profile to update the Claude desktop config and restart the app.
• Use environment variables for secrets via a .env file with placeholders.
• Backup and restore previous mcpServers state with the last command.
• Extract existing servers from the active Claude config into defined files.

Use cases of Claude MCP Manager

• Quickly switch between development, testing, and production MCP server sets.
• Share server configurations across team members without exposing API keys.
• Keep a stable "default" profile and experiment with new servers in separate profiles.
• Recover from a broken configuration by rolling back to the last active profile.
• Manage and document all MCP servers used in different projects or workflows.