mmcp

mmcp is a utility to manage MCP (Model Context Protocol) server definitions in one place and apply them to supported agents. It lets you add MCP server definitions, choose which agents you want to target, and then apply those definitions so each agent’s local config is updated accordingly. The tool supports a variety of agents (e.g., Claude Code, Claude Desktop, Codex CLI, Cursor, Gemini CLI, GitHub Copilot CLI) and writes the server definitions into the appropriate agent configuration files when you run apply. The included servers (context7 and everything) demonstrate how an MCP server is defined and stored in the mmcp configuration.

After adding servers with mmcp add, you can list them with mmcp list to review what’s configured. Then you select one or more agents with mmcp agents add and finally run mmcp apply to push the MCP server definitions into each chosen agent’s config. The apply process supports merge or replace modes, giving you control over how existing agent entries are updated.

For example, you can define a server such as context7 and have mmcp place its definition into each agent’s config, so the agent can start referencing the MCP server when executing through its own tooling.

Prerequisites:

• Node.js and npm installed on your system
• Internet access to install packages from npm registry

Installation steps:

1. Install mmcp globally

npm install -g mmcp

2. Verify installation

mmcp --version

3. Initialize or verify your mmcp config (default location is ~/.mmcp.json). You can start by listing available commands and then adding servers as shown in the example below.

Tips and notes:

• Default configuration location is ~/.mmcp.json for mmcp and ~/.mmcp.json for your saved servers. You can specify a custom path with the --config option when running commands.
• The mcpServers entries define how each MCP server is launched. The command is typically npx (as shown in the examples) with an exact server package and version, but you can customize to other launch methods if needed.
• Apply modes: merge (default) will add or update entries without removing other agent configs; replace will wipe existing agent entries and recreate from mmcp.
• Env vars for individual MCP servers can be added under the env object for each server, if the server requires specific environment configuration.
• Supported agents include claude-code, claude-desktop, codex-cli, cursor, gemini-cli, and github-copilot-cli. Ensure you have the corresponding agent installed and configured before applying.
• If you run into permissions issues on macOS or Linux, you may need to adjust file permissions or use sudo sparingly, though mmcp itself should not require elevated privileges for normal usage.