A cross-platform desktop app for managing MCP server configs across Claude Code, Codex, Cursor, VS Code, OpenCode, Gemini CLI, and more.
Overview
A cross-platform desktop app for managing MCP server configs across Claude Code, Codex, Cursor, VS Code, OpenCode, Gemini CLI, and more. English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Italiano · Português · Русский - for every MCP server, imported from the configs your clients already have - : find servers in the GitHub MCP Registry, the official MCP Registry, or any compatible registry, and add them in a few clicks - editing - , with a review of risky writes, automatic backups, and rollback - Light / dark theme, and a UI in 11 languages that follows your system language Download the package for your platform from the latest release: Pick arm64 / aarch64 for Apple Silicon and ARM devices, x64 / x86_64 / amd64 otherwise. macOS says the app is damaged or can't be opened? Release builds are ad-hoc signed but not notarized by Apple yet. On first launch: 1. Move the app to /Applications and open it; click on the warning. 2.
README
MCP Manager
A cross-platform desktop app for managing MCP server configs across Claude Code, Codex, Cursor, VS Code, OpenCode, Gemini CLI, and more.
English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Italiano · Português · Русский
Download MCP Manager
Table of Contents
- Features
- Installation
- Supported Clients
- Command Line (Preview)
- Privacy & Network
- Development
- Star History
- Disclaimer
Features
- One workspace for every MCP server, imported from the configs your clients already have
- Online marketplace: find servers in the GitHub MCP Registry, the official MCP Registry, or any compatible registry, and add them in a few clicks
- Form or raw JSON editing
- Apply to many clients at once, with a review of risky writes, automatic backups, and rollback
- Light / dark theme, and a UI in 11 languages that follows your system language
Installation
Download the package for your platform from the latest release:
| Platform | Package |
|---|---|
| macOS | .dmg, or brew install --cask xjeway/mcp-manager/mcp-manager |
| Windows | setup.exe (x64 / arm64) or .msi (x64) |
| Linux | .deb, .rpm, or .AppImage |
Pick arm64 / aarch64 for Apple Silicon and ARM devices, x64 / x86_64 / amd64 otherwise.
Supported Clients
Every client below supports both import (read existing MCP servers from its config) and apply (write the unified config back).
Claude Code Claude Desktop Codex Cursor OpenCode GitHub Copilot Gemini CLI Antigravity iFlow Qwen Code Cline Devin (Desktop / CLI) Kiro Qoder Kilo Code Factory Droid Kimi CLI Zed Mistral Vibe Hermes Agent Goose Amp Grok Build VS Code
Command Line (Preview)
mcpmgr shares the desktop app’s server list, so changes made in either show up in the other.
npx @mcpmgr/cli list # or: npm i -g @mcpmgr/cli / brew install xjeway/mcp-manager/mcpmgr
mcpmgr add context7 -- npx -y @upstash/context7-mcp@latest
mcpmgr add linear --url https://mcp.linear.app/mcp -a cursor,claude-code
mcpmgr remove context7 -a codex
mcpmgr rollback
In a terminal, add walks you through servers, clients and scope, and previews every file before writing. Each step also has a flag (--yes, --dry-run, --json, …); inside an AI coding agent such as Claude Code or Codex, it skips the prompts and targets that agent’s client.
Privacy & Network
MCP Manager only goes online to check for updates and, while the marketplace page is open, to query MCP registries (cached for 6 hours, usable offline). Turn the marketplace off under Settings → Online marketplace to stop those requests entirely.
Development
Requires Node.js 20+, Rust stable, and the Tauri prerequisites for your platform.
make install # install dependencies
make tauri-dev # run the desktop app
make test && make check
The core logic (client adapters, parsing, safe writes) lives in crates/mcp-manager-core, shared by the Tauri app in src-tauri/ and the CLI in crates/mcp-manager-cli/. Releases are described in docs/releasing.md.
Issues and pull requests are welcome; for larger changes, please open an issue first. When changing user-facing docs, keep README.md, README.zh-CN.md, and docs/readme/ in sync.
Star History
Disclaimer
This project is developed primarily with AI assistance and reviewed by a human maintainer, so it may still contain mistakes. MCP Manager rewrites other tools’ config files; backups and rollback are built in, but keep your own backups of important configs. Provided “as is” under the MIT License.
Install
npx @mcpmgr/cli list # or: npm i -g @mcpmgr/cli / brew install xjeway/mcp-manager/mcpmgr