mcp-sync

Sync MCP (Model Context Protocol) configurations across AI tools.

mcp-syncis a command-line tool that helps you manage and synchronize MCP server configurations across different AI coding tools like Claude Desktop, Claude Code, Cline, VS Code extensions, and more.

- Auto-discovery: Automatically finds MCP configs on your system
- Manual registration: Add custom config file locations for future-proofing
- Global & project configs: Supports both user-wide and project-specific servers
- Conflict resolution: Smart merging with project configs taking priority
- Dry-run mode: Preview changes before applying them
- Cross-platform: Works on macOS, Windows, and Linux

uvx mcp-sync status uvx mcp-sync sync --dry-run

uv tool install mcp-sync mcp-sync status

git clone <repo-url> cd mcp-sync ./scripts/setup.sh # Installs dependencies and git hooks automatically

mcp-sync add-server filesystem # Follow prompts to configure

- mcp-sync scan- Auto-discover known MCP configs
- mcp-sync status- Show sync status
- mcp-sync diff- Show config differences

- mcp-sync add-location <path> [--name <alias>]- Register custom config file
- mcp-sync remove-location <path>- Unregister config location
- mcp-sync list-locations- Show all registered config paths

- mcp-sync sync- Sync all registered configs
- mcp-sync sync --dry-run- Preview changes without applying
- mcp-sync sync --global-only- Sync only global configs
- mcp-sync sync --project-only- Sync only project configs
- mcp-sync sync --location <path>- Sync specific location only

- mcp-sync add-server <name>- Add MCP server to sync (interactive prompts)
- mcp-sync add-server <name> --command <cmd> --args <args> --env <vars> --scope <global|project>- Add server with inline parameters
- mcp-sync remove-server <name>- Remove server from sync (interactive prompts)
- mcp-sync remove-server <name> --scope <global|project>- Remove server with inline scope
- mcp-sync list-servers- Show all managed servers

- mcp-sync vacuum- Import MCP servers from discovered configs

- --auto-resolve <first|last>choose conflict resolution automatically
- --skip-existingavoid overwriting servers already in global config

Adding Servers: When adding a server, you need to provide:

- Command: The executable to run (e.g.,python,npx,node)
- Arguments: Command-line arguments (comma-separated, optional)
- Environment: Environment variables asKEY=valuepairs (comma-separated, optional)
- Scope: Whether to add to global config (synced everywhere) or project config (this project only)

mcp-sync add-server filesystem # Prompts for: scope, command, args, env vars

mcp-sync add-server filesystem --command npx --args "-y,@modelcontextprotocol/server-filesystem,/home/user/docs" --scope global

- mcp-sync init- Create project.mcp.json
- mcp-sync template- Show template config

- mcp-sync list-clients- Show all supported clients and their detection status
- mcp-sync client-info [client-id]- Show detailed client information and paths
- mcp-sync edit-client-definitions- Edit user client definitions to add custom clients

mcp-syncuses a three-tier configuration system:
-

Global Config(~/.mcp-sync/global.json)

- Personal development servers
- Synced across all tools

Project Config(.mcp.jsonin project root)

- Project-specific servers
- Version controlled with your project
- Takes priority over global config

Tool Configs(Auto-discovered locations)

- Claude Desktop, VS Code, Cline, etc.
- Updated by sync operations

mcp-sync uses aconfiguration-driven approachto support AI tools and editors. Client definitions are managed through JSON configuration files.

- Claude Desktop- Official Claude Desktop application
- Claude Code- Claude CLI for code editing
- Cline- VS Code extension for AI assistance
- Roo- Roo VS Code extension for AI assistance
- VS Code User Settings- VS Code global user settings
- Cursor- Cursor AI code editor
- Continue- Continue VS Code extension

Runmcp-sync list-clientsto see which clients are detected on your system, ormcp-sync client-info <client-id>for detailed information about specific clients.

Adding custom clients:Users can add their own client definitions by runningmcp-sync edit-client-definitions. This creates~/.mcp-sync/client_definitions.jsonwhere custom client configurations can be added. User definitions take precedence over built-in ones, allowing customization and adding support for new tools without modifying the codebase.

# 1. Initialize project config mcp-sync init # 2. Add project-specific server mcp-sync add-server database # Choose "2. Project config" # Command: python # Args: /path/to/db-server.py # Env: DB_URL=postgresql://... # 3. Add global development server mcp-sync add-server filesystem # Choose "1. Global config" # Command: npx # Args: -y, @modelcontextprotocol/server-filesystem, /home/user # 4. Sync to all tools mcp-sync sync # 5. Check status mcp-sync status

{ "mcpServers": { "filesystem": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "/path/to/directory" ] }, "custom-server": { "command": "python", "args": ["/path/to/server.py"], "env": { "API_KEY": "your-api-key" } } } }

git clone <repo-url> cd mcp-sync uv sync uv pip install -e .

uv run ruff check . # Linting uv run ruff format . # Formatting uv run pytest # Tests (when available)

Tests require the package to be onPYTHONPATH. Either install it in editable mode:

or setPYTHONPATHmanually when invoking pytest:

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Create crafted UI components inspired by the best 21st.dev design engineers.

Bring agent evaluations, observability, and synthetic test set generation directly into your IDE for free with Galileo's new MCP server

An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively .

MCP server for AI Diagram Maker — generate beautiful software engineering diagrams directly inside Cursor, Claude Desktop, Claude Code, or any MCP-compatible AI agent

ALAPI MCP Tools,Call hundreds of API interfaces via MCP

AI-powered SVG animation generator that transforms static files into animated SVG components using the Allyson platform

MCP server that gives AI assistants on-demand access to 1,500+ amCharts docs, ~300 code examples, and 1000+ class API references.

APIMatic MCP Server is used to validate OpenAPI specifications using APIMatic. The server processes OpenAPI files and returns validation summaries by leveraging APIMatic’s API.

One shared context layer for AI agents and humans — live API specs, DB schemas, and versioned contracts across repos so every agent and teammate works from the same source of truth.

Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB