https://github.com/koki-develop/mmcp
🛠️ Manage your MCP (Model Context Protocol) server definitions in one place and apply them to supported agents.
https://github.com/koki-develop/mmcp
Last synced: 4 months ago
JSON representation
🛠️ Manage your MCP (Model Context Protocol) server definitions in one place and apply them to supported agents.
- Host: GitHub
- URL: https://github.com/koki-develop/mmcp
- Owner: koki-develop
- License: mit
- Created: 2025-09-03T07:35:20.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-10-01T09:08:44.000Z (4 months ago)
- Last Synced: 2025-10-01T11:14:25.550Z (4 months ago)
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/mmcp
- Size: 99.6 KB
- Stars: 26
- Watchers: 0
- Forks: 5
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# mmcp
[](https://www.npmjs.com/package/mmcp)
[](https://github.com/koki-develop/mmcp/actions/workflows/release-please.yml)
[](./LICENSE)
Manage your MCP (Model Context Protocol) server definitions in one place and apply them to supported agents.
## Supported Agents
| Agent | id | Config Path |
| --- | --- | --- |
| [Claude Code](https://www.anthropic.com/claude-code) | `claude-code` | `~/.claude.json` |
| [Claude Desktop](https://claude.ai/download) | `claude-desktop` | macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
Windows: `%APPDATA%\Claude\claude_desktop_config.json`
Linux: `~/.config/Claude/claude_desktop_config.json` |
| [Codex CLI](https://developers.openai.com/codex/cli) | `codex-cli` | `~/.codex/config.toml` |
| [Cursor](https://docs.cursor.com/) | `cursor` | `~/.cursor/mcp.json` |
| [Gemini CLI](https://google-gemini.github.io/gemini-cli/) | `gemini-cli` | `~/.gemini/settings.json` |
| [GitHub Copilot CLI](https://github.com/github/copilot-cli) | `github-copilot-cli` | `~/.copilot/mcp-config.json` |
More agents may be added in the future.
## Installation
```bash
npm install -g mmcp
```
## Getting Started
### 1. Add an MCP server to mmcp config
```bash
$ mmcp add [--env KEY=VALUE ...] [--config ] [--force] -- [args...]
# e.g.
$ mmcp add -- context7 npx -y @upstash/context7-mcp@latest
$ mmcp add -- everything npx -y @modelcontextprotocol/server-everything@latest
```
Adds the MCP server definition into `~/.mmcp.json`.
You can check configured servers anytime:
```console
$ mmcp list [--config ]
context7: npx -y @upstash/context7-mcp@latest
everything: npx -y @modelcontextprotocol/server-everything@latest
```
### 2. Choose target agents
Set which agents to apply to (e.g. `claude-code`).
```bash
$ mmcp agents add [--config ]
# e.g.
$ mmcp agents add claude-code
$ mmcp agents add claude-desktop
$ mmcp agents add codex-cli
$ mmcp agents add cursor
$ mmcp agents add gemini-cli
$ mmcp agents add github-copilot-cli
```
List registered agents:
```console
$ mmcp agents list [--config ]
claude-code
claude-desktop
codex-cli
cursor
gemini-cli
github-copilot-cli
```
### 3. Apply your mmcp config to the agents
```console
$ mmcp apply
```
That’s it. Your MCP servers from `~/.mmcp.json` will be written into the agent’s config (e.g. `~/.claude.json` for Claude Code).
## Configuration
mmcp stores configuration as JSON. Default location is `~/.mmcp.json`.
Example:
```json
{
"agents": [
"claude-code",
"claude-desktop",
"codex-cli",
"cursor",
"gemini-cli",
"github-copilot-cli"
],
"mcpServers": {
"context7": {
"command": "npx",
"args": [
"-y",
"@upstash/context7-mcp@latest"
],
"env": {}
},
"everything": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-everything@latest"
],
"env": {}
}
}
}
```
## License
[MIT](./LICENSE)