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

Related MCP server: Git MCP

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