Git Forensics MCP

Análisis forense de Git MCP

Un servidor especializado del Protocolo de Contexto de Modelo (MCP) para la investigación y el análisis exhaustivos de repositorios Git. Esta herramienta forense proporciona información detallada sobre el historial del repositorio, las relaciones entre ramas y los patrones de desarrollo, centrándose exclusivamente en el análisis de repositorios Git en lugar de en las operaciones generales de GitHub o Git.

Características

El servidor proporciona cuatro herramientas de análisis principales:

1. Descripción general de la rama ( get_branch_overview )
   • Proporciona una descripción general de alto nivel de los estados y relaciones de las ramas.
   • Analiza las últimas confirmaciones, los recuentos de confirmaciones y las bases de fusión.
   • Genera resúmenes estadísticos de las actividades de la sucursal
2. Análisis del período de tiempo ( analyze_time_period )
   • Analiza la actividad de desarrollo detallada en períodos de tiempo específicos.
   • Clasifica las confirmaciones (característica, corrección, refactorización, documentación, otras)
   • Proporciona resúmenes de actividades con patrones de confirmación.
3. Análisis de cambios de archivos ( analyze_file_changes )
   • Realiza un seguimiento de los cambios en archivos específicos en todas las ramas
   • Identifica áreas de conflicto potenciales
   • Proporciona una evaluación de riesgos para las modificaciones de archivos.
   • Genera un orden de revisión recomendado según los niveles de riesgo
4. Fusionar recomendaciones ( get_merge_recommendations )
   • Determina estrategias de fusión óptimas
   • Evalúa los riesgos de conflicto
   • Identifica puntos críticos del código
   • Proporciona una guía de fusión paso a paso

Parámetros de entrada

Cada herramienta requiere parámetros específicos:

• repoPath : Ruta al repositorio git
• branches : Matriz de nombres de ramas para analizar
• outputPath : Ruta donde se escribirán los resultados del análisis
• Parámetros adicionales específicos de la herramienta:
  • timeRange : Fechas de inicio y finalización del análisis del período
  • files : Matriz de rutas de archivos para el análisis de cambios de archivos

Formato de salida

Todas las herramientas generan archivos JSON que contienen:

• Resultados detallados del análisis
• Estadísticas resumidas
• Evaluaciones de riesgos (cuando corresponda)
• Recomendaciones basadas en el análisis

Detalles técnicos

• Creado con TypeScript
• Utiliza MCP SDK para la implementación del servidor
• Ejecuta comandos git a través de procesos secundarios
• Proporciona manejo de errores y validación.
• Se ejecuta en el transporte stdio

Dependencias

• @modelcontextprotocol/sdk
• Node.js
• Git (debe estar instalado y accesible)

Uso

El servidor funciona como un servicio MCP y se puede integrar con cualquier cliente compatible con MCP. Todos los resultados del análisis se escriben en archivos de salida específicos en formato JSON.

Contribución y licencia

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

Bienvenida la colaboración

Se aceptan bifurcaciones y contribuciones.

Todas las contribuciones se realizarán bajo la Licencia Apache 2.0. Esta licencia permisiva le permite:

• Utilice el código comercialmente
• Modificar y distribuir el código
• Crear obras derivadas
• Incluir en otros proyectos

Copyright 2025. Licenciado bajo la Licencia Apache, Versión 2.0; no puede usar este proyecto sin cumplir con la Licencia. Puede obtener una copia de la Licencia en http://www.apache.org/licenses/LICENSE-2.0