gitlog-mcp
🔍 gitlog-mcp
Verleihe deinem KI-Coding-Agenten Superkräfte über die Git-Historie.
gitlog-mcp ist ein Model Context Protocol (MCP)-Server, der es KI-Agenten (Claude Code, Cursor, Windsurf und jedem MCP-Client) ermöglicht zu verstehen, was sich in einem Repository geändert hat — automatisch Changelogs zu generieren, Commits zu analysieren, Blame zuzuweisen und Release-Notes zu entwerfen.
„Was hat sich in diesem Repository geändert?“ ist die Frage, die jeder KI-Agent falsch beantwortet. Das hier behebt es.
Warum es das gibt
KI-Coding-Agenten sind großartig darin, Code zu schreiben, aber berüchtigt schlecht darin, die Historie einer Codebasis zu kennen. Sie halluzinieren Changelogs, weisen Blame falsch zu und raten bei Release-Notes. gitlog-mcp gibt ihnen ein zuverlässiges, strukturiertes Fenster in git log — damit ihre Antworten auf dem basieren, was tatsächlich passiert ist, und nicht erfunden sind.
Related MCP server: Git Insight MCP
Funktionen
📝 Auto-Changelog — generiere einen sauberen, gruppierten Changelog aus jedem Tag/Commit-Bereich
🔎 Commit-Analyse — erkläre warum eine Änderung passiert ist, nicht nur was geändert wurde
👤 Blame-Zuordnung — wer hat was und wann berührt (mit Kontext)
🏷️ Release-Notes — erstelle Release-Notes aus Tag-zu-Tag-Diffs
📊 Repository-Gesundheit — Commit-Häufigkeit, Top-Mitwirkende, Änderungshotspots
🧱 Keine Laufzeitabhängigkeiten — reine Python-Standardbibliothek + das MCP-SDK, eine Datei
Schnellstart
# 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)Möchtest du auch das lokale Web-Dashboard? Es ist ein optionales Extra, standardmäßig nicht installiert:
pip install "gitlog-mcp[ui]". Das einfachepip install gitlog-mcpbleibt genauso abhängigkeitsfrei wie immer.
Installation aus dem Quellcode (für Mitwirkende):
git clone https://github.com/ManiaSacha/gitlog-mcp.git && cd gitlog-mcp && pip install -e .— siehe CONTRIBUTING.md für Details.
Claude Code-Konfiguration
{
"mcpServers": {
"gitlog": {
"command": "gitlog-mcp",
"args": ["--repo", "."]
}
}
}Cursor-Konfiguration (.cursor/mcp.json)
{
"mcpServers": {
"gitlog": {
"command": "gitlog-mcp",
"args": ["--repo", "."]
}
}
}Windsurf-Konfiguration
{
"mcpServers": {
"gitlog": {
"command": "gitlog-mcp",
"args": ["--repo", "."]
}
}
}Debuggen im Alleingang
Möchtest du die Tools direkt ausprobieren, bevor du einen Agenten anschließt? Der MCP Inspector bietet eine Benutzeroberfläche, um jedes Tool von Hand aufzurufen:
npx @modelcontextprotocol/inspector gitlog-mcp --repo .Beispiel-Agenten-Prompts
„Generiere einen Changelog von allem, was sich zwischen
v1.2.0undv1.3.0geändert hat.“
„Wer hat diese fehlerhafte Zeile in
src/parser.pyeingeführt und warum?“
„Erstelle Release-Notes für die nächste Version basierend auf den letzten Commits.“
Verfügbare Tools
Tool | Beschreibung |
| Gruppierter Changelog für einen Commit/Tag-Bereich |
| Erklärt die Absicht und Auswirkung eines bestimmten Commits |
| Zeilenweise Zuordnung für eine Datei |
| Erstellt Release-Notes zwischen zwei Tags |
| Zusammenfassung der Mitwirkenden + Änderungen |
| Finde Commits nach Nachricht/Autor/Datum |
Web-Dashboard (optional)
Bevorzugst du einen Browser gegenüber einem Terminal? gitlog-mcp-ui bietet ein kleines lokales Dashboard auf Basis des gleichen Git-lesenden Codes, den die MCP-Tools verwenden – gleiche Daten, menschenlesbar.
pip install "gitlog-mcp[ui]"
gitlog-mcp-ui --repo /path/to/repoDies gibt eine URL aus (standardmäßig http://127.0.0.1:8765) — öffne sie in deinem Browser; der Server öffnet sie nicht für dich.
Ansicht | Was angezeigt wird |
Changelog | Bereichsauswahl für Commits ( |
Repository-Gesundheit | Mitwirkendenstatistiken, Commit-Gesamtsummen |
Blame | Datei- und zeilenweise Zuordnung |
Schreibgeschützt — keine Schreibaktionen irgendwo. Nur lokal durch Konstruktion: bindet nur an 127.0.0.1 (es gibt kein --host-Flag, kann also nicht einmal versehentlich im Netzwerk ausgesetzt werden), und validiert zusätzlich den Host-Header jeder Anfrage, um die DNS-Rebinding-Lücke zu schließen, die eine Loopback-Bindung allein nicht abdeckt. Keine Authentifizierung erforderlich, da nichts außer deinem eigenen Rechner darauf zugreifen kann.
Es ist ein optionales Extra (pip install gitlog-mcp[ui]), standardmäßig nicht installiert. Der Kernserver von gitlog-mcp hat null Laufzeitabhängigkeiten außer dem MCP-SDK, Punkt — das Dashboard ändert das nicht. Es ist http.server aus der Standardbibliothek, kein Framework, keine eigenen zusätzlichen Abhängigkeiten.
Architektur
gitlog-mcp (single file, ~300 lines)
├── FastMCP server (stdio transport)
├── GitRunner — thin wrapper over `git` CLI
└── Tools — each maps to a git subcommand + parsingBewusst klein. Du kannst das Ganze an einem Nachmittag durchlesen — das ist ein Feature.
Mitwirken
Pull-Requests sind willkommen. Nur kleine, fokussierte, gut getestete Änderungen. Siehe CONTRIBUTING.md.
Freigabeprozess und Versionierung sind in RELEASING.md dokumentiert.
Roadmap
--repo-Automatikerkennung aus dem aktuellen ArbeitsverzeichnisStrukturierte JSON-Ausgabe für alle Tools
GitHub/GitLab-Remote-Integration
Tests + CI-Badge
Lizenz
MIT © 2026 — im Offenen gebaut, für die Open-Source-Community.
Star dieses Repository, wenn du möchtest, dass KI-Agenten aufhören, deinen Changelog zu halluzinieren. ⭐
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