>_ ccmcp

# Why

Claude Code auto-loads MCP servers from at least six distinct places - user config, local project state, committed .mcp.json, bundled plugin .mcp.jsons, claude.ai OAuth integrations, and in-memory overrides. Starting a session with all of them enabled burns hundreds of tokens of context before you type a character.

The built-in /mcp menu toggles things one row at a time. ccmcp toggles them in bulk, by scope, or by filter, and gives you a single view that reflects what will actually load in the current project.

# Install

Homebrew (macOS, Linux)

brew install robworks-code/tap/ccmcp

Homebrew 5.x requires third-party taps to be trusted. If install or brew upgrade reports Refusing to load formula ... from untrusted tap, trust it once with brew trust robworks-code/tap (a one-time, per-machine step that applies to every non-official tap).

go install (Go 1.25+)

go install github.com/ringo380/ccmcp@latest

Prebuilt binaries

Download from the releases page.

From source

git clone https://github.com/ringo380/ccmcp
cd ccmcp
go build -ldflags='-s -w' -o ~/bin/ccmcp .

# Quick start

In any project directory:

ccmcp

The effective view is the default. It lists every MCP that will load in this project, with a badge showing its source and a checkbox showing whether it's currently enabled here. Three keystrokes to turn off every plugin-registered MCP for this project:

/plugin      <enter>      N      w

• /plugin - filter rows whose name contains "plugin" (or a plugin name like cloudflare)
• N - bulk-disable everything visible (writes to disabledMcpServers for this project only)
• w - save

Undo the same way with A.

# What ccmcp sees

Effective-view marks

• [x] - will load in this project
• [~] - disabled here via a per-project override (easy to undo)
• [ ] - not active in this project by any source
• [?] - in disabledMcpServers but no live source found (stale); the row description explains why, and ccmcp mcp prune cleans it up

# What you get

# CLI

ccmcp status                                   # show everything at once
ccmcp status --json                            # JSON for scripts

ccmcp mcp list [--scope SCOPE]                 # user|local|project|plugin|claudeai|stash|all
ccmcp mcp enable  <name> [--scope SCOPE]
ccmcp mcp disable <name> [--scope SCOPE] [--to-stash]
ccmcp mcp move    <name> --to {user|local|stash}
ccmcp mcp override <name> [--undo]             # per-project disable
ccmcp mcp prune [--dry-run] [--yes] [--include-stash-ghosts]
ccmcp mcp stash   [<name>...]                  # user-scope → stash
ccmcp mcp restore [<name>...]                  # stash → user-scope (alias: unstash)

ccmcp profile save|list|show|use|delete <name> [<mcp>...]
ccmcp profile export <name> [--out FILE] [--with-config]
ccmcp profile import [FILE|-] [--overwrite]

ccmcp skill   list [--scope user|project|plugin] [--enabled|--disabled]
ccmcp skill   enable|disable <name> [<name>...]
ccmcp skill   new|move|rm|show <name> [--scope user|project]

ccmcp agent   list|new|move|rm|show <name>

ccmcp command list [--scope user|project|plugin]
ccmcp command conflicts [--include-ignored] [--json]
ccmcp command resolve <effective-name> [--strategy disable-skill|ignore|list]

ccmcp report snapshot [--out FILE] [--format json|md|csv]
ccmcp report sweep    [--base PATH] [--format json|md|csv]
ccmcp report drift    --from <snapshot.json> [--format json|md]
ccmcp report audit    [--format json|md|csv]

ccmcp doctor md [--user] [--memory-dir DIR]
ccmcp doctor md --llm-review [--provider anthropic|openai]

ccmcp plugin list [--enabled|--disabled]
ccmcp plugin enable|disable|install|remove <id> [--marketplace M] [--purge]
ccmcp marketplace list|add|remove <name> [--source github|git|local] [--repo R]

ccmcp tui --dump [--tab mcps|plugins|skills|agents|commands|tweaks|profiles|summary|doctor]

Global flags: --path <dir>, --dry-run, --json, --no-color.

Full key reference, scope terminology, and implementation notes live in the README.