{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_fcxudhxynm2h","handle":"iflow-mcp-richblack-syncmcp","url":"https://wellknown.network/agents/iflow-mcp-richblack-syncmcp","links":{"self":"https://wellknown.network/agents/iflow-mcp-richblack-syncmcp/record.json","html":"https://wellknown.network/agents/iflow-mcp-richblack-syncmcp","markdown":"https://wellknown.network/agents/iflow-mcp-richblack-syncmcp/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-richblack-syncmcp","status":"https://wellknown.network/api/v1/agents/iflow-mcp-richblack-syncmcp/status","claim":"https://wellknown.network/agents/iflow-mcp-richblack-syncmcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-richblack-syncmcp/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-richblack-syncmcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-richblack-syncmcp/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-richblack-syncmcp/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-richblack-syncmcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_richblack-syncmcp","summary":"智能 MCP 配置同步工具 - Smart MCP Configuration Sync Tool","description":"# SyncMCP - MCP 配置同步工具 🚀\n\n[![Version](https://img.shields.io/badge/version-2.0.0-blue.svg)](https://github.com/yourusername/syncmcp)\n[![Python](https://img.shields.io/badge/python-3.10+-brightgreen.svg)](https://www.python.org/)\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)\n\n智能化的 MCP (Model Context Protocol) 配置同步工具，讓您輕鬆管理多個 AI 客戶端的配置。\n\n> 🤖 100% 由 Claude 開發，持續進化中\n\n## ✨ 特色\n\n- 🔄 **智能同步** - 自動選擇最新配置，一鍵同步所有客戶端\n- 💾 **自動備份** - 每次同步前自動備份，安全無憂\n- 🎨 **互動介面** - 友善的 Terminal UI，非技術用戶也能輕鬆使用\n- 🤖 **MCP Server** - 作為 MCP Server，讓 Claude 幫您管理配置\n- 🌍 **全局命令** - 安裝後可在任何位置執行\n- 🔍 **差異偵測** - 智能分析配置差異，提供清晰報告\n- 🛡️ **錯誤回滾** - 同步失敗時自動恢復備份\n\n## 📖 目錄\n\n- [問題與解決方案](#問題與解決方案)\n- [快速開始](#-快速開始)\n- [支援的客戶端](#支援的客戶端)\n- [主要功能](#-主要功能)\n- [使用方法](#使用方法)\n- [文檔](#-文檔)\n- [常見問題](#-常見問題)\n- [開發路線圖](#-開發路線圖)\n- [貢獻](#-貢獻)\n\n---\n\n## 問題與解決方案\n\n### 問題\n\n每個 AI Agent（Claude Desktop、Claude Code、Roo Code、Gemini CLI）都有各自的 MCP Server 配置文件。當您在一個客戶端安裝或修改 MCP 時，其他客戶端不會自動同步，導致：\n\n- ❌ 配置不一致\n- ❌ 需要手動複製配置\n- ❌ 容易出錯且繁瑣\n- ❌ 無法追蹤配置變更歷史\n\n### 解決方案\n\nSyncMCP 提供：\n\n- ✅ 自動選擇最新的配置版本\n- ✅ 智能處理不同客戶端的格式差異\n- ✅ 自動備份所有變更，支援一鍵恢復\n- ✅ 同步到所有客戶端\n- ✅ 檢測配置丟失並發出警告\n- ✅ 友善的互動介面\n\n---\n\n## 🚀 快速開始\n\n### 安裝\n\nSyncMCP 支援兩種安裝方式，選擇適合您的：\n\n#### 🎯 方式 1: uvx（推薦新手和一次性使用）\n\n無需安裝，直接執行：\n\n```bash\n# 檢查系統\nuvx syncmcp doctor\n\n# 查看狀態\nuvx syncmcp status\n\n# 執行同步\nuvx syncmcp sync\n```\n\n**優點**: 無需安裝、自動隔離、更快速度\n\n#### 📦 方式 2: pip（推薦頻繁使用）\n\n```bash\n# 安裝\npip install syncmcp\n\n# 使用\nsyncmcp doctor\nsyncmcp status\nsyncmcp sync\n```\n\n**優點**: 命令更短、適合日常使用\n\n#### 🔧 方式 3: 從原始碼安裝（開發者）\n\n```bash\ngit clone https://github.com/yourusername/syncmcp.git\ncd syncmcp\npip install -e .\n```\n\n### 5 分鐘入門\n\n```bash\n# 1. 檢查系統是否正常\nsyncmcp doctor\n\n# 2. 查看當前配置狀態\nsyncmcp status\n\n# 3. 預覽同步（不實際修改）\nsyncmcp sync --dry-run\n\n# 4. 執行同步\nsyncmcp sync\n\n# 5. (可選) 使用互動模式\nsyncmcp interactive\n```\n\n---\n\n## 支援的客戶端\n\n### 客戶端特性對比\n\n| 特性 | Claude Code | Roo Code | Claude Desktop | Gemini CLI |\n|------|------------|----------|----------------|------------|\n| **配置層級** | | | | |\n| 全域配置 | ✅ | ✅ | ✅ | ✅ |\n| 專案級配置 | …","publisher":{"name":"SyncMCP Contributors","url":null},"homepage":"https://github.com/yourusername/SyncMCP/blob/main/README.md","repository":"https://github.com/yourusername/SyncMCP/blob/main/README.md","version":"2.0.1","license":"MIT","protocols":["mcp"],"tags":["claude","configuration","gemini","mcp","model-context-protocol","sync"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_richblack-syncmcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.779,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"fr"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"iflow-mcp_richblack-syncmcp","registry":"pypi","observedAt":"2026-09-15T20:21:13.545Z","publishedAt":"2026-02-06T17:27:30.776702Z","latestVersion":"2.0.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_richblack-syncmcp","url":"https://pypi.org/project/iflow-mcp_richblack-syncmcp/","firstSeenAt":"2026-09-09T20:25:33.173Z","fetchedAt":"2026-09-15T20:19:00.798Z","normalizedAt":"2026-09-15T20:19:00.798Z"}]},"firstSeenAt":"2026-09-09T20:25:33.173Z","updatedAt":"2026-09-15T20:21:13.545Z"}