vek-sync

One config file. Every editor. Always in sync.

vek-sync is a zero-dependency CLI that keeps your MCP (Model Context Protocol) server configurations in sync across every AI editor — Claude Desktop, Cursor, VS Code, Windsurf, Claude Code, Cline, Roo Code, Gemini CLI, GitHub Copilot, Continue, and Codex. No account. No cloud. Just a single .mcp.json file and one command.

Define your servers once. Push to every editor. Pull from any editor to bootstrap. Ping servers to verify they're alive. Share configs via URL. Store secrets safely in an encrypted local vault.

Install

npm install -g @vektormemory/vek-sync

Quick start

# Bootstrap from an existing editor
vek-sync init --from cursor

# Preview what sync will change
vek-sync sync --dry-run

# Push to all editors
vek-sync sync

# Verify servers are actually running
vek-sync ping

The .mcp.json file

Commit this to your repo (secrets use vault refs, never plaintext):

{
  "mcpSync": {
    "version": "1.0",
    "description": "My MCP servers"
  },
  "servers": {
    "my-server": {
      "command": "node",
      "args": ["/path/to/server.mjs", "mcp"],
      "env": {
        "API_KEY": "vault:my-api-key"
      }
    },
    "my-sse-server": {
      "url": "https://my-server.example.com/sse",
      "headers": {
        "Authorization": "vault:my-auth-token"
      }
    }
  }
}

Commands

`vek-sync init`

Create a fresh .mcp.json in the current directory. Use --from to bootstrap from an installed editor, or --from-url to pull a shared config.

vek-sync init
vek-sync init --description "My project MCP servers"
vek-sync init --from cursor
vek-sync init --from-url https://paste.rs/abc123

`vek-sync sync`

Push .mcp.json → all installed editors. Safe — never wipes existing non-MCP config keys. Backs up each editor config before writing. Use --dry-run to preview changes without touching anything.

vek-sync sync
vek-sync sync --dry-run
vek-sync sync --only claudeDesktop,cursor
vek-sync sync --watch                        # re-sync on .mcp.json change

`vek-sync add`

Interactive wizard to add a new MCP server to .mcp.json. Searches the curated registry and npm, lets you pick, fills in env keys, stores secrets in the vault.

vek-sync add
vek-sync add github

`vek-sync ping`

Spawn each configured server and verify it responds to an MCP initialize handshake. HTTP servers are checked with a GET request.

vek-sync ping
vek-sync ping --only my-server

`vek-sync search`

Search the curated registry and npm for MCP servers by keyword.

vek-sync search postgres
vek-sync search slack

`vek-sync share`

Upload your .mcp.json to paste.rs and get a shareable URL. Secrets are stripped before upload.

vek-sync share

`vek-sync profile`

Manage named profiles inside .mcp.json. Switch between different sets of servers for different projects or environments.

vek-sync profile list
vek-sync profile use work
vek-sync profile save personal

`vek-sync export`

Pull MCP servers from all installed editors → .mcp.json. Merges, never overwrites.

vek-sync export
vek-sync export --only windsurf

`vek-sync status`

Show which editors are installed and how many servers each has.

vek-sync status

`vek-sync diff`

Show drift between .mcp.json and what's actually in each editor. Exits non-zero if drift detected — useful in CI.

vek-sync diff

`vek-sync vault`

Store secrets encrypted on disk, machine-bound with AES-256-GCM. Reference them in .mcp.json as vault:key-name.

No account required. The vault is local-only — secrets are encrypted on your machine and never leave it.

vek-sync vault set my-api-key sk-abc123
vek-sync vault get my-api-key
vek-sync vault list
vek-sync vault delete my-api-key

Vault files live in ~/.vek-sync/ with permissions set to 600. The encryption key is derived from your machine identity — secrets encrypted on one machine cannot be read on another.

Supported editors

| Editor | Config location | Notes | |---|---|---| | Claude Desktop | %APPDATA%/Claude/claude_desktop_config.json | Windows / macOS / Linux | | Cursor | ~/.cursor/mcp.json | Global scope | | VS Code | .vscode/mcp.json | Workspace-scoped | | Windsurf | ~/.codeium/windsurf/mcp_config.json | — | | Claude Code | ~/.claude/claude_desktop_config.json | Same format as Claude Desktop | | Cline | %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/… | VS Code extension | | Roo Code | %APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/… | VS Code extension | | Gemini CLI | ~/.gemini/settings.json | — | | GitHub Copilot | ~/.copilot/mcp-config.json | — | | Continue | ~/.continue/config.json | Array format, auto-converted | | Codex | ~/.codex/config.toml | TOML format, auto-converted |

Options

| Flag | Description | |---|---| | --file <path> | Path to .mcp.json (default: walks up from cwd) | | --only <name,...> | Limit command to specific connector(s) | | --dry-run | Preview changes without writing anything | | --watch | Re-sync automatically when .mcp.json changes | | --from <editor> | Bootstrap init from an installed editor | | --from-url <url> | Bootstrap init from a shared paste URL | | --description <text> | Description text for init |

Connector names: claudeDesktop, cursor, vscode, windsurf, claudeCode, cline, rooCode, gemini, copilot, continue_, codex

Design

Zero dependencies — pure Node.js ESM, no npm install step, no native addons
Secrets never in plaintext — vault:key-name refs resolved at runtime, never written to editor configs as raw values
Backup before write — every sync backs up the target config to ~/.vek-sync/backups/<timestamp>/ first
Non-destructive writes — sync merges into existing editor configs, preserving all non-MCP keys
Standalone connectors — each connector is self-contained with no shared runtime state
CI-friendly — diff exits non-zero on drift; --dry-run lets you validate without side effects

License

Apache-2.0

MCP Servers