iflow-mcp_richblack-syncmcp

# SyncMCP - MCP 配置同步工具 🚀 [](https://github.com/yourusername/syncmcp) [](https://www.python.org/) [](LICENSE) 智能化的 MCP (Model Context Protocol) 配置同步工具，讓您輕鬆管理多個 AI 客戶端的配置。 > 🤖 100% 由 Claude 開發，持續進化中 ## ✨ 特色 - 🔄 **智能同步** - 自動選擇最新配置，一鍵同步所有客戶端 - 💾 **自動備份** - 每次同步前自動備份，安全無憂 - 🎨 **互動介面** - 友善的 Terminal UI，非技術用戶也能輕鬆使用 - 🤖 **MCP Server** - 作為 MCP Server，讓 Claude 幫您管理配置 - 🌍 **全局命令** - 安裝後可在任何位置執行 - 🔍 **差異偵測** - 智能分析配置差異，提供清晰報告 - 🛡️ **錯誤回滾** - 同步失敗時自動恢復備份 ## 📖 目錄 - [問題與解決方案](#問題與解決方案) - [快速開始](#-快速開始) - [支援的客戶端](#支援的客戶端) - [主要功能](#-主要功能) - [使用方法](#使用方法) - [文檔](#-文檔) - [常見問題](#-常見問題) - [開發路線圖](#-開發路線圖) - [貢獻](#-貢獻) --- ## 問題與解決方案 ### 問題 每個 AI Agent（Claude Desktop、Claude Code、Roo Code、Gemini CLI）都有各自的 MCP Server 配置文件。當您在一個客戶端安裝或修改 MCP 時，其他客戶端不會自動同步，導致： - ❌ 配置不一致 - ❌ 需要手動複製配置 - ❌ 容易出錯且繁瑣 - ❌ 無法追蹤配置變更歷史 ### 解決方案 SyncMCP 提供： - ✅ 自動選擇最新的配置版本 - ✅ 智能處理不同客戶端的格式差異 - ✅ 自動備份所有變更，支援一鍵恢復 - ✅ 同步到所有客戶端 - ✅ 檢測配置丟失並發出警告 - ✅ 友善的互動介面 --- ## 🚀 快速開始 ### 安裝 SyncMCP 支援兩種安裝方式，選擇適合您的： #### 🎯 方式 1: uvx（推薦新手和一次性使用） 無需安裝，直接執行： ```bash # 檢查系統 uvx syncmcp doctor # 查看狀態 uvx syncmcp status # 執行同步 uvx syncmcp sync ``` **優點**: 無需安裝、自動隔離、更快速度 #### 📦 方式 2: pip（推薦頻繁使用） ```bash # 安裝 pip install syncmcp # 使用 syncmcp doctor syncmcp status syncmcp sync ``` **優點**: 命令更短、適合日常使用 #### 🔧 方式 3: 從原始碼安裝（開發者） ```bash git clone https://github.com/yourusername/syncmcp.git cd syncmcp pip install -e . ``` ### 5 分鐘入門 ```bash # 1. 檢查系統是否正常 syncmcp doctor # 2. 查看當前配置狀態 syncmcp status # 3. 預覽同步（不實際修改） syncmcp sync --dry-run # 4. 執行同步 syncmcp sync # 5. (可選) 使用互動模式 syncmcp interactive ``` --- ## 支援的客戶端 ### 客戶端特性對比 | 特性 | Claude Code | Roo Code | Claude Desktop | Gemini CLI | |------|------------|----------|----------------|------------| | **配置層級** | | | | | | 全域配置 | ✅ | ✅ | ✅ | ✅ | | 專案級配置 | …