gitlog-mcp
🔍 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: Git Insight MCP
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 simplepip install gitlog-mcpsigue 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.0yv1.3.0."
"¿Quién introdujo esta línea problemática en
src/parser.pyy por qué?"
"Redacta notas de lanzamiento para la próxima versión basadas en las confirmaciones recientes."
Herramientas expuestas
Herramienta | Descripción |
| Registro de cambios agrupado para un rango de etiqueta/confirmación |
| Explica la intención y el impacto de una confirmación específica |
| Atribución a nivel de línea para un archivo |
| Redacta notas de lanzamiento entre dos etiquetas |
| Resumen de contribuidores y cambios |
| Encuentra confirmaciones por mensaje/autor/fecha |
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/repoEsto imprime una URL (http://127.0.0.1:8765 por defecto) — ábrela en tu navegador; no se abrirá automáticamente.
Vista | Qué muestra |
Registro de cambios | Selector de rango de confirmaciones ( |
Salud del repositorio | Estadísticas de contribuidores, totales de confirmaciones |
Culpa | Atribución por archivo y por línea |
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 + parsingDeliberadamente 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
--repodesde el directorio de trabajo actualSalida 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. ⭐
Available Tools
6 toolsanalyze_commitC
Explain a specific commit's intent and impact.
Inputs: sha (required). Returns: result
blame_fileC
Line-level attribution for a file (who, when, which commit).
Inputs: path (required). Returns: result
changelogC
Generate a grouped changelog for a commit range (e.g. v1.2.0..v1.3.0).
Inputs: since, until. Returns: result
release_notesC
Draft release notes between two tags.
Inputs: to_tag (required), from_tag (required). Returns: result
repo_healthB
Contributor + churn summary for the repo.
Inputs: no named parameters. Returns: result
search_commitsC
Find commits by message, author, or date.
Inputs: query (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Most tools have distinct purposes: changelog vs. release_notes share overlap in generating summaries from commit ranges/tags, which could cause confusion. However, the others are clearly separated.
All tool names use a consistent verb_noun pattern (changelog is a noun but functions as a verb, minor deviation). Names are clear and predictable.
6 tools is well-scoped for a Git log/analysis server, covering key operations without bloat.
Covers commit analysis, search, blame, release notes, and health metrics. A possible gap is direct diff retrieval between commits, but core workflows are well-supported.
Maintenance
Related MCP Connectors
AI-native git hosting — repos, PRs, issues, CI gates, and AI code review over MCP (60 tools).
Team memory for AI coding agents and code reviews, reviewed by humans and served over MCP.
GitHub Copilot MCP: code, repo, PR, workflow tools for AI assistants.
Repo intel for AI coding agents: overview, PRs, contributors, hot files, CI, deps. Remote MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAutomatically extracts architectural decisions, patterns, and insights from Git commits to build a local, structured project memory. It exposes this living context to AI tools via MCP, allowing them to understand the historical reasoning and evolution behind your codebase.53 npm6MIT
- AlicenseAqualityDmaintenanceSemantic git queries via MCP. Beyond git log — answer who/what/why about any line, file, or branch with blame, co-change, PR linkage.613 npm2MIT
- AlicenseNot gradedqualityBmaintenanceLocal-first CLI that mines git history for file-level co-change patterns and builds a queryable knowledge graph for AI coding agents, exposed via an MCP server.5 npmApache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to search commits, retrieve diffs, and inspect file change history in a Git repository using MCP.61 npmMIT