GitHub MCP Server

Offizieller MCP-Server von GitHub für Repositories, Issues, Pull Requests, Actions und mehr – lokal oder als von GitHub gehosteter Remote-Server.

Beschreibung

Der GitHub MCP Server ist der offizielle MCP-Server von GitHub, gepflegt im Repository github/github-mcp-server. Er bindet Repositories, Issues, Pull Requests, GitHub Actions und weitere GitHub-Funktionen als MCP-Werkzeuge ein. Lizenz MIT.

Laut Dokumentation existiert er in zwei Betriebsarten: als von GitHub gehosteter Remote-Server unter https://api.githubcopilot.com/mcp/ (mit OAuth- oder Personal-Access-Token-Anmeldung), oder lokal über ein Docker-Image.

Die Werkzeuge sind in Themengruppen (Toolsets) organisiert, unter anderem: Repositories (Code, Dateien, Commits, Branches), Issues, Pull Requests (Reviews, Merges, Diffs, Checks), Actions (Workflows, Runs, Artefakte, Job-Logs), Code Security (Scan-Warnungen, Dependabot, Secret Protection), Discussions, Projects, Notifications, Organizations sowie Gists und Nutzerinformationen. Standardmäßig aktiv sind laut Dokumentation die Gruppen context, repos, issues, pull_requests und users.

Authentifizierung erfolgt über OAuth (browserbasierte Anmeldung, Token nur im Arbeitsspeicher) oder ein Personal Access Token über die Umgebungsvariable GITHUB_PERSONAL_ACCESS_TOKEN. Für nicht-interaktive Einsätze steht zusätzlich eine GitHub-App-Anmeldung bereit. GitHub Enterprise Server und ghe.com werden über die Variable GITHUB_HOST unterstützt.

Lokaler Start über Docker:

Code
docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

Einbindung in einem MCP-Client:

json
{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"]
    }
  }
}

Alternativ lässt sich der Server aus dem Quellcode bauen: go build -o github-mcp-server ./cmd/github-mcp-server, gestartet über ./github-mcp-server stdio.

Gehostet vs. lokal betreiben

Der von GitHub gehostete Remote-Server ist für die meisten Fälle der einfachere Einstieg: Es reicht, die URL im Client einzutragen und die OAuth-Anmeldung im Browser abzuschließen, ohne Docker oder eine eigene Laufzeitumgebung zu betreiben. GitHub übernimmt dabei Betrieb und Aktualisierung des Servers. Der lokale Betrieb über Docker oder eine selbst gebaute Binärdatei lohnt sich, wenn striktere Kontrolle über Netzwerkzugriff, Logging oder Toolset-Auswahl gewünscht ist, oder wenn GitHub Enterprise Server beziehungsweise ghe.com im Einsatz sind, für die laut Dokumentation ausschließlich der lokale Modus zur Verfügung steht.

Toolsets gezielt einschränken

Weil der GitHub MCP Server potenziell weitreichende Rechte über Repositories, Actions und Organisationsdaten mitbringt, empfiehlt die Dokumentation, nur die tatsächlich benötigten Toolsets zu aktivieren statt alle verfügbaren Funktionsgruppen freizuschalten. Der Read-only-Modus deaktiviert sämtliche Schreibwerkzeuge und eignet sich für Recherche- oder Reporting-Aufgaben, bei denen keine Änderungen an Code oder Issues nötig sind. Ein zusätzlicher Lockdown-Modus schränkt die Verarbeitung nicht vertrauenswürdiger Inhalte weiter ein und reduziert damit das Risiko, dass in Issues oder Pull-Request-Kommentaren versteckte Anweisungen unbeabsichtigt ausgeführt werden.

Für wen sich der GitHub MCP Server eignet

