Claude Code MCP Selector

by gsong

A CLI tool that intelligently discovers, validates, and selects MCP (Model Context Protocol) server configurations for Claude Code. Requires MCP config JSON files in the configured directory (default: ~/.claude/mcp-configs/), configurable via environment variable CCMCP_CONFIG_DIR.

Developer toolsstdio or Streamable HTTPCommunity

Repository-wide counts · Cached 2026-05-21

Overview

The Claude Code MCP Selector MCP server is a publicly available project. Review the upstream repository for installation instructions, supported tools, compatibility, permissions, and current maintenance status.

Configuration

Configuration, transport, authentication, and runtime requirements vary by project. Open the repository before connecting and use the smallest set of credentials and permissions required.

Open the Claude Code MCP Selector repository to read the latest documentation.

KEEP EXPLORING

Compare source, connection, and authentication details before choosing an implementation.

View the complete category

模型上下文协议服务器

modelcontextprotocol

Community

一组用于模型上下文协议(MCP)的参考实现,展示了对大型语言模型(LLM)工具和数据源的安全且受控的访问方式。

Context7 Platform - Up-to-date Code Docs For Any Prompt

upstash

Community

Context7 MCP server providing up-to-date, version-specific documentation and code examples for libraries, enabling coding agents to fetch accurate docs and code snippets. Requires an API key for higher rate limits, passed via CONTEXT7_API_KEY header.

Playwright MCP

Microsoft Corporation

Community

A Model Context Protocol (MCP) server that provides browser automation capabilities using Playwright. Enables LLMs to interact with web pages through structured accessibility snapshots, bypassing the need for screenshots or visually-tuned models.

AIHawk

feder-cr

Community

AIHawk is an anti detect browser and web browsing agent, open source, with an MCP server for coding agents: undetected, no captchas, no blocks. It requires an OpenRouter API key for the standalone web UI mode, which can be provided via the --openrouter-key flag or the OPENROUTER_API_KEY environment variable or a .env file in the running directory.

FROM THE SOURCE

Repository README

Build-time snapshot · Retrieved 2026-10-05

View original

Claude Code MCP Selector

CI npm

A CLI tool that intelligently discovers, validates, and selects MCP (Model Context Protocol) server configurations for Claude Code.

CCMCP Demo

What it does

Ever have multiple MCP server configs but only want to use specific ones for different tasks? This tool:

  • 🔍 Discovers all MCP configurations in your config directory
  • ✅ Validates config files and shows clear error details for invalid ones
  • 🎯 Interactive selection via modern terminal interface
  • 💾 Remembers your selections per project for faster launches
  • 🌳 Git worktree aware - selections are shared across worktrees of the same repository
  • 🚀 Launches Claude Code with only your chosen configs
  • 🧹 Cleanup stale cache entries and broken symlinks
  • 👻 Ephemeral mode for one-off selections without saving
  • ⚙️ Configurable via CLI options or environment variables

Installation

# Install globally
npm install -g @gsong/ccmcp

# Or run without installing
npx @gsong/ccmcp

Works with npm, pnpm, or yarn. See DEVELOPMENT.md for building from source.

Usage

Quick Start

  1. Run ccmcp
  2. Select configs with arrow keys and spacebar
  3. Press Enter to launch Claude Code

Commands

# Launch with default config directory (~/.claude/mcp-configs/)
ccmcp

# Use custom directory
ccmcp --config-dir /path/to/configs

# Or use environment variable
CCMCP_CONFIG_DIR=/path/to/configs ccmcp

# Pass options to Claude Code
ccmcp --resume

# Cache management
ccmcp -i                      # Skip loading previous selections (short flag)
ccmcp --ignore-cache          # Skip loading previous selections (long flag)
ccmcp -n                      # Don't save selections (ephemeral mode)
ccmcp --no-save               # Don't save selections (ephemeral mode)
ccmcp -in                     # Combine: fresh start + no saving
ccmcp --clear-cache           # Clear all cached selections

# Cleanup stale cache entries and broken symlinks
ccmcp cleanup                 # Interactive cleanup with prompts
ccmcp cleanup --dry-run       # Preview what would be cleaned
ccmcp cleanup --yes           # Skip prompts, automatically proceed

Cleanup notes:

  • Automatically removes entire cache files when no valid configs remain after cleanup
  • Selecting zero configs automatically clears the selection cache for that project

TUI Navigation

  • ↑/↓: Navigate • Space: Select • Enter: Launch Claude Code
  • q / Ctrl+C: Quit
  • a: Select all
  • c: Clear all
  • p: Toggle config preview panel
  • i: Show/hide invalid configs
  • e: Toggle error details (when viewing invalid configs)

Requirements

  • Claude Code must be installed and available in your PATH
  • Node.js 20+ for running the tool
  • Terminal with TTY support for the interactive TUI (falls back to text prompts otherwise)
  • MCP configs should be JSON files in your configured directory (default: ~/.claude/mcp-configs/)

Troubleshooting

"claude command not found" - Ensure Claude Code is installed: which claude

"No MCP configs found" - Check you have *.json files in ~/.claude/mcp-configs/ or your custom directory

Invalid configs - The TUI shows validation errors with details. Common issues:

  • Malformed JSON
  • Missing mcpServers field
  • Invalid server config (missing command for STDIO servers, or url for HTTP/SSE servers)

Note: The type field is optional for server configs and defaults to "stdio" for backward compatibility.

Contributing

Interested in contributing? See DEVELOPMENT.md for:

  • Development setup and scripts
  • Project architecture and structure
  • Build process and CI/CD information
  • Release management and publishing
  • Code style guidelines and contribution workflow