MCP Server Toggle Manager

A terminal-based UI tool for managing MCP (Model Context Protocol) servers in Claude Code. Easily toggle servers on/off without manually editing JSON configuration files.

Features

Interactive curses-based terminal UI
Toggle MCP servers between active and inactive states
Automatic management of ~/.claude.json and ~/.claude-toggled.json
Color-coded status indicators
Keyboard navigation

Requirements

Python 3.13 (or Python 3.6+)
curses module (usually pre-installed on Unix-like systems)

Installation

1. Install Python 3.13

apt-get update && \
apt-get install -y software-properties-common curl && \
add-apt-repository -y ppa:deadsnakes/ppa && \
apt-get update && \
apt-get install -y python3.13 python3.13-venv python3.13-dev build-essential libssl-dev libffi-dev cargo && \
apt-get remove -y python3-blinker && \
curl -sS https://bootstrap.pypa.io/get-pip.py | python3.13

2. Clone or download this repository

git clone https://github.com/Parham125/CC-MCP-Toggling
cd CC-MCP-Toggling

3. Make the script executable

chmod +x main.py

Usage

Run Directly

./main.py

Create a Global Command

To run the tool from anywhere, create a bash script in your PATH:

Create a directory for local binaries (if it doesn't exist):

mkdir -p ~/.local/bin

Create the wrapper script (replace the path with your actual installation path):

cat > ~/.local/bin/mcp-toggle << 'EOF'
#!/bin/bash
exec python3.13 /path/to/CC-MCP-Toggling/main.py "$@"
EOF

[!NOTE] Replace /path/to/CC-MCP-Toggling/ with the actual path where you cloned the repository.

Make it executable:

chmod +x ~/.local/bin/mcp-toggle

Ensure ~/.local/bin is in your PATH. Add to ~/.bashrc or ~/.zshrc:

export PATH="$HOME/.local/bin:$PATH"

Reload your shell configuration:

source ~/.bashrc  # or source ~/.zshrc

Now you can run mcp-toggle from anywhere!

Controls

↑/↓ - Navigate through servers
SPACE - Toggle server on/off
q - Quit

Status Indicators

[✓] in green - Server is active
[ ] in red - Server is inactive

How It Works

The tool manages two JSON configuration files:

~/.claude.json - Active MCP servers (used by Claude Code)
~/.claude-toggled.json - Inactive MCP servers (toggled off)

When you toggle a server:

Active → Inactive: Server config moves from .claude.json to .claude-toggled.json
Inactive → Active: Server config moves from .claude-toggled.json to .claude.json

Notes

The tool automatically creates config files if they don't exist
All changes are saved immediately
Server configurations are preserved when toggling
Restart Claude Code after toggling servers for changes to take effect

MCP Servers