A CLI tool to synchronize MCP (Model Context Protocol) settings across multiple AI coding tools.
複数のAIコーディングツール間でMCP(Model Context Protocol)設定を同期するための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/
~/Library/Application Support/Claude/claude_desktop_config.json
~/.claude.json
(mcpServersセクション) ※他の設定と共有されるファイルのため、既存設定は保持されます~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
~/.cursor/mcp.json
~/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
: エラー以外のメッセージを抑制--force
(既存の設定を上書き)--tool <tools...>
(特定のツールのみ同期)--source <tool>
(マスターではなく特定のツールから同期)--dry-run
(変更をプレビュー)--skip-backup
(バックアップをスキップ)--force
(競合を無視して強制同期)--tool <tools...>
(特定のツールのみバックアップ)--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.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までお願いします。
The official Plane MCP server provides integration with Plane APIs, enabling full AI automation of Plane projects, work items, cycles and more.
A CalDAV MCP server to expose calendar operations as tools for AI assistants.
MCP server for the incident management platform Rootly.
Interact with the HireBase Job API to manage job listings and applications.
Transcribe YouTube videos in multiple languages.
AI-powered task orchestration and workflow automation with specialized agent roles, intelligent task decomposition, and seamless integration across Claude Desktop, Cursor IDE, Windsurf, and VS Code.
Interact with your Obsidian vault from your IDE or Claude Desktop.
Manages configurations for MCP clients, automatically detecting file paths based on OS and client.
Interact with your Obsidian vault using natural language.
Connect your Limitless Pendant data to Claude and other LLMs using the Limitless API.