Labsco
sodeyama logo

MCP Sync

★ 1

from sodeyama

A CLI tool to synchronize MCP (Model Context Protocol) settings across multiple AI coding tools.

🔥🔥🔥✓ VerifiedAccount requiredNeeds API keys
#git

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 <tools...> (特定のツールのみ同期)
    • --source <tool> (マスターではなく特定のツールから同期)
    • --dry-run (変更をプレビュー)
    • --skip-backup (バックアップをスキップ)
    • --force (競合を無視して強制同期)
  • backup: --tool <tools...> (特定のツールのみバックアップ)
  • restore:
    • --tool <tool> (必須：復元するツール)
    • --id <backupId> (特定のバックアップ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までお願いします。