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

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.

Frequently asked questions

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

Basic information

Category

AI & Agents

Transports

stdio

Author

BLTGV

More AI & Agents MCP servers

Plainpaper

Plainpaper

The AI marketing canvas for Claude and MCP agents. Your agent drafts campaigns as cards on a shared board, briefed by your brand rules, approved by you.

🛡️ A.I.G（AI-Infra-Guard）

Tencent

A full-stack AI Red Teaming platform securing AI ecosystems via OpenClaw Security Scan, Agent Scan, Skills Scan, MCP scan, AI Infra scan and LLM jailbreak evaluation.

4.1K

Simplepages

Simplepages

Build and edit landing pages and websites from your AI assistant, and pull how they are performing.

Lumify Sports Intelligence

Lumify

Agent-ready sports intelligence API: live scores, odds, line movement, public betting splits, and explainable bet confidence — via 16 MCP tools at https://lumify.ai/mcp. Get a free key instantly — no signup, email, or ca

scvd.store

seancrecord

The trust layer of the x402 economy. Free conformance checking for any issuer's x402 signed offers and receipts. Settlement attestation on Base and Solana. Weekly signed, Bitcoin-anchored ecosystem corpus.

2