@getmcp/cli

CLI tool to install MCP servers into any AI application with one command. Auto-detects installed apps, generates the correct config format, and merges it into existing config files without overwriting.

Install

# Run directly with npx (no install needed)
npx @getmcp/cli add github

# Or install globally
npm install -g @getmcp/cli

Commands

`getmcp add [server-id]`

Install an MCP server into your AI apps.

# Interactive mode — select a server and target apps
getmcp add

# Install a specific server
getmcp add github

# Install with environment variables prompted interactively
getmcp add brave-search
# => Prompts: Enter BRAVE_API_KEY: ****

The add command will:

Look up the server in the built-in registry
Auto-detect which AI apps you have installed
Ask which apps you want to configure (or configure all)
Prompt for any required environment variables
Generate the correct config format for each app
Merge the config into each app's config file (never overwrites existing servers)

`getmcp remove <server-name>`

Remove an MCP server from your AI app configs.

getmcp remove github

`getmcp list`

Browse the server registry.

# List all available servers
getmcp list

# Search for servers
getmcp list --search=database

# Filter by category
getmcp list --category=developer-tools

# List servers installed in your detected apps
getmcp list --installed

Supported Apps

The CLI auto-detects and generates configs for:

App	Config Location
Claude Desktop	`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS), `%AppData%\Claude\claude_desktop_config.json` (Windows)
Claude Code	`.mcp.json` (project), `~/.claude.json` (user)
VS Code / Copilot	`.vscode/mcp.json`
Cursor	`.cursor/mcp.json`
Cline	`cline_mcp_settings.json` (VS Code globalStorage)
Roo Code	`mcp_settings.json` (VS Code globalStorage)
Goose	`~/.config/goose/config.yaml`
Windsurf	`~/.codeium/windsurf/mcp_config.json`
OpenCode	`opencode.json`
Zed	`settings.json` (Zed settings)

Programmatic API

The CLI also exports its functions for use as a library:

import {
  detectApps,
  detectInstalledApps,
  readConfigFile,
  writeConfigFile,
  mergeServerIntoConfig,
  removeServerFromConfig,
  listServersInConfig,
} from "@getmcp/cli";

// Detect which apps are installed
const apps = await detectInstalledApps();

// Read an app's config file
const config = await readConfigFile("/path/to/config.json");

// Merge a new server into an existing config
const updated = mergeServerIntoConfig(config, "github", serverConfig, "claude-desktop");

// Write back (preserves existing content)
await writeConfigFile("/path/to/config.json", updated);

Options

getmcp --help       Show help message
getmcp --version    Show version number

License

MIT