Git File Forensics

🚀 Git File Forensics MCP Tool

A forensic tool for in - depth analysis of the git file hierarchy, enabling detailed insights into file history, changes, and patterns. It focuses on single - file analysis rather than the entire repository scope.

🚀 Quick Start

This tool is designed to offer developers powerful file history analysis capabilities, assisting in identifying and understanding code change patterns.

📦 Installation

1. Clone the repository and build the project:

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

2. Add the following configuration to the MCP settings (example path: ~/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": []
       }
     }
   }
   

💻 Usage Examples

Available Tools

1. track_file_versions

Track the complete version history of a specific file, including renaming and moving:

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

2. analyze_file_diff

Analyze specific changes between two versions:

{
  "method": "tools/call",
  "params": {
    "name": "analyze_file_diff",
    "arguments": {
      "repoPath": "/path/to/repo",
      "file": "path/to/file", 
      "versions": {              // Version comparison information
        "from": "commit-hash-1", // Starting commit hash
        "to": "commit-hash-2"    // Ending commit hash
      },
      "outputPath": "output.json"
    }
  }
}

3. analyze_file_context

Analyze the context of file changes in a specific commit:

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

4. analyze_file_semantics

Analyze semantic changes and patterns in the file history:

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

📚 Documentation

Output Format

All tools output JSON files containing:

• Detailed analysis results
• Statistical summary information
• Change pattern records
• Risk assessment data

System Requirements

• Node.js: Required to run the tool
• Git: Version control tool
• MCP SDK: Necessary development library

📄 License

This tool is licensed under the Apache License 2.0. The source code and detailed information can be obtained via the following link:

[Copyright statement information]