MCP Sync - MCP設定同期ツール

複数の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-sync init

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

同期

マスター設定から全ツールに同期

mcp-sync sync

特定のツールのみ同期

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

特定のツールから他のツールに同期

mcp-sync sync --source claude

ドライラン（変更内容の確認）

mcp-sync sync --dry-run

強制同期（競合を無視）

mcp-sync sync --force

バックアップ

全ツールの設定をバックアップ

mcp-sync backup

特定のツールのみバックアップ

mcp-sync backup --tool claude cline

復元

最新のバックアップから復元

mcp-sync restore --tool claude

特定のバックアップから復元

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

利用可能なバックアップを確認

mcp-sync restore --tool claude --list

ステータス確認

現在の同期状態と設定情報を表示：

mcp-sync status

詳細なログを表示する場合：

mcp-sync status --verbose

設定編集

マスター設定ファイルをエディタで開く：

mcp-sync edit

設定ファイルの場所

• マスター設定: `~/.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 ` (特定のツールのみ同期)
  • `--source ` (マスターではなく特定のツールから同期)
  • `--dry-run` (変更をプレビュー)
  • `--skip-backup` (バックアップをスキップ)
  • `--force` (競合を無視して強制同期)
• backup: `--tool ` (特定のツールのみバックアップ)
• restore:
  • `--tool ` (必須：復元するツール)
  • `--id ` (特定のバックアップID)
  • `--list` (利用可能なバックアップを一覧表示)

トラブルシューティング

権限エラー

設定ファイルへの書き込み権限がない場合は、以下を確認してください：

# 権限を確認
ls -la ~/Library/Application\ Support/Claude/

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

設定ファイルが見つからない

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

同期の競合

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

mcp-sync sync --force

Claude Codeの設定について

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

開発

ビルド

npm run build

テスト

# 全テストを実行
npm test

# ウォッチモードでテスト
npm run test:watch

# カバレッジレポート付きでテスト
npm run test:coverage

# 特定のテストファイルのみ実行
npm test -- path/to/test.spec.ts

開発モード

npm run dev

コード品質

# Lintを実行
npm run lint

# コードフォーマット
npm run format

ライセンス

MIT License

貢献

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