Claude-Code -Selector
A fast, beautiful TUI for managing MCP (Model Context Protocol) servers in Claude Code. Optimize your context window by enabling only the servers you need, when you need them.
claude mcp add --transport stdio henkisdabro-claude-code-mcp-server-selector npx -y @henkisdabro/mcp-selector
How to use
Claude Code MCP Server Selector is a fast, interactive TUI tool for managing MCP servers used by Claude Code. It discovers all available MCP servers, merges configuration from multiple sources, and lets you enable or disable specific servers with a three-state toggle (RED off, GREEN on, ORANGE available but runtime-disabled). When you start the tool, it launches Claude Code with a minimized context window containing only the selected servers, helping you minimize token waste and improve performance. Use SPACE to toggle servers, and ENTER to save changes and launch Claude Code. The CLI subcommands allow scriptable control (enable/disable, list, and export utilities) and the marketplace integration can install or uninstall plugins directly from the TUI.
You can run the selector via npx (recommended) or install globally with npm. After enabling the desired set of servers, the tool forwards any additional CLI arguments straight to Claude Code, acting as a transparent wrapper. It also detects if you’re running inside a Claude session and provides guidance about when changes take effect.
How to install
Prerequisites:
- Node.js 20 or later
- npm (comes with Node.js) or npx
Installation options:
- Install globally via npm (recommended for frequent use):
npm install -g @henkisdabro/mcp-selector
- Run directly with npx (no installation required):
npx @henkisdabro/mcp-selector
- Verify installation by launching the tool:
mcp --help
Notes:
- The tool is designed to work well with Claude Code and will automatically launch Claude Code with the optimized configuration after you save changes.
- You can pass through additional arguments to Claude Code after configuration; these are forwarded transparently.
Additional notes
Tips and common considerations:
- Enable only 2–3 MCP servers per session to maximize context efficiency and minimize token usage.
- Use the CLI subcommands (enable/disable, --all, --json, --quiet) for automation and scripting scenarios.
- If you’re running inside an active Claude session, changes take effect on the next session restart; you can use /mcp or @mention for immediate toggles.
- The tool supports marketplace plugin discovery and installation from within the TUI (NEW v2.0).
- Ensure you’re using a compatible Claude Code configuration and that MCP servers are discoverable by the selector (it merges 12+ sources with scope precedence).
Related MCP Servers
systemprompt-code-orchestrator
MCP server for orchestrating AI coding agents (Claude Code CLI & Gemini CLI). Features task management, process execution, Git integration, and dynamic resource discovery. Full TypeScript implementation with Docker support and Cloudflare Tunnel integration.
mcp-memory-keeper
MCP server for persistent context management in AI coding assistants
cco
Real-time audit and approval system for Claude Code tool calls.
docmole
Dig through any documentation with AI - MCP server for Claude, Cursor, and other AI assistants
mcp-install-instructions-generator
Generate MCP Server Installation Instructions for Cursor, Visual Studio Code, Claude Code, Claude Desktop, Windsurf, ChatGPT, Gemini CLI and more
mcp-jira-stdio
MCP server for Jira integration with stdio transport. Issue management, project tracking, and workflow automation via Model Context Protocol.