git-file-forensics

# 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: ```bash git clone [repository-url] cd git-file-forensics npm install npm run build ``` 2. Add to your MCP settings (`~/Library/Application Support/Code/User/globalStorage/david-dafu-dev.dafu/settings/cline_mcp_settings.json`): ```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. ```json { "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. ```json { "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. ```json { "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. ```json { "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](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