Git File Forensics MCP

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Provides tools for detailed file-level forensics in Git repositories, enabling tracking of file version history, analyzing changes between versions, examining commit contexts, and evaluating semantic patterns in file history.

  • Serves as the runtime environment for the MCP server, required for execution of the Git file forensics tools.

Git File Forensics MCP

An MCP tool for deep git file-level forensics that helps get detailed insights into file histories, changes, and patterns, focusing on individual file analysis rather than repository-wide operations.

Installation

  1. Clone and build the server:
git clone [repository-url] cd git-file-forensics npm install npm run build
  1. Add to your MCP settings (~/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": [] } } }

Available Tools

1. track_file_versions

Tracks complete version history of a specific file, including renames and moves.

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

2. analyze_file_diff

Analyzes specific changes between any two versions of a file.

{ "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

Analyzes broader 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", "outputPath": "output.json" } } }

4. analyze_file_semantics

Analyzes semantic changes and patterns in file history.

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

Output Format

All tools output JSON files containing:

  • Detailed analysis results
  • Summary statistics
  • Change patterns and relationships
  • Risk assessments (where applicable)

Requirements

  • Node.js
  • Git (must be installed and accessible)
  • MCP SDK

License

This project is licensed under the Apache License, Version 2.0 - see the LICENSE.txt file for details.

Copyright davidorex.ai. Licensed under the Apache License, Version 2.0; you may not use this project except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Provides deep git file-level forensics tools to analyze detailed file histories, changes, and patterns within git repositories, focusing on individual file analysis rather than repository-wide operations.

  1. Installation
    1. Available Tools
      1. 1. track_file_versions
        1. 2. analyze_file_diff
          1. 3. analyze_file_context
            1. 4. analyze_file_semantics
            2. Output Format
              1. Requirements
                1. License