Git Forensics MCP

🚀 Git 法證 MCP 服務器

Git 法證 MCP 服務器是一款專門用於深入剖析大型 Git 代碼庫的工具。它基於 Model Context Protocol (MCP) 構建，專注於對 Git 存儲庫進行分析，能提供存儲庫歷史記錄、分支關係以及開發模式的詳細信息，而非進行通用的 GitHub 或 Git 操作。

🚀 快速開始

服務器作為 MCP 服務運行，可以與任何兼容的 MCP 客戶端集成。所有分析結果將以 JSON 格式寫入指定的輸出文件。

✨ 主要特性

該服務器提供了四個主要分析工具：

1. 分支概述 (get_branch_overview)
   • 提供分支狀態和關係的高級別視圖。
   • 分析最後提交、提交次數和合並基線。
   • 生成分支活動的統計摘要。
2. 時間段分析 (analyze_time_period)
   • 分析特定時間範圍內的詳細開發活動。
   • 對提交進行分類（功能、修復、重構、文檔、其他）。
   • 提供按提交模式劃分的活動摘要。
3. 文件更改分析 (analyze_file_changes)
   • 跟蹤特定文件在不同分支中的更改情況。
   • 識別潛在衝突區域。
   • 提供風險評估。
   • 根據風險級別生成推薦審查順序。
4. 合併建議 (get_merge_recommendations)
   • 確定最佳的合併策略。
   • 評估衝突風險。
   • 識別代碼熱點。
   • 提供分步合併指導。

📦 安裝指南

依賴項

• @modelcontextprotocol/sdk
• Node.js
• Git（必須安裝且可執行）

💻 使用示例

基礎用法

每個工具都需要特定的參數：

- `repoPath`：Git 存儲庫路徑
- `branches`：要分析的分支名稱數組
- `outputPath`：分析結果寫入的位置
- 其他工具特定參數：
  - `timeRange`：時間段分析的開始和結束日期
  - `files`：文件路徑數組，用於文件更改分析

📚 詳細文檔

輸出格式

所有工具輸出 JSON 文件，包含：

• 詳細分析結果
• 總結統計信息
• 風險評估（如適用）
• 基於分析的建議

🔧 技術細節

• 使用 TypeScript 實現。
• 使用 MCP SDK 進行服務器實現。
• 通過子進程執行 Git 命令。
• 提供錯誤處理和驗證機制。
• 在 stdio 傳輸上運行。

📄 許可證

該項目在 Apache 許可證 2.0 下開源，具體許可證內容請參閱 LICENSE.txt 文件。

歡迎協作

歡迎 Fork 和貢獻。所有貢獻均基於 Apache 許可證 2.0。此寬鬆許可允許您：

• 商業用途
• 修改和分發代碼
• 創建衍生作品
• 包含在其他項目中

版權 2025。根據 Apache 許可證 2.0 使用，除非遵守許可證，否則不得使用該項目。許可證副本請訪問 http://www.apache.org/licenses/LICENSE-2.0