Fork Parity MCP

🚀 🔄 Fork Parity MCP v2.0.0

這是一款全面的MCP服務器，它徹底改變了您與上游倉庫保持分支一致性的方式。具備智能提交分析、自動衝突檢測、GitHub Actions集成和高級通知系統等功能，專為管理複雜分支關係的團隊和組織打造。

🚀 快速開始

安裝

npm install -g @moikas/fork-parity-mcp

基本設置

1. 配置您的Git遠程倉庫：

# 添加上游遠程倉庫（如果尚未添加）
git remote add upstream https://github.com/original/repository.git

# 驗證遠程倉庫
git remote -v

2. 添加到您的MCP配置中：

{
  "mcpServers": {
    "fork-parity": {
      "command": "node",
      "args": ["/path/to/fork-parity-mcp/src/enhanced-server.js"],
      "env": {
        "REPO_PATH": "/path/to/your/fork"
      }
    }
  }
}

3. 可選：設置GitHub Actions自動化：

# 生成工作流文件
fork-parity setup-github-actions --workflows=daily_sync,pr_checks,critical_alerts

4. 開始跟蹤：

# 獲取最新的上游更改
git fetch upstream

# 您可以開始使用啦！🎉

✨ 主要特性

🧠 人工智能驅動的分析

• 🔍 智能提交分類 - 自動根據影響和優先級對提交進行分類
• 🎯 高級分析 - 深度依賴鏈分析、重大變更檢測
• 🛡️ 安全評估 - 自動進行安全影響評估
• ⚡ 性能影響 - 預測上游更改對性能的影響

🚀 自動化與集成

• 🤖 GitHub Actions工作流 - 通過自動檢查實現完整的CI/CD集成
• 📊 即時儀表盤 - 全面的一致性狀態，並提供可操作的見解
• 🔔 多渠道通知 - 支持Slack、Discord、電子郵件和Webhook
• 📋 遷移規劃 - 自動解決衝突並制定集成路線圖

🎛️ 企業級特性

• 📈 分析與指標 - 跟蹤集成速度和技術債務
• 🔄 批量處理 - 智能優先處理多個提交
• 🎨 可定製的工作流 - 適應您團隊的特定流程
• 🌐 多倉庫支持 - 從單個界面管理多個分支

🛠️ 開發者體驗

• 💡 學習系統 - 隨著時間的推移適應您的集成模式
• 🔧 衝突模擬 - 在集成前預覽合併衝突
• 📝 審查模板 - 結構化的提交審查和文檔記錄
• 🎯 影響分析 - 瞭解更改的下游影響

💻 使用示例

基礎用法

🧠 人工智能驅動的分析

"自動對最近20個上游提交進行分類"
"對提交abc123進行高級分析，包括安全評估"
"批量分析上一個衝刺階段的提交"

📊 儀表盤與監控

"生成全面的一致性儀表盤"
"顯示高優先級的可操作項"
"獲取自上月以來的詳細狀態"

🔄 集成規劃

"為下一季度創建集成計劃"
"為提交abc123、def456、ghi789生成遷移計劃"
"分析提交xyz890的潛在衝突"

🤖 自動化

"與上游同步並進行全面分析"
"設置GitHub Actions的每日同步和PR檢查工作流"
"配置Slack的關鍵警報通知"

📝 審查與文檔記錄

"為提交abc123創建審查模板"
"將提交def456的狀態更新為已集成，並添加適配說明"
"從這次成功的集成模式中學習"

🛠️ 可用工具（共15個）

🧠 分析與分類

📊 狀態與監控

🔄 集成與規劃

🤖 自動化與工作流

🔔 通知與學習

⚙️ 配置

環境變量

高級配置

{
  "mcpServers": {
    "fork-parity": {
      "command": "fork-parity-mcp",
      "env": {
        "UPSTREAM_REMOTE_NAME": "origin-upstream",
        "UPSTREAM_BRANCH": "develop",
        "REPO_PATH": "/home/user/my-fork"
      }
    }
  }
}

多項目配置

同時跟蹤多個分支：

{
  "mcpServers": {
    "project-a-parity": {
      "command": "fork-parity-mcp",
      "env": {
        "REPO_PATH": "/home/user/project-a"
      }
    },
    "project-b-parity": {
      "command": "fork-parity-mcp", 
      "env": {
        "REPO_PATH": "/home/user/project-b",
        "UPSTREAM_BRANCH": "development"
      }
    }
  }
}

📁 狀態跟蹤

服務器會創建一個.parity-status.json文件來跟蹤：

{
  "commits": {
    "abc123": {
      "status": "integrated",
      "notes": "應用時對我們的認證系統進行了修改",
      "timestamp": "2024-01-15T10:30:00Z"
    },
    "def456": {
      "status": "skipped", 
      "notes": "不適用於我們的分支",
      "timestamp": "2024-01-15T11:00:00Z"
    }
  },
  "lastUpdated": "2024-01-15T11:00:00Z"
}

狀態類型

• ✅ 已集成 - 成功合併/應用
• 🔍 已審查 - 已分析但尚未集成
• ⏭️ 已跳過 - 不適用於您的分支
• ⚠️ 有衝突 - 需要手動解決
• ⏸️ 已推遲 - 推遲到未來集成
• 🔄 待處理 - 等待分析或審查

🔧 技術細節

開發環境要求

• Node.js 18+
• 帶有上游遠程倉庫的Git倉庫

本地開發

# 克隆倉庫
git clone https://github.com/moikas-code/fork-parity-mcp.git
cd parity-mcp

# 安裝依賴
npm install

# 運行增強服務器
node src/enhanced-server.js

# 或者運行CLI
node src/cli.js --help

測試

# 檢查語法
npm run check-syntax

# 代碼檢查（已配置ESLint）
npx eslint src/*.js --ignore-pattern="*-old.js"

# 測試服務器啟動
node src/enhanced-server.js

# 檢查包
npm pack --dry-run

🤝 貢獻代碼

歡迎貢獻代碼！請隨時提交拉取請求。

1. 分叉倉庫
2. 創建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m '添加驚人的功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打開拉取請求

📄 許可證

本項目採用MIT許可證 - 詳情請參閱LICENSE文件。

🆕 v2.0.0的新特性

• 🧠 人工智能驅動的提交分類 - 智能分類和優先級排序
• 🔍 高級分析引擎 - 深度依賴鏈、安全評估、性能影響
• 🤖 GitHub Actions集成 - 完整的工作流自動化，帶有可定製的模板
• 📊 即時儀表盤 - 全面的分析和可操作的見解
• 🔔 多渠道通知 - 支持Slack、Discord、電子郵件和Webhook
• 🎯 衝突模擬 - 在集成前預覽和解決衝突
• 📈 學習系統 - 隨著時間的推移適應您的集成模式
• 🚀 企業級特性 - 批量處理、遷移規劃和團隊工作流

🙏 致謝

• 基於模型上下文協議（MCP）構建
• 受開源項目中保持分支一致性需求的啟發
• 感謝MCP社區提供的優秀SDK
• 特別感謝幫助項目達到v2.0.0生產就緒狀態的貢獻者

📚 相關鏈接

• MCP SDK文檔
• Claude桌面版MCP指南
• Git遠程管理
• GitHub Actions文檔
• 完整實現指南