Mooring — Git & GitHub MCP-Server

License: MIT

Festmacherleinen für Ihren Code — Git- und GitHub-Operationen für KI-Tools.

Mooring ist ein MCP-Server, der KI-Assistenten strukturierten Zugriff auf lokale Git-Repositories und die GitHub-API bietet. Lokale Operationen nutzen GitPython (keine Subprocess-Aufrufe). GitHub-Operationen verwenden die PyGithub-Bibliothek mit integrierter Token-Maskierung und Ratenbegrenzungs-Handling.

Tools

Lokales Git

Tool	Beschreibung	Wichtige Parameter
`repo_status`	Branch, ahead/behind, Stash-Anzahl, gestagte/ungestagte/ungetrackte Dateien	`repo_path`
`repo_log`	Commit-Log mit optionalen Filtern	`repo_path`, `max_count`, `author`, `since`, `path`, `search`
`repo_diff`	Unified Diff — Working Tree, gestagt oder zwischen Refs	`repo_path`, `staged`, `from_ref`, `to_ref`
`repo_blame`	Git Blame mit optionalem Zeilenbereich	`repo_path`, `file_path`, `start_line`, `end_line`
`repo_branches`	Alle Branches mit Tracking-Info, letztem Commit, ahead/behind	`repo_path`
`repo_stash`	Stash-Operationen: list, push, pop, apply	`repo_path`, `action`, `message`

GitHub

Tool	Beschreibung	Wichtige Parameter
`gh_pr_list`	Pull Requests auflisten	`repo`, `state`, `author`, `label`
`gh_pr_detail`	PR-Details mit Reviews, Kommentaren und Check-Runs	`repo`, `number`
`gh_pr_create`	Pull Request erstellen	`repo`, `title`, `body`, `head`, `base`, `labels`, `reviewers`
`gh_issues`	Issues auflisten, erstellen oder aktualisieren	`repo`, `state`, `action`, `title`, `body`, `number`
`gh_actions`	Kürzliche GitHub Actions Workflow-Runs auflisten	`repo`, `workflow`, `status`

Dienstprogramme

Tool	Beschreibung	Wichtige Parameter
`health`	Server-Version und Statusprüfung	(keine)

Installation

# PyPI
pip install mooring-mcp

# Isolated install
pipx install mooring-mcp

Verwendung

Starten Sie den Server direkt:

mooring

Claude Code

claude mcp add mooring -- mooring

Claude Desktop

Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration (claude_desktop_config.json) hinzu:

{
  "mcpServers": {
    "mooring": {
      "command": "mooring",
      "env": {
        "GITHUB_TOKEN": "your-github-personal-access-token"
      }
    }
  }
}

Die Umgebungsvariable GITHUB_TOKEN ist für alle GitHub-Tools (gh_*) erforderlich. Lokale Git-Tools funktionieren auch ohne diese.

Sicherheit

Schutz vor Pfad-Traversal — Dateipfade werden aufgelöst und vor jeder Operation gegen das Repository-Root validiert
Erkennung von Symlink-Ausbrüchen — Symlinks, die außerhalb des Repositorys aufgelöst werden, werden abgelehnt
Ref-Validierung — Git-Refs werden gegen ein sicheres Zeichenmuster geprüft und vor der Verwendung auf Existenz verifiziert
Token-Maskierung — Fehlermeldungen werden vor der Rückgabe nach GitHub-Token-Mustern (ghp_*, gho_*, github_pat_*) durchsucht und bereinigt
Ratenbegrenzungs-Handling — GitHub 403-Antworten werden abgefangen und als klare Meldungen statt als rohe Exceptions ausgegeben

Entwicklung

git clone https://github.com/seayniclabs/mooring.git
cd mooring
python -m venv .venv && source .venv/bin/activate
pip install -e ".[test]"
python -m pytest tests/ -q