MCP.so
Sign In

Claude MCP Config Switcher

@BLTGV

Repository

About Claude MCP Config Switcher

Script to easily switch between Claude MCP server configurations on macOS.

#claude-mcp#config-switcher#macos-tool

Basic information

Category

AI & Agents

Runtime

shell

Transports

stdio

Publisher

BLTGV

Config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Claude MCP Config Switcher?

A command-line tool for macOS that quickly switches between different mcpServers configurations for the Claude desktop application. It lets you define multiple named profiles (e.g., “default”, “staging”, “dev”) and swap the active MCP server block in Claude’s config file without manual editing, then automatically restarts Claude to apply the changes.

How to use Claude MCP Config Switcher?

Install via the quick install command (curl -fsSL … | sh -s -- --install) or manually by running the setup.sh --install script. After installation, create .json profile files in ~/.config/claude/ containing an mcpServers key. Use the command claude-mcp-switch <profile> (or claude-mcp-switch to default to “default”) to switch, claude-mcp-switch -l to list available profiles, and claude-mcp-switch last to revert to the previous configuration.

Key features of Claude MCP Config Switcher

  • macOS command-line tool for switching Claude MCP configurations.
  • Creates named configuration profiles from JSON files.
  • Automatically restarts Claude to apply changes.
  • Preserves non-mcpServers keys in Claude config.
  • Backs up previous configuration for easy rollback.
  • Lists available and currently loaded profiles.

Use cases of Claude MCP Config Switcher

  • Quickly switch between work and personal MCP server setups.
  • Toggle development, staging, and production MCP endpoints without manual editing.
  • Roll back to a previous configuration after testing new settings.

FAQ from Claude MCP Config Switcher

Does it work on Windows or Linux?

No. The script relies on macOS-specific paths (~/Library/Application Support/Claude/) and commands (killall, open), so it will not work on Windows or Linux.

What dependencies are required?

The jq utility must be installed. It can be installed via brew install jq.

Where are configuration profiles stored?

Profiles are stored as .json files in the ~/.config/claude/ directory. Each file must contain an mcpServers key.

What does the script modify in Claude’s config file?

The script only reads and writes the mcpServers key. Other keys in the target Claude config file are preserved, and other keys in source profile files are ignored.

How do I revert to the previous configuration?

Use the command claude-mcp-switch last. The script saves a backup of the previous mcpServers block into ~/.config/claude/last.json.

Comments

More AI & Agents MCP servers

Sequential Thinking Multi-Agent System (MAS)

FradSer

An advanced sequential thinking process using a Multi-Agent System (MAS) built with the Agno framework and served via MCP.

306

Intervals.icu MCP Server

mvilanova

Model Context Protocol (MCP) server for connecting Claude and ChatGPT with the Intervals.icu API.

311

MCP Client for Ollama (ollmcp)

jonigl

Harness the power of local LLMs with this TUI MCP Client for Ollama. Featuring all core MCP primitives (tools, prompts, resources), agent mode, multi-server, model switching, streaming responses, human-in-the-loop, thinking mode, model params config, system prompts, and saved pre

768

MCP Server - Remote MacOs Use

baryhuang

The only general AI agent that does NOT requires extra API key, giving you full control on your local and remote MacOs from Claude Desktop App

487

Mcp Agent

lastmile-ai

Build effective agents using Model Context Protocol and simple workflow patterns

8.4K