mcp-git-tools

Git-Repository-Analysewerkzeuge für KI-Agenten, bereitgestellt über MCP (Model Context Protocol). Analysiert lokale Repositories mit nativen Git-Befehlen – keine GitHub-API erforderlich.

Tools

Related MCP server: mcp-git

Voraussetzungen

• Node.js >= 18

• Git installiert und im PATH verfügbar

Setup

npm install
npm run build

Konfiguration

Fügen Sie Ihrer MCP-Client-Konfiguration hinzu:

{
  "mcpServers": {
    "git-tools": {
      "command": "node",
      "args": ["D:/products/mcp-servers/mcp-git-tools/dist/index.js"]
    }
  }
}

Tool-Details

git_log

Ruft den letzten Commit-Verlauf mit optionalen Filtern ab.

Parameter:

• repoPath (erforderlich) — Absoluter Pfad zum Git-Repository

• count — Anzahl der zurückzugebenden Commits (Standard: 20)

• author — Nach Autorenname oder E-Mail filtern

• since / until — Datumsbereichsfilter

• path — Auf Commits filtern, die eine bestimmte Datei oder ein bestimmtes Verzeichnis betreffen

git_diff

Vergleicht zwei Refs und liefert eine strukturierte Zusammenfassung der Änderungen.

Parameter:

• repoPath (erforderlich) — Absoluter Pfad zum Git-Repository

• from — Start-Ref (Standard: HEAD~1)

• to — End-Ref (Standard: HEAD)

• path — Diff auf eine bestimmte Datei oder ein bestimmtes Verzeichnis beschränken

• summaryOnly — Nur Statistiken ohne vollständigen Diff-Text zurückgeben

git_blame

Zeigt die zeilenweise Autorenschaft einer Datei.

Parameter:

• repoPath (erforderlich) — Absoluter Pfad zum Git-Repository

• filePath (erforderlich) — Dateipfad relativ zum Repository-Stammverzeichnis

• startLine / endLine — Blame für einen bestimmten Zeilenbereich

• ref — Blame bei einem bestimmten Commit

git_stats

Ruft eine allgemeine Übersicht über die Repository-Aktivität ab.

Parameter:

• repoPath (erforderlich) — Absoluter Pfad zum Git-Repository

• topAuthors — Anzahl der aufzulistenden Top-Mitwirkenden (Standard: 10)

• topFiles — Anzahl der am häufigsten geänderten Dateien (Standard: 10)

git_branch

Branches auflisten und analysieren.

Parameter:

• repoPath (erforderlich) — Absoluter Pfad zum Git-Repository

• baseBranch — Branch, mit dem verglichen werden soll (Standard: main oder master)

• includeRemote — Remote-Tracking-Branches einschließen

• mergedOnly / unmergedOnly — Nach Zusammenführungsstatus filtern

Lizenz

MIT