Teams, die einen KI-Agenten direkt an ihren Entwicklungsworkflow anbinden wollen, profitieren am meisten: automatisiertes Triagieren neuer Issues, das Erstellen von Pull-Request-Entwürfen aus einer Aufgabenbeschreibung, das Zusammenfassen von Actions-Fehlern oder das Durchsuchen von Sicherheitswarnungen aus Code-Scanning und Dependabot. Für Einzelentwickler, die nur gelegentlich ein Repository durchsuchen oder einen Issue-Status abfragen wollen, genügt häufig schon ein minimal berechtigtes Token mit dem Read-only-Modus.

Häufige Fragen

Brauche ich Docker, um den Server zu nutzen? Nein, der von GitHub gehostete Remote-Server benötigt weder Docker noch eine lokale Installation. Funktioniert der Server mit GitHub Enterprise Server? Ja, über die Umgebungsvariable GITHUB_HOST, allerdings laut Dokumentation nur im lokalen Betrieb. Kann der Agent versehentlich Code löschen? Nur wenn entsprechend weitreichende Schreibrechte vergeben wurden; Read-only- und Lockdown-Modus sowie minimal berechtigte Tokens verhindern das.

Voraussetzungen

Für den gehosteten Remote-Server werden ein GitHub-Konto, ein Remote-MCP-fähiger Client und die in der Organisation geltenden Freigaben benötigt. Lokal sind Docker oder eine selbst gebaute Go-Binärdatei erforderlich. Für GitHub Enterprise Server steht nur der lokale Betrieb zur Verfügung.

Installationsanleitung

Der offizielle GitHub MCP Server kann Quellcode lesen und – abhängig von den freigegebenen Werkzeugen – Repositories, Issues und Pull Requests verändern. Beginne deshalb mit der kleinsten nötigen Berechtigung.

Schritt 1: GitHub MCP als Remote-Server einrichten

Hinterlege in einem Remote-MCP-fähigen Client diese URL:

text
https://api.githubcopilot.com/mcp/

Wenn der Client GitHubs OAuth-Flow unterstützt, ist kein selbst erstelltes Token nötig. Andernfalls kann ein Fine-grained Personal Access Token als Bearer-Token verwendet werden. Seine Repository-Auswahl und Rechte sollten exakt auf die Aufgabe begrenzt sein.

Schritt 2: GitHub MCP lokal einrichten

bash
docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

Übergib das Token über die geschützte Umgebungsverwaltung des Clients und nie als Klartext in einer eingecheckten Konfigurationsdatei. Lokal ist alternativ eine browserbasierte OAuth-Anmeldung möglich.

Funktionsumfang von GitHub MCP begrenzen

Starte nach Möglichkeit im Read-only-Modus und aktiviere nur benötigte Toolsets. Der Lockdown-Modus begrenzt Zugriffe zusätzlich auf Repositories, an denen der angemeldete Benutzer mitarbeitet. Schreibrechte sollten erst nach einem Testlauf und mit menschlicher Bestätigung aktiviert werden.

Schritt 3: Einrichtung prüfen

Teste zunächst get_me und einen reinen Lesezugriff auf ein ausgewähltes Repository. Kontrolliere anschließend in GitHub die Token- beziehungsweise OAuth-Berechtigungen und widerrufe nicht mehr benötigte Zugänge.

Toolsets gezielt auswählen

Der GitHub MCP Server organisiert seine Funktionen in Themengruppen wie Repositories, Issues, Pull Requests, Actions und Code Security. Statt alle Gruppen zu aktivieren, sollten nur die für die geplante Aufgabe tatsächlich benötigten eingeschaltet werden – wer nur Issues durchsuchen will, braucht keinen Zugriff auf Actions-Workflows oder Code-Security-Meldungen. Eine kleinere Toolset-Auswahl reduziert nicht nur das Sicherheitsrisiko, sondern auch die Anzahl der Werkzeugdefinitionen im Kontext des Sprachmodells.

Schritt 4: Unterschiede zwischen OAuth und Personal Access Token

OAuth ist für interaktive Nutzung meist die bequemere Wahl, weil kein Token manuell erzeugt und verwaltet werden muss; das Token bleibt laut Dokumentation nur im Arbeitsspeicher. Für nicht-interaktive Automatisierung, etwa in einer CI/CD-Pipeline, ist ein Fine-grained Personal Access Token oder eine GitHub-App-Anmeldung praktikabler, weil dort kein Browserfenster geöffnet werden kann. In beiden Fällen gilt: Je enger die Rechte, desto geringer der Schaden bei einem kompromittierten Client.

Vorgehen bei Verdacht auf Missbrauch

Zeigt das Audit-Log ungewöhnliche Aktivität, etwa Commits oder Pull-Request-Kommentare zu ungewöhnlichen Zeiten, sollte das betroffene Token oder die OAuth-Autorisierung sofort widerrufen und durch ein neues, enger begrenztes ersetzt werden. Anschließend empfiehlt sich eine Durchsicht der zuletzt vom Agenten ausgeführten Aktionen, um mögliche unautorisierte Änderungen zu identifizieren und rückgängig zu machen.

Quelle: offizielles Repository github/github-mcp-server, geprüft am 03.09.2026.

docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

Authentifizierung

Unterstützt OAuth, Fine-grained oder klassische Personal Access Tokens sowie GitHub-App-Authentifizierung für nicht-interaktive lokale Einsätze. Beim lokalen OAuth-Flow bleibt das Token laut Dokumentation nur im Arbeitsspeicher. Ein gesetztes GITHUB_PERSONAL_ACCESS_TOKEN hat Vorrang vor OAuth.

Benötigte Zugriffsrechte

Die wirksamen Rechte entsprechen dem angemeldeten GitHub-Benutzer beziehungsweise den Scopes des Tokens. Je nach aktivierten Toolsets sind Lese- und Schreibzugriffe auf Repositories, Issues, Pull Requests, Actions, Organisationen und Sicherheitsfunktionen möglich. Rechte mit minimalen Token-Scopes vergeben; --read-only, ausgewählte Toolsets und Lockdown-Modus begrenzen den Funktionsumfang.

Übertragene oder gespeicherte Daten

Anfragen und Werkzeugparameter werden an die GitHub API beziehungsweise den gehosteten Remote-Server übertragen. Antworten können Quellcode, Commits, Issues, Pull Requests, Actions-Logs, Organisationsdaten und Sicherheitsmeldungen enthalten und werden an den MCP-Client sowie dessen Sprachmodell weitergegeben. Schreibwerkzeuge speichern Änderungen dauerhaft auf GitHub. Beim lokalen OAuth-Flow bleibt das Zugriffstoken im Arbeitsspeicher; ein PAT liegt in der Client- oder Prozessumgebung.

Sicherheitsrisiken

Ein zu weit berechtigtes oder offengelegtes Token ermöglicht weitreichende GitHub-Aktionen. Schreibwerkzeuge können Dateien, Branches, Issues und Pull Requests verändern; einzelne Funktionen können sogar Repositories oder Dateien löschen. Repository-Inhalte können Prompt-Injection enthalten. Separate, minimal berechtigte Tokens verwenden, Secrets nie einchecken, zunächst Read-only- und Lockdown-Modus aktivieren und Änderungen durch Menschen prüfen lassen.

Lizenz und Kosten

Lizenz
MIT
Kosten
kostenlos

Server und Quellcode sind unter MIT-Lizenz kostenlos. Ein GitHub-Konto ist erforderlich; verfügbare Funktionen, Kontingente und mögliche Kosten richten sich nach dem verwendeten GitHub-Tarif und den API-Grenzen.

Alternativen

Auf einen Blick

Anbieter
GitHub
Status
Offizieller Server
Betriebsart
Lokal und Remote
Aktuelle Version
1.12.0
GitHub-Sterne
34,330
Zuletzt geprüft
07.09.2026

Repository und Dokumentation

Kategorien

Unterstützte Clients