claudex

Interactive MCP server selector for the Claude CLI. Pick which servers to enable before each session, with per-directory memory and full CLI management.

Usage

npx @appkit/claudex          # select servers, then launch claude
npx @appkit/claudex -c       # select servers, then continue last session

Your selection is remembered per directory — different projects can have different defaults.

Managing MCP Servers

Claudex owns its own server config at ~/.claudex/mcp.json. Use the built-in mcp subcommand to manage it:

claudex mcp list                            # list all servers with status
claudex mcp add <name> <command> [args...]  # add a stdio server
claudex mcp add <name> --url <url>          # add an http/sse server
claudex mcp remove <name>                   # remove a server

Options for mcp add:

• -e KEY=VALUE — set an environment variable (repeatable)
• --url <url> — add an HTTP or SSE server (auto-detects SSE from /sse in URL)
• --disabled — add the server but leave it disabled by default

Examples:

# stdio server
claudex mcp add puppeteer npx -y @modelcontextprotocol/server-puppeteer

# http server, disabled by default
claudex mcp add context7 --url https://mcp.context7.com/mcp --disabled

# with env vars
claudex mcp add my-server -e API_KEY=abc123 node /path/to/server.js

How It Works

1. On first run, migrates servers from ~/.claude.json into ~/.claudex/mcp.json
2. Shows a checkbox list pre-checked from the current directory's last selection (falls back to global enabled list)
3. Saves your selection for the current directory
4. Writes a temp config with only the selected servers
5. Launches claude --strict-mcp-config --mcp-config <tempfile> with your args passed through
6. Cleans up the temp file on exit