gmcp - Global MCP Config Manager

Report issues/bug: https://www.surveymonkey.com/r/3QJQYDG

Manage MCP (Model Context Protocol) server configurations across Claude Code, Copilot CLI, and Windsurf from a single command-line interface. Stop manually editing config files for each platform.

Installation

npm install -g @evolvedqube/gmcp

Quick Start

# First time setup - select your platforms, or add more platforms later
gmcp init

# Browse available servers
gmcp market

# Add a server to all configured platforms
gmcp add fetch

# See what's installed
gmcp list

# Remove a server
gmcp remove fetch

# Update gmcp
gmcp update

Supported Platforms

• Claude Code (~/.claude.json)
• Copilot CLI (~/.copilot/mcp-config.json)
• Windsurf (~/.codeium/windsurf/mcp_config.json)

All Commands

gmcp init

Interactive setup to select which platforms you want to manage. Run again to add more platforms at any time.

gmcp init

gmcp platforms

Display configured platforms and their detection status.

gmcp platforms

gmcp market

Browse all available MCP servers from the registry. Results paginate in groups of 20.

gmcp market

gmcp search <query>

Search for a server by name.

gmcp search github
gmcp search filesystem
gmcp search database

gmcp add <name>

Add a server to your configured platforms.

# Add to all configured platforms
gmcp add fetch

# Add to specific platforms only
gmcp add github --only claude-code,windsurf

If a server offers multiple runtimes (npm or Docker), you'll be prompted to choose:

This server offers multiple runtimes:
  1. npm (via npx)
  2. Docker (via OCI)

Select runtime: _

gmcp add --manual

Add a custom server that's not in the registry. You'll be prompted for the server details.

gmcp add --manual

Interactive flow:

Server name: my-custom-server
Command: npx
Arguments: @myorg/custom-server

This adds your custom server to all configured platforms. To target specific platforms:

gmcp add --manual --only claude-code,windsurf

Use cases:

• Internal company MCP servers
• Local development servers
• Servers from private registries
• Experimental or forked servers

gmcp remove <name>

Remove a server from your platforms (with confirmation).

# Remove from all platforms
gmcp remove fetch

# Remove from specific platforms only
gmcp remove github --only claude-code

gmcp list

View all installed servers and their status on each platform.

gmcp list

Output example:

MCP Servers:

Server       Claude Code  Copilot CLI  Windsurf
─────────────────────────────────────────────────
fetch        active       active       —
github       active       —            active
filesystem   disabled     active       active

gmcp sync

Sync servers across platforms. Shows servers installed on some platforms but missing on others, then lets you selectively add them everywhere. Safe to run multiple times.

gmcp sync

gmcp enable <name> / gmcp disable <name>

Enable or disable a server on your platforms.

gmcp enable fetch
gmcp disable github

Note: Only Windsurf fully supports the disable flag. Other platforms will ignore it.

gmcp update

Update gmcp to the latest version.

gmcp update

Important: Server Names

Server names in the registry are automatically cleaned up for cross-platform compatibility:

• io.github.upstash/context7 → context7
• ai.smithery/example-server → example-server
• server.name → server-name

Always use the cleaned name when removing or managing servers:

gmcp add io.github.upstash/context7  # Adds as "context7"
gmcp list                             # Shows "context7"
gmcp remove context7                  # Use the cleaned name

Requirements

• Network access required for: add, search, market commands
• Offline OK for: list, remove, sync, enable, disable commands

gmcp fetches server data from the official MCP Registry API. Ensure you have an active internet connection for registry operations.

Supported Runtimes

Servers can run via:

• npm (npx) - Installed via npm registry
• Docker - Runs as OCI container

gmcp will prompt you to choose if a server supports both options.

Troubleshooting

Cannot reach the MCP Registry API

Error: Cannot reach MCP Registry API. Check your internet connection.

Ensure you have internet access and the API is reachable.

Registry API temporarily unavailable

Error: Registry API is temporarily unavailable. Try again later.

Try again in a few moments.

Works offline

Commands that don't need the registry (list, remove, sync, enable, disable) work without internet.

License

MIT