Git File Forensics

Git File Forensics MCP

Una herramienta MCP para análisis forense profundo a nivel de archivos de git que ayuda a obtener información detallada sobre historiales de archivos, cambios y patrones, centrándose en el análisis de archivos individuales en lugar de operaciones a nivel de repositorio.

Instalación

1. Clona y compila el servidor:

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

2. Añade a tu configuración de 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": []
    }
  }
}

Herramientas Disponibles

1. track_file_versions

Rastrea el historial completo de versiones de un archivo específico, incluyendo renombramientos y movimientos.

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

2. analyze_file_diff

Analiza cambios específicos entre dos versiones cualesquiera de un archivo.

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

Analiza el contexto más amplio de los cambios de archivos en un commit específico.

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

Analiza cambios semánticos y patrones en el historial de archivos.

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

Formato de Salida

Todas las herramientas generan archivos JSON que contienen:

• Resultados de análisis detallados
• Estadísticas resumidas
• Patrones de cambio y relaciones
• Evaluaciones de riesgo (cuando corresponda)

Requisitos

• Node.js
• Git (debe estar instalado y accesible)
• MCP SDK

Licencia

Este proyecto está licenciado bajo la Licencia Apache, Versión 2.0 - consulta el archivo LICENSE.txt para más detalles.

Copyright davidorex.ai. Licenciado bajo la Licencia Apache, Versión 2.0; no puedes utilizar este proyecto excepto en cumplimiento de la Licencia. Puedes obtener una copia de la Licencia en http://www.apache.org/licenses/LICENSE-2.0