Docker Hub MCP : d’abord découvrir les images, puis décider d’attacher un jeton pour gérer les dépôts

À qui ça s’adresse

À ceux qui ont besoin qu’un modèle fasse de la découverte de contenu d’images via l’API Docker Hub, puis gère des dépôts une fois un jeton d’accès personnel attaché. Convient si Docker est déjà installé en local, si Node.js 22+ est disponible, et si l’on accepte cette prémisse : le jeton est facultatif, mais dès que HUB_PAT_TOKEN circule en HTTP, quiconque atteint cette entrée peut créer et modifier des dépôts sous cette identité. Ne convient pas à qui veut seulement parcourir le catalogue web, ou prévoit d’exposer le port HTTP sur le réseau sans avoir lu les consignes de sécurité du code source. Page officielle : https://github.com/docker/hub-mcp

Premier essai en 3 minutes

Une seule voie officielle : après le build à la racine du dépôt, démarrer avec le stdio par défaut. Ne pas passer en http dès le premier essai.

Prérequis : Docker est installé, ainsi que Node.js 22+. Un jeton d’accès personnel est facultatif ; au premier essai, ne pas lier le jeton au transport HTTP.

Emplacement d’installation et de démarrage : ouvrir la racine du dépôt officiel et exécuter :

npm install
npm run build
npm start

Le transport par défaut du code source est stdio ; npm start -- [--transport=http|stdio] [--port=3000] [--host=127.0.0.1] est aussi autorisé. Garder les valeurs par défaut la première fois.

Action à faible risque : une fois le client MCP connecté au processus stdio, n’émettre que des appels dans le sens de la découverte de contenu. L’extrait ne mentionne que intelligent content discovery et repository management, sans noms d’outils ni paramètres concrets ; ne pas inventer de commandes de requête. S’en tenir aux outils listés par le client, et préférer celui dont le nom évoque une découverte / une consultation plutôt qu’une création ou une modification.

Signal de succès : npm start reste en cours sous le stdio par défaut, et le client peut lister les outils — au lieu de quitter tout de suite faute de build ou à cause d’une version Node insuffisante. Si le processus s’arrête immédiatement, vérifier d’abord Node.js 22+ et l’achèvement de npm run build.

Cas d’usage

Cas 1 : découverte de contenu public. Correspond aux formulations source « interfaces with Docker Hub APIs » et « intelligent content discovery ». Sous le stdio par défaut, sans exiger de jeton, faire émettre au client un appel de type découverte. Les preuves n’indiquent ni le nom d’outil, ni les paramètres de filtre, ni les champs renvoyés ; on ne peut que vérifier si l’appel a atteint l’API Docker Hub et si le client a renvoyé un résultat ou une erreur d’API explicite. Ne pas supposer une syntaxe de recherche particulière.

Cas 2 : gestion de dépôts, avec effets de bord. Le code source indique que le transport http utilise le HUB_PAT_TOKEN de l’opérateur pour chaque appel d’outil ; quiconque atteint cette entrée HTTP peut être creating and modifying repositories. S’il faut gérer des dépôts, fournir le jeton au processus en local avant de démarrer ; l’exemple source est HUB_PAT_TOKEN=... npm start -- [--username=...]. Après avoir confirmé que le client est connecté à votre propre processus et que HTTP n’est toujours lié qu’à 127.0.0.1, lancer une création ou une modification. Point de contrôle : le changement attendu apparaît sur le dépôt correspondant dans Docker Hub. Les preuves ne listent pas la table des paramètres des outils de gestion ; la partie manquante s’arrête à « a la capacité de créer / modifier des dépôts ».

Limites d’usage

HTTP se lie par défaut à 127.0.0.1 et exige une authentification ; le code source demande de lire Securing the HTTP transport avant toute exposition sur le réseau. Ne pas traiter un HTTP non durci comme une entrée partagée.

Dès qu’un HTTP portant le jeton de l’opérateur est atteint par quelqu’un d’autre, cette personne peut créer et modifier des dépôts sous cette identité Docker Hub. Un avertissement « lecture seule » n’équivaut pas à un risque nul : le processus accède à l’API Docker Hub et agit selon le jeton fourni.

Le jeton est facultatif dans les prérequis, mais l’extrait ne précise pas quels contenus privés sont visibles sans authentification ; ne pas supposer qu’on peut lire les dépôts privés.

Les preuves ne donnent ni liste de clients ni inventaire complet des outils MCP ; ne pas compléter les commandes à partir d’autres greffons Hub. Docker et Node.js 22+ sont requis ; s’il en manque un, ne pas basculer vers un mode d’installation absent de l’extrait.