git forensics mcp

Local 2025-09-01 00:43:35 0
Version Control @davidorex/git-forensics-mcp

A specialized MCP server for in-depth analysis of git repositories, offering tools for branch overview, time period analysis, file changes, and merge recommendations.

A specialized Model Context Protocol (MCP) server for deep git repository investigation and analysis. This forensics tool provides detailed insights into repository history, branch relationships, and development patterns, focusing solely on git repository analysis rather than general GitHub or git operations.

Features

The server provides four main analysis tools:

  1. Branch Overview (get_branch_overview)
  2. Provides high-level overview of branch states and relationships
  3. Analyzes last commits, commit counts, and merge bases

  4. Generates statistical summaries of branch activities

  5. Time Period Analysis (analyze_time_period)

  6. Analyzes detailed development activity in specific time periods
  7. Categorizes commits (feature, fix, refactor, docs, other)

  8. Provides activity summaries with commit patterns

  9. File Changes Analysis (analyze_file_changes)

  10. Tracks changes to specific files across branches
  11. Identifies potential conflict areas
  12. Provides risk assessment for file modifications

  13. Generates recommended review order based on risk levels

  14. Merge Recommendations (get_merge_recommendations)

  15. Determines optimal merge strategies
  16. Assesses conflict risks
  17. Identifies code hotspots
  18. Provides step-by-step merge guidance

Input Parameters

Each tool requires specific parameters:

  • repoPath: Path to the git repository
  • branches: Array of branch names to analyze
  • outputPath: Path where analysis results will be written
  • Additional tool-specific parameters:
  • timeRange: Start and end dates for period analysis
  • files: Array of file paths for file change analysis

Output Format

All tools output JSON files containing: - Detailed analysis results - Summary statistics - Risk assessments (where applicable) - Recommendations based on analysis

Technical Details

  • Built with TypeScript
  • Uses MCP SDK for server implementation
  • Executes git commands through child processes
  • Provides error handling and validation
  • Runs on stdio transport

Dependencies

  • @modelcontextprotocol/sdk
  • Node.js
  • Git (must be installed and accessible)

Usage

The server runs as an MCP service and can be integrated with any MCP-compatible client. All analysis results are written to specified output files in JSON format.

Contributing and License

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

Collaboration Welcome

Forks and contributions welcome.

All contributions will be under the Apache License 2.0. This permissive license allows you to: - Use the code commercially - Modify and distribute the code - Create derivative works - Include in other projects

Copyright 2025. 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

[
  {
    "description": "Get high-level overview of branch states and relationships",
    "inputSchema": {
      "properties": {
        "branches": {
          "description": "Branches to analyze",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "outputPath": {
          "description": "Path to write analysis output",
          "type": "string"
        },
        "repoPath": {
          "description": "Path to git repository",
          "type": "string"
        }
      },
      "required": [
        "repoPath",
        "branches",
        "outputPath"
      ],
      "type": "object"
    },
    "name": "get_branch_overview"
  },
  {
    "description": "Analyze detailed development activity in a specific time period",
    "inputSchema": {
      "properties": {
        "branches": {
          "description": "Branches to analyze",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "outputPath": {
          "description": "Path to write analysis output",
          "type": "string"
        },
        "repoPath": {
          "description": "Path to git repository",
          "type": "string"
        },
        "timeRange": {
          "properties": {
            "end": {
              "type": "string"
            },
            "start": {
              "type": "string"
            }
          },
          "required": [
            "start",
            "end"
          ],
          "type": "object"
        }
      },
      "required": [
        "repoPath",
        "branches",
        "timeRange",
        "outputPath"
      ],
      "type": "object"
    },
    "name": "analyze_time_period"
  },
  {
    "description": "Analyze changes to specific files across branches",
    "inputSchema": {
      "properties": {
        "branches": {
          "description": "Branches to analyze",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "files": {
          "description": "Files to analyze",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "outputPath": {
          "description": "Path to write analysis output",
          "type": "string"
        },
        "repoPath": {
          "description": "Path to git repository",
          "type": "string"
        }
      },
      "required": [
        "repoPath",
        "branches",
        "files",
        "outputPath"
      ],
      "type": "object"
    },
    "name": "analyze_file_changes"
  },
  {
    "description": "Get detailed merge strategy recommendations",
    "inputSchema": {
      "properties": {
        "branches": {
          "description": "Branches to analyze",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "outputPath": {
          "description": "Path to write analysis output",
          "type": "string"
        },
        "repoPath": {
          "description": "Path to git repository",
          "type": "string"
        }
      },
      "required": [
        "repoPath",
        "branches",
        "outputPath"
      ],
      "type": "object"
    },
    "name": "get_merge_recommendations"
  }
]