ccmcp - Claude Code MCP Control Panel

🔧 Interactive MCP server management tool for Claude Code

Features

• 📋 List MCP servers - View all configured MCP servers
• 🔄 Toggle servers - Enable/disable MCP servers with simple keystrokes
• 📊 Status monitoring - Check if MCP servers are running
• 🎮 Interactive interface - Navigate with arrow keys, toggle with space
• 📤 Export to mmcp - Export Claude Code settings to mmcp for cross-CLI management
• 🚀 Fast and lightweight - Built with TypeScript for speed

Installation

Option 1: Using npx (Recommended)

# Run directly without installation
npx ccmcp@latest

# Or run specific version
npx [email protected]

Option 2: Global Installation

# Install globally from npm
npm install -g ccmcp

# Then run anywhere
ccmcp

Option 3: Development Setup

# Clone the repository
git clone https://github.com/karaage0703/ccmcp.git
cd ccmcp
npm install
npm run build

# Run directly
npm start

# Or install globally from local build
npm install -g .
ccmcp

Usage

mmcp Integration

Export your Claude Code MCP servers to mmcp for cross-CLI management:

# 1. Install mmcp first (if not already installed)
npm install -g mmcp

# 2. Export Claude Code settings to mmcp format
ccmcp export-to-mmcp

# 3. Add target CLI agents (e.g., Codex CLI)
mmcp agents add codex-cli

# 4. Apply settings to target CLIs
mmcp apply

What is mmcp? mmcp is a CLI tool that centrally manages MCP server configurations across multiple AI agents (Claude Code, Codex CLI, Cursor, Gemini CLI, etc.).

Interactive Mode (Default)

Simply run ccmcp to start the interactive interface:

# Using npx
npx ccmcp@latest

# Or if installed globally
ccmcp

# Or from development setup
npm start

Controls:

• ↑/↓ - Navigate through servers
• SPACE - Toggle server (disable/enable)
• Q - Quit

Non-Interactive Mode

Perfect for CI/scripts or non-TTY environments:

# Using npx
CI=true npx ccmcp@latest

# Or if installed globally
CI=true ccmcp

# Or from development setup
CI=true npm start

Shows list of all configured servers without interactive interface.

How It Works

ccmcp manages your Claude Code MCP servers using a safe backup system:

• Config Path: ~/.claude.json (main Claude Code configuration)
• Backup Path: ~/.ccmcp_backup.json (disabled servers storage)
• Server Management: Moves servers between active and backup files
• Status Monitoring: Tests server commands to check availability

Server States

• Enabled: Server exists in ~/.claude.json and is active
• Disabled: Server is moved to ~/.ccmcp_backup.json and hidden from Claude Code

This approach ensures:

• ✅ Claude Code correctly recognizes disabled servers as unavailable
• ✅ Server configurations are safely preserved for restoration
• ✅ No interference with Claude Code's configuration format

Configuration Files

Active servers (~/.claude.json)

{
  "mcpServers": {
    "context7": {
      "command": "npx", 
      "args": ["-y", "@upstash/context7-mcp@latest"]
    }
  }
}

Disabled servers (~/.ccmcp_backup.json)

{
  "disabledServers": {
    "markitdown": {
      "command": "uvx",
      "args": ["markitdown-mcp"]
    }
  }
}

Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Type check
npm run typecheck

# Build for distribution
npm run build

Requirements

• Node.js 20.19.4 or later
• Claude Code installed and configured
• macOS (current implementation assumes macOS paths)

Architecture

• TypeScript - Type-safe development
• Native Node.js - No external dependencies for UI
• Direct file manipulation - Reads/writes Claude config directly
• Process monitoring - Tests server availability

Related Projects

• ccusage - Claude Code usage analysis tool that inspired this project

License

MIT License - Feel free to use and modify!