MMCP

v1.0.0โ€ขDeveloper Toolsโ€ขstable

๐Ÿ› ๏ธ Manage your MCP (Model Context Protocol) server definitions in one place and apply them to supported agents.

mmcpmcpai-integration
Share:
40
Stars
0
Downloads
0
Weekly
0/5

What is MMCP?

MMCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ๐Ÿ› ๏ธ manage your mcp (model context protocol) server definitions in one place and apply them to supported agents.

๐Ÿ› ๏ธ Manage your MCP (Model Context Protocol) server definitions in one place and apply them to supported agents.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • ๐Ÿ› ๏ธ Manage your MCP (Model Context Protocol) server definitio

Use Cases

Centrally manage all MCP (Model Context Protocol) server definitions and apply them consistently across supported AI agents.
koki-develop

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedApr 27, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mmcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MMCP

mmcp is a CLI tool that lets you define your MCP server configurations once in a central ~/.mmcp.json file and then apply them consistently to all supported AI agents โ€” Claude Desktop, Claude Code, Cursor, Codex CLI, Gemini CLI, and GitHub Copilot CLI โ€” with a single command. Instead of manually editing each agent's config file when you add or update an MCP server, mmcp handles the synchronization in merge or replace mode. Developers who use multiple AI coding tools and want a DRY, version-controllable approach to MCP server management will find it a significant time-saver.

Prerequisites

  • Node.js 18+ and npm installed
  • mmcp installed globally via npm
  • At least one supported AI agent installed (Claude Desktop, Claude Code, Cursor, etc.)
  • MCP servers you want to manage already configured or known
1

Install mmcp globally via npm

Install the mmcp CLI tool globally so it is available from anywhere in your terminal.

npm install -g mmcp
2

Add an MCP server definition to mmcp

Use the mmcp add command to register an MCP server. The -- separator precedes the server name and its launch command. Use --env to pass environment variables.

mmcp add -- context7 npx -y @upstash/context7-mcp@latest
mmcp add --env GITHUB_TOKEN=your_token -- github npx -y @modelcontextprotocol/server-github
3

List configured servers and agents

Verify that your server definitions are stored correctly and see which agents are targeted.

mmcp list
mmcp agents list
4

Add target AI agents

Tell mmcp which agents should receive the server configurations when you apply. Use the agent ID strings from the supported agents table.

mmcp agents add claude-desktop claude-code cursor
5

Apply configurations to all target agents

Push your mmcp server definitions to all registered agents. Use --mode merge to add to existing configs or --mode replace to overwrite them entirely.

mmcp apply --mode merge

MMCP Examples

Client configuration

Example ~/.mmcp.json showing two MCP servers and two target agents.

{
  "mode": "merge",
  "agents": ["claude-desktop", "claude-code"],
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "your_github_token"
      }
    }
  }
}

Prompts to try

CLI commands to manage your MCP server fleet with mmcp.

- mmcp list  (see all defined servers)
- mmcp agents list  (see which agents are targeted)
- mmcp add -- myserver npx -y some-mcp-package  (add a new server)
- mmcp apply --mode merge  (push config to all agents)
- mmcp apply --mode replace  (overwrite agent configs entirely)

Troubleshooting MMCP

mmcp apply does not update Claude Desktop config

Verify Claude Desktop is listed in your agents with mmcp agents list. If not, run mmcp agents add claude-desktop. Also confirm the config file path is accessible โ€” on macOS it should be ~/Library/Application Support/Claude/claude_desktop_config.json.

Server definition is not saved after mmcp add

Ensure you have write permission to ~/.mmcp.json. If the file doesn't exist yet, mmcp will create it on first use. If permission is denied, run chmod 644 ~/.mmcp.json or recreate it.

Merge mode overwrites existing server entries instead of adding

Merge mode adds new keys and updates existing ones by server name. If an existing agent config already has a server with the same name, mmcp will overwrite that specific entry. Use different names in mmcp.json if you need to preserve a different variant.

Frequently Asked Questions about MMCP

What is MMCP?

MMCP is a Model Context Protocol (MCP) server that ๐Ÿ› ๏ธ manage your mcp (model context protocol) server definitions in one place and apply them to supported agents. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MMCP?

Follow the installation instructions on the MMCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MMCP?

MMCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MMCP free to use?

Yes, MMCP is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mmcp": { "command": "npx", "args": ["-y", "mmcp"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide โ†’

Ready to use MMCP?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides