Skip to main content
Glama
gitlog-mcp
by ManiaSacha

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

PyPI CI GitHub stars Python License Zero deps


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

Tool

Beschreibung

changelog

Gruppierter Changelog für einen Commit/Tag-Bereich

analyze_commit

Erklärt die Absicht und Auswirkung eines bestimmten Commits

blame_file

Zeilenweise Zuordnung für eine Datei

release_notes

Erstellt Release-Notes zwischen zwei Tags

repo_health

Zusammenfassung der Mitwirkenden + Änderungen

search_commits

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

Ansicht

Was angezeigt wird

Changelog

Bereichsauswahl für Commits (since / until)

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 + 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. ⭐

Available Tools

6 tools
analyze_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

    B3.1/5.0

    Scored across 6 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    6 tools is well-scoped for a Git log/analysis server, covering key operations without bloat.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Automatically 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 npm
      6
      MIT