MCP Sync

複数のAIコーディングツール間でMCP（Model Context Protocol）設定を同期するためのCLIツールです。

- Claude Desktop
- Claude Code
- Cline
- Roo Code
- Cursor
- VS Code

- 🔄 双方向同期：マスター設定から各ツールへ、または特定のツールから他のツールへ同期
- 💾 自動バックアップ：変更前に自動的にバックアップを作成
- 🔍 差分検出：変更内容を事前に確認できるドライラン機能
- ⚡ 簡単操作：シンプルなCLIコマンドで操作
- 🛡️ 安全性：設定の検証とエラーハンドリング

# npmでインストール npm install -g mcp-sync # または、リポジトリをクローンして直接使用 git clone https://github.com/sodeyama/sync-mcp-config.git cd sync-mcp-config npm install npm link

これにより、~/.mcp/mcp_settings.jsonにマスター設定ファイルが作成されます。

mcp-sync sync --tool claude cline roo # または claude-code も含める場合 mcp-sync sync --tool claude claude-code cline

mcp-sync restore --tool claude --id claude-claude_desktop_config-2025-01-11T08-30-00-000Z.json

- マスター設定:~/.mcp/mcp_settings.json
- バックアップ:~/.mcp/backups/
- 各ツールの設定:

- Claude Desktop:~/Library/Application Support/Claude/claude_desktop_config.json
- Claude Code:~/.claude.json(mcpServersセクション) ※他の設定と共有されるファイルのため、既存設定は保持されます
- Cline:~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- Roo Code:~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
- Cursor:~/.cursor/mcp.json
- VS Code:~/Library/Application Support/Code/User/settings.json(mcp.serversセクション)

{ "version": "1.0.0", "lastUpdated": "2025-01-11T08:40:00Z", "mcpServers": { "server-name": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-example"], "env": { "API_KEY": "your-api-key" }, "disabled": false, "alwaysAllow": ["tool1", "tool2"], "metadata": { "description": "Example MCP server", "tags": ["example", "demo"] } } }, "globalSettings": { "backupEnabled": true, "syncOnChange": true, "backupRetentionCount": 10, "excludeTools": [] } }

- --verbose,-v: 詳細なログを表示
- --quiet,-q: エラー以外のメッセージを抑制

- init:--force(既存の設定を上書き)
- sync:

- --tool <tools...>(特定のツールのみ同期)
- --source <tool>(マスターではなく特定のツールから同期)
- --dry-run(変更をプレビュー)
- --skip-backup(バックアップをスキップ)
- --force(競合を無視して強制同期)

- --tool <tool>(必須：復元するツール)
- --id <backupId>(特定のバックアップID)
- --list(利用可能なバックアップを一覧表示)

# 権限を確認 ls -la ~/Library/Application\ Support/Claude/ # 必要に応じて権限を変更 chmod 644 ~/Library/Application\ Support/Claude/claude_desktop_config.json

ツールがインストールされていても設定ファイルが存在しない場合があります。その場合は、該当ツールを一度起動してから再試行してください。

複数のツールで異なる設定がある場合、--forceオプションを使用して強制的に同期できます：

Claude Codeは~/.claude.jsonファイルのmcpServersセクションにMCP設定を保存します。このファイルには他の設定（globalShortcut、themeなど）も含まれているため、MCP SyncはmcpServersセクションのみを更新し、他の設定は保持します。

# 全テストを実行 npm test # ウォッチモードでテスト npm run test:watch # カバレッジレポート付きでテスト npm run test:coverage # 特定のテストファイルのみ実行 npm test -- path/to/test.spec.ts

# Lintを実行 npm run lint # コードフォーマット npm run format

プルリクエストを歓迎します！バグ報告や機能リクエストはIssuesまでお願いします。

A lightweight, extensible MCP server for running prompt-based tools and file utilities, with support for custom prompts.