MCP Sync

mcp-sync is an MCP server configuration utility and CLI tool that synchronizes Model Context Protocol server settings across various AI coding assistants and environments. It connects configurations used in tools such as Claude Desktop, Claude Code, Cline, Roo, VS Code User Settings, Cursor, and Continue. Software engineers and AI developers use it to maintain a consistent set of MCP servers across multiple development interfaces without manually copying JSON blocks into every client-specific configuration file. The tool supports auto-discovery of existing client configuration paths, a three-tier hierarchy separating global developer tools from version-controlled project settings, and conflict resolution mechanisms. It allows users to manage executables, arguments, and environment variables centrally, run dry-run simulations to preview changes, vacuum settings from existing clients into a shared registry, and define custom client locations through user configuration files.

Category: AI & LLM Tooling

Tags: configuration, deployment, management, sync

Visit MCP Sync

How to install and configure MCP Sync

1. Run the tool on demand using uvx mcp-sync status or install it persistently using uv tool install mcp-sync. 2. Scan your machine to auto-discover existing MCP client configurations by running mcp-sync scan. 3. Add servers interactively using mcp-sync add-server <name> or with command arguments such as mcp-sync add-server filesystem --command npx --args "-y,@modelcontextprotocol/server-filesystem,/home/user/docs" --scope global. 4. Initialize a project-level configuration file if needed using mcp-sync init. 5. Preview updates with mcp-sync sync --dry-run and apply synchronization across all detected clients using mcp-sync sync.

What you can do with MCP Sync

• Synchronizing global development MCP servers across Claude Desktop, Cursor, and VS Code extensions simultaneously from a single central configuration.

Key facts

• https://github.com/ztripez/mcp-sync
• AI & LLM Tooling, Developer Tools & Code Intelligence
• configuration, deployment, management, sync

Part of MCP Servers

What can mcp-sync do?

mcp-sync provides a command-line interface to manage and replicate MCP server configurations across multiple AI coding clients. It auto-discovers client settings, provides a three-tier configuration hierarchy between global and project levels, previews differences via dry-run mode, and vacuums existing settings into a single source.

How do I install mcp-sync?

You can use mcp-sync without a persistent setup by running uvx mcp-sync followed by a command. For a permanent installation, execute uv tool install mcp-sync via the uv package manager. Developers can also clone the repository and run the setup script.

Which MCP clients work with mcp-sync?

mcp-sync includes built-in detection for Claude Desktop, Claude Code, Cline, Roo, Cursor, Continue, and VS Code User Settings. Users can also register additional paths or edit custom client definitions via the edit-client-definitions command.

How does mcp-sync handle configuration priority?

The utility uses a three-tier system comprising a global configuration file, project-level dot-mcp files in the project root, and target tool configurations. Project-level configurations take priority over global configurations during merges, allowing repository-specific tools to override general user settings.