Mooring — Git & GitHub MCP-Server

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

GitHub

Dienstprogramme

Related MCP server: Git MCP Server

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

Lizenz

MIT