Docker Hub MCP: Zuerst Images finden, dann entscheiden, ob ein Token die Repositories verwaltet

Für wen

Für alle, die ein Modell über die Docker Hub API Inhalte von Images entdecken und nach dem Anhängen eines persönlichen Zugriffstokens Repositories verwalten lassen müssen. Passend, wenn Docker lokal installiert ist, Node.js 22+ vorhanden ist und diese Prämisse akzeptiert wird: Das Token ist optional, aber sobald HUB_PAT_TOKEN per HTTP mitgeschickt wird, kann jeder, der diesen Einstieg erreicht, in dieser Identität Repositories anlegen und ändern. Nicht geeignet, wer nur den Webkatalog durchstöbern will oder den HTTP-Port ins Netz legen will, ohne die Sicherheitshinweise im Quelltext gelesen zu haben. Offizielle Seite: https://github.com/docker/hub-mcp

Erster Versuch in 3 Minuten

Nur einen offiziellen Weg gehen: Nach dem Build im Repository-Root mit dem Standard-stdio starten. Beim ersten Mal nicht auf http umstellen.

Voraussetzungen: Docker ist installiert, dazu Node.js 22+. Ein persönliches Zugriffstoken ist optional; beim ersten Versuch das Token nicht an den HTTP-Transport binden.

Installations- und Startort: Das Root-Verzeichnis des offiziellen Repositories öffnen und ausführen:

npm install
npm run build
npm start

Der Standardtransport im Quelltext ist stdio; erlaubt ist auch npm start -- [--transport=http|stdio] [--port=3000] [--host=127.0.0.1]. Beim ersten Mal die Defaults belassen.

Aktion mit geringem Risiko: Nachdem der MCP-Client den stdio-Prozess verbunden hat, nur Aufrufe in Richtung Inhaltsentdeckung machen. Der Auszug nennt nur intelligent content discovery und repository management, keine konkreten Toolnamen oder Parameter – also keine Abfragebefehle erfinden. Die vom Client aufgelisteten Tools gelten; bevorzugt eines, dessen Name nach Entdecken/Abfragen klingt, nicht nach Anlegen oder Ändern.

Erfolgssignal: npm start bleibt unter Standard-stdio laufen, der Client kann Tools auflisten – statt sofort wegen fehlendem Build oder zu alter Node-Version zu beenden. Endet der Prozess sofort, zuerst Node.js 22+ und den Abschluss von npm run build prüfen.

Anwendungsfälle

Fall 1: Öffentliche Inhaltsentdeckung. Entspricht den Quelltextstellen «interfaces with Docker Hub APIs» und «intelligent content discovery». Unter Standard-stdio und ohne Token-Pflicht eine Entdeckungsabfrage über den Client starten. Die Belege nennen weder Toolnamen noch Filterparameter noch Rückgabefelder; prüfen lässt sich nur, ob der Aufruf die Docker Hub API erreicht und ob der Client ein Ergebnis oder einen klaren API-Fehler liefert. Keine bestimmte Suchsyntax unterstellen.

Fall 2: Repository-Verwaltung mit Nebenwirkungen. Der Quelltext hält fest, dass der http-Transport das HUB_PAT_TOKEN des Betreibers für jeden Toolaufruf verwendet; wer diesen HTTP-Einstieg erreicht, kann creating and modifying repositories. Wenn Repositories verwaltet werden müssen, dem Prozess das Token lokal bereitstellen und dann starten; das Quellbeispiel ist HUB_PAT_TOKEN=... npm start -- [--username=...]. Erst wenn der Client mit dem eigenen Prozess verbunden ist und HTTP weiter nur an 127.0.0.1 gebunden ist, Anlegen oder Ändern auslösen. Prüfpunkt: Die erwartete Änderung erscheint am entsprechenden Repository auf Docker Hub. Die Belege listen keine Parametertabelle der Verwaltungstools; der fehlende Teil bleibt bei «kann Repositories anlegen/ändern».

Nutzungsgrenzen

HTTP bindet standardmäßig an 127.0.0.1 und verlangt Authentifizierung; der Quelltext fordert, vor einer Netzfreigabe Securing the HTTP transport zu lesen. Ungehärtetes HTTP nicht als gemeinsamen Einstieg behandeln.

Sobald HTTP mit dem Betreiber-Token von jemand anderem erreicht wird, kann diese Person in dieser Docker-Hub-Identität Repositories anlegen und ändern. Ein Hinweis auf Nur-Lesen ist kein Nullrisiko: Der Prozess spricht die Docker Hub API an und handelt mit dem bereitgestellten Token.

In den Voraussetzungen ist das Token optional, der Auszug sagt aber nicht, welche privaten Inhalte ohne Authentifizierung sichtbar sind; nicht unterstellen, dass private Repositories lesbar sind.

Die Belege nennen weder eine Clientliste noch ein vollständiges MCP-Toolinventar; Befehle nicht aus anderen Hub-Plugins ergänzen. Docker und Node.js 22+ sind nötig; fehlt eines, nicht auf eine Installationsmethode ausweichen, die im Auszug nicht vorkommt.