MCP Sync
Sync MCP (Model Context Protocol) configurations across AI tools
What is MCP Sync?
MCP Sync is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to sync mcp (model context protocol) configurations across ai tools
Sync MCP (Model Context Protocol) configurations across AI tools
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Sync MCP (Model Context Protocol) configurations across AI t
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-syncConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP Sync
MCP Sync is a command-line tool that synchronizes Model Context Protocol server configurations across multiple AI clients — Claude Desktop, Claude Code, Cline, Roo, VS Code, Cursor, and Continue. Instead of manually editing each client's JSON config when you add or update an MCP server, mcp-sync merges a single source of truth into all detected client configs automatically. Developers use it to keep their MCP server setup consistent across tools without repetitive copy-paste.
Prerequisites
- Python 3.12 or higher
- uv package manager (https://astral.sh/uv)
- At least one MCP-compatible client installed (Claude Desktop, Cursor, VS Code, etc.)
- The MCP server configurations you want to sync already defined or ready to add
Install mcp-sync
Install mcp-sync as a persistent uv tool so it is available globally.
uv tool install mcp-syncCheck the current sync status
Run status to see which MCP clients are detected on your system and what configurations are present.
mcp-sync statusAdd an MCP server to sync
Use add-server to register a server that will be propagated to all supported clients. Specify the command, arguments, and any required environment variables.
mcp-sync add-server filesystem \
--command npx \
--args "-y,@modelcontextprotocol/server-filesystem,/home/user"Preview the sync with dry-run
Run a dry-run to see exactly what changes will be made to each client's config file before committing.
mcp-sync sync --dry-runApply the sync
Run sync without the dry-run flag to write the configurations to all detected clients. Project-level configs take priority over global configs in the three-tier system.
mcp-sync syncList all detected clients
Verify which clients were found and updated after syncing.
mcp-sync list-clientsMCP Sync Examples
Client configuration
Global mcp-sync config file at ~/.mcp-sync/global.json defining a server to sync to all clients.
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/home/user"],
"env": {}
}
}
}Prompts to try
Command patterns for common mcp-sync workflows.
- "mcp-sync status" — see all detected clients and their current configs
- "mcp-sync sync --dry-run" — preview what would change before applying
- "mcp-sync sync" — apply configs to all detected clients
- "mcp-sync list-clients" — list all supported clients found on the system
- "mcp-sync edit-client-definitions" — customize which clients are targeted
- "mcp-sync add-server myserver --command python --args '-m,myserver'" — add a new serverTroubleshooting MCP Sync
mcp-sync status shows no clients detected
mcp-sync auto-discovers clients by looking for their config files in standard locations. Ensure at least one client (Claude Desktop, Cursor, VS Code) is installed with its default config directory. You can also edit ~/.mcp-sync/client_definitions.json to add custom paths.
uvx mcp-sync command not found after installation
Ensure uv is installed and its bin directory is in your PATH. Run `which uv` to verify, then try `uv tool install mcp-sync` again and open a new terminal session.
Project config overrides global config unexpectedly
mcp-sync uses a three-tier priority system: project .mcp.json > global ~/.mcp-sync/global.json. If a project directory contains a .mcp.json, its servers take precedence. Run `mcp-sync sync --dry-run` to inspect the merge result before applying.
Frequently Asked Questions about MCP Sync
What is MCP Sync?
MCP Sync is a Model Context Protocol (MCP) server that sync mcp (model context protocol) configurations across ai tools It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP Sync?
Follow the installation instructions on the MCP Sync GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCP Sync?
MCP Sync works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP Sync free to use?
Yes, MCP Sync is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
MCP Sync Alternatives — Similar Developer Tools Servers
Looking for alternatives to MCP Sync? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
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.
Set Up MCP Sync in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP Sync?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.