Git File Forensics

🚀 Git 文件取證 MCP 工具

Git 文件取證 MCP 工具是一款專注於深入分析 git 文件層級的取證工具。它能夠幫助用戶獲取文件歷史、變更和模式的詳細洞察，並且著重於單個文件分析，而非整個倉庫範圍。

🚀 快速開始

Git 文件取證 MCP 工具可助力你對單個文件進行深入的歷史分析，下面將為你介紹使用前的安裝步驟。

📦 安裝指南

克隆代碼庫並構建

git clone [repository-url]
cd git-file-forensics
npm install
npm run build

配置 MCP 設置

將以下配置添加到 MCP 設置（路徑示例：~/Library/Application Support/Code/User/globalStorage/david-dafu-dev.dafu/settings/cline_mcp_settings.json）：

{
  "mcpServers": {
    "git-file-forensics": {
      "command": "/opt/homebrew/bin/node",
      "args": ["/path/to/git-file-forensics/build/index.js"],
      "alwaysAllow": []
    }
  }
}

💻 使用示例

基礎用法

1. track_file_versions

此工具可跟蹤特定文件的完整版本歷史，包括重命名和移動：

{
  "method": "tools/call",
  "params": {
    "name": "track_file_versions",
    "arguments": {
      "repoPath": "/path/to/repo", // 倉庫路徑
      "file": "path/to/file",     // 文件路徑
      "outputPath": "output.json"  // 輸出文件路徑
    }
  }
}

2. analyze_file_diff

該工具用於分析兩個版本之間的具體變更：

{
  "method": "tools/call",
  "params": {
    "name": "analyze_file_diff",
    "arguments": {
      "repoPath": "/path/to/repo",
      "file": "path/to/file", 
      "versions": {              // 版本對比信息
        "from": "commit-hash-1", // 起始提交哈希值
        "to": "commit-hash-2"    // 結束提交哈希值
      },
      "outputPath": "output.json"
    }
  }
}

3. analyze_file_context

此工具可分析特定提交中的文件變更上下文：

{
  "method": "tools/call",
  "params": {
    "name": "analyze_file_context", 
    "arguments": {
      "repoPath": "/path/to/repo",
      "file": "path/to/file", 
      "commit": "commit-hash",   // 提交哈希值
      "outputPath": "output.json"
    }
  }
}

4. analyze_file_semantics

該工具用於分析文件歷史中的語義變更和模式：

{
  "method": "tools/call",
  "params": {
    "name": "analyze_file_semantics",
    "arguments": {
      "repoPath": "/path/to/repo",
      "file": "path/to/file", 
      "outputPath": "output.json"
    }
  }
}

📚 詳細文檔

輸出格式

所有工具均輸出 JSON 文件，包含以下內容：

• 詳細分析結果
• 統計摘要信息
• 變更模式記錄
• 風險評估數據

系統要求

• Node.js：用於運行工具
• Git：版本控制工具
• MCP SDK：必要的開發庫

📄 許可證

該工具採用 Apache License 2.0 協議，源代碼和詳細信息可通過以下鏈接獲取：

[版權聲明信息]

此工具旨在為開發者提供強大的文件歷史分析能力，幫助識別和理解代碼變更模式。