🔍 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: Continuum

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 einfache pip install gitlog-mcp bleibt 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.0 und v1.3.0 geändert hat.“

„Wer hat diese fehlerhafte Zeile in src/parser.py eingeführt und warum?“

„Erstelle Release-Notes für die nächste Version basierend auf den letzten Commits.“

Verfügbare Tools

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/repo

Dies 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.

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 + parsing

Bewusst 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 Arbeitsverzeichnis

• Strukturierte 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. ⭐