/ Verzeichnis / Playground / GitMCP
● Community idosal ⚡ Sofort

GitMCP

von idosal · idosal/git-mcp

Verwandelt jedes öffentliche GitHub-Repo in einen Live-MCP-Endpunkt — README, Code und Docs direkt in Claude laden, ohne Klonen oder halluzinierte APIs.

GitMCP betreibt einen Remote-MCP-Server unter gitmcp.io/{owner}/{repo}. Claude bekommt Tools zum Abrufen von Dokumentation, Durchsuchen des Repos, Auflisten von Dateien und Lesen bestimmter Pfade — immer gegen den aktuellen Hauptbranch. Eliminiert die Fehlerklasse „Claude hat eine Funktion erfunden, die nicht existiert“ beim Arbeiten mit unbekannten Bibliotheken.

Warum nutzen

Hauptfunktionen

Live-Demo

In der Praxis

git-mcp-idosal.replay ▶ bereit
0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "git-mcp-idosal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "git-mcp-idosal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "git-mcp-idosal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "git-mcp-idosal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "git-mcp-idosal",
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json
{
  "context_servers": {
    "git-mcp-idosal": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://gitmcp.io/{owner}/{repo}"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add git-mcp-idosal -- npx -y mcp-remote https://gitmcp.io/{owner}/{repo}

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: GitMCP

Claude daran hindern, APIs einer halb bekannten Bibliothek zu halluzinieren

👤 Entwickler, die neuere Bibliotheken (nach dem Cutoff) oder Nischen-SDKs verwenden ⏱ ~15 min beginner

Wann einsetzen: Du integrierst eine Bibliothek, und Claude erfindet ständig Methodennamen, die nicht existieren.

Voraussetzungen
  • Den GitHub-Pfad der Bibliothek kennen — z. B. pydantic/pydantic-ai — Owner/Repo in gitmcp.io eingeben
Ablauf
  1. GitMCP auf die Bibliothek zeigen
    Füge den GitMCP-Server für pydantic/pydantic-ai zu meiner Konfiguration hinzu und liste dann die Docs-Dateien der obersten Ebene auf.✓ Kopiert
    → Tool gibt README.md plus /docs-Baum zurück — keine erfundenen Pfade
  2. Gegen echte Quelle abfragen
    Zeig mir mit dem GitMCP für pydantic-ai die tatsächliche Konstruktor-Signatur von Agent — zitiere sie aus der Quelle, fasse sie nicht zusammen.✓ Kopiert
    → Genaue Signatur mit Quelldatei und Zeilenreferenz
  3. Durch Ausführen verifizieren
    Schreib ein minimales, lauffähiges Beispiel, das nur das verwendet, was du im Repo gesehen hast. Wenn etwas fehlt, sag es — raten verboten.✓ Kopiert
    → Beispiel kompiliert; Claude markiert fehlende Teile

Ergebnis: Eine funktionierende Integration, die der tatsächlichen API der Bibliothek entspricht — keine plausibel klingende Fiktion.

Fallstricke
  • Bibliothek liegt in einem Monorepo-Unterverzeichnis — Zuerst das tree-Tool nutzen, um den richtigen Package-Root zu finden, dann erst lesen
Kombinieren mit: context7 · github

Schnell-Audit eines unbekannten Open-Source-Repos vor dem Fork

👤 Entwickler, die Abhängigkeiten bewerten ⏱ ~10 min beginner

Wann einsetzen: Du willst eine Bibliothek übernehmen und wissen, worauf du dich einlässt — ohne zu klonen.

Ablauf
  1. Überblick
    Verwende GitMCP für owner/repo. Fasse die Architektur aus README und Top-Level-Verzeichnissen in 8 Zeilen zusammen.✓ Kopiert
    → Konkrete, verzeichnisbasierte Zusammenfassung — kein Marketing-Blabla
  2. Risiko-Scan
    Hole das Package-Manifest und liste alle Abhängigkeiten auf. Markiere solche, die verwaist wirken oder eine CVE-Historie haben.✓ Kopiert
    → Abhängigkeitstabelle mit Einzelbewertungen
  3. Fit-Check
    Gibt es eine Plugin-/Erweiterungs-API, die ich nutzen kann, oder müsste ich forken? Zitiere den Code.✓ Kopiert
    → Codebasierte Antwort mit Dateipfaden

Ergebnis: Eine 5-Minuten-Entscheidung (Fork / Adoptieren / Überspringen) auf Basis des echten Repo-Inhalts.

Fallstricke
  • Privates Repo ohne Token — Self-hosted Docker-Image verwenden und GITHUB_TOKEN setzen
Kombinieren mit: github

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

git-mcp-idosal + context7

Zwei Ebenen aktueller Docs stapeln — Context7 für offizielle SDK-Docs, GitMCP für den Repo-Quellcode

Vergleiche, was context7 über Foo.bar() sagt, mit der tatsächlichen Quelle via GitMCP. Gibt es Abweichungen?✓ Kopiert
git-mcp-idosal + github

GitMCP für Read-only-Docs, GitHub MCP für PR/Issue-Erstellung

Lese den Contribution-Guide via GitMCP, öffne dann einen sauber formulierten PR via GitHub MCP.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

WerkzeugEingabenWann aufrufenKosten
fetch_documentation owner, repo Erster Aufruf beim Erkunden eines unbekannten Repos 1 GitHub API call
search_documentation owner, repo, query: str Doc-Abschnitte finden, die ein bestimmtes Konzept erwähnen 1 API call
fetch_url_content url: str Bestimmte Datei per Raw-URL laden free
search_code owner, repo, query: str Herausfinden, wo ein Symbol definiert oder verwendet wird 1 API call

Kosten & Limits

Was der Betrieb kostet

API-Kontingent
GitHub nicht authentifiziert: 60 Anfragen/Std. pro IP. Authentifiziert: 5000 Anfragen/Std.
Tokens pro Aufruf
500–5000 je nach Datei
Kosten in €
Kostenlos (gehostet)
Tipp
Search_*-Tools verwenden statt ganze Dateien zu dumpen

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: public_repo (for private access)
Credential-Speicherung: Token als Umgebungsvariable im Self-Hosting-Modus
Datenabfluss: gitmcp.io (gehostet) oder eigene Instanz
Niemals gewähren: repo:write

Fehlerbehebung

Häufige Fehler und Lösungen

403 rate limit exceeded

Self-Hosting mit einem PAT, oder warten — unauthentifiziertes Limit liegt bei 60 Anfragen/Std.

Prüfen: Check X-RateLimit-Remaining header
Repo nicht gefunden

Schreibweise von Owner/Repo prüfen und sicherstellen, dass es öffentlich ist. Für private Repos das Self-Hosting-Image verwenden.

Abgeschnittener Inhalt zurückgegeben

GitHub API begrenzt Raw-Blobs auf 1 MB. Für große Dateien search_code verwenden.

Alternativen

GitMCP vs. andere

AlternativeWann stattdessenKompromiss
Context7Du willst eine kuratierte Bibliotheks-Docs-Oberfläche statt rohem Repo-InhaltContext7 indiziert nur eine Teilmenge; GitMCP deckt jedes öffentliche Repo ab
GitHub MCP (official)Du brauchst auch PR/Issue/SchreiboperationenGitHub MCP ist schreibfähig (mehr abzusichern); GitMCP ist Read-only

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen