🔍 gitlog-mcp

Dale superpoderes a tu agente de codificación de IA sobre el historial de git.

gitlog-mcp es un servidor del Protocolo de Contexto de Modelo (MCP) que permite a los agentes de IA (Claude Code, Cursor, Windsurf y cualquier cliente MCP) entender qué cambió en un repositorio — generar automáticamente registros de cambios, analizar confirmaciones, atribuir culpas y redactar notas de lanzamiento.

"¿Qué cambió en este repo?" es la pregunta que todo agente de IA responde mal. Esto lo corrige.

Por qué existe esto

Los agentes de codificación de IA son excelentes para escribir código, pero notoriamente malos para conocer la historia de una base de código. Alucinan registros de cambios, atribuyen culpas incorrectamente y adivinan las notas de lanzamiento. gitlog-mcp les proporciona una ventana confiable y estructurada al git log — para que sus respuestas se basen en lo que realmente sucedió, no en lo inventado.

Related MCP server: Continuum

Funcionalidades

• 📝 Registro de cambios automático — genera un registro de cambios limpio y agrupado desde cualquier rango de etiqueta/confirmación

• 🔎 Análisis de confirmaciones — explica por qué ocurrió un cambio, no solo qué cambió

• 👤 Atribución de culpas — quién tocó qué y cuándo (con contexto)

• 🏷️ Notas de lanzamiento — redacta notas de lanzamiento a partir de diferencias entre etiquetas

• 📊 Salud del repositorio — frecuencia de confirmaciones, principales contribuidores, puntos críticos de cambio

• 🧱 Cero dependencias en tiempo de ejecución — solo stdlib de Python + el SDK de MCP, un archivo

Inicio rápido

# 1. Install from PyPI
pip install gitlog-mcp

# 2. Run standalone (for testing) — defaults to the current directory
gitlog-mcp
gitlog-mcp --repo /path/to/your/repo

# 3. Or add directly to your agent's MCP config (see below)

¿Quieres también el panel web local? Es un extra opcional, no instalado por defecto: pip install "gitlog-mcp[ui]". La instalación simple pip install gitlog-mcp sigue siendo tan libre de dependencias como siempre.

Instalando desde el código fuente (para contribuidores): git clone https://github.com/ManiaSacha/gitlog-mcp.git && cd gitlog-mcp && pip install -e . — consulta CONTRIBUTING.md para más detalles.

Configuración de Claude Code

{
  "mcpServers": {
    "gitlog": {
      "command": "gitlog-mcp",
      "args": ["--repo", "."]
    }
  }
}

Configuración de Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "gitlog": {
      "command": "gitlog-mcp",
      "args": ["--repo", "."]
    }
  }
}

Configuración de Windsurf

{
  "mcpServers": {
    "gitlog": {
      "command": "gitlog-mcp",
      "args": ["--repo", "."]
    }
  }
}

Depúralo de forma independiente

¿Quieres probar las herramientas directamente antes de conectar un agente? El MCP Inspector te proporciona una interfaz para llamar a cada herramienta manualmente:

npx @modelcontextprotocol/inspector gitlog-mcp --repo .

Ejemplos de indicaciones para el agente

"Genera un registro de cambios de todo lo que cambió entre v1.2.0 y v1.3.0."

"¿Quién introdujo esta línea problemática en src/parser.py y por qué?"

"Redacta notas de lanzamiento para la próxima versión basadas en las confirmaciones recientes."

Herramientas expuestas

Panel web (opcional)

¿Prefieres un navegador a una terminal? gitlog-mcp-ui sirve un pequeño panel local sobre el mismo código de lectura de git que usan las herramientas MCP — mismos datos, legibles para humanos.

pip install "gitlog-mcp[ui]"
gitlog-mcp-ui --repo /path/to/repo

Esto imprime una URL (http://127.0.0.1:8765 por defecto) — ábrela en tu navegador; no se abrirá automáticamente.

Solo lectura — no hay acciones de escritura en ningún lado. Solo local por construcción: se vincula únicamente a 127.0.0.1 (no hay una bandera --host, por lo que no puede exponerse a la red ni siquiera por accidente), y también valida el encabezado Host de cada solicitud, cerrando la brecha de reenlace de DNS que un simple enlace de bucle invertido no cubre. No se necesita autenticación, porque nada más que tu propia máquina puede alcanzarlo.

Es un extra opcional (pip install gitlog-mcp[ui]), no instalado por defecto. El servidor central gitlog-mcp tiene cero dependencias en tiempo de ejecución más allá del SDK de MCP, punto final — el panel no cambia eso. Es http.server de la stdlib, sin framework, sin dependencias adicionales propias.

Arquitectura

gitlog-mcp (single file, ~300 lines)
├── FastMCP server (stdio transport)
├── GitRunner — thin wrapper over `git` CLI
└── Tools — each maps to a git subcommand + parsing

Deliberadamente pequeño. Puedes leerlo todo en una tarde — eso es una característica.

Contribuir

Se aceptan solicitudes de extracción. Solo cambios pequeños, enfocados y bien probados. Consulta CONTRIBUTING.md.

El proceso de lanzamiento y el versionado están documentados en RELEASING.md.

Hoja de ruta

• Detección automática de --repo desde el directorio de trabajo actual

• Salida JSON estructurada para todas las herramientas

• Integración remota con GitHub/GitLab

• Pruebas + insignia de CI

Licencia

MIT © 2026 — construido en abierto, para la comunidad de código abierto.

Marca este repositorio con una estrella si quieres que los agentes de IA dejen de alucinar tu registro de cambios. ⭐