Docker Hub MCP: primero descubre imágenes; luego decide si gestionas repositorios con un token

Para quién

Para quien necesita que un modelo descubra contenido de imágenes a través de la API de Docker Hub y, tras adjuntar un token de acceso personal, gestione repositorios. Encaja si Docker ya está instalado en local, tienes Node.js 22+ y aceptas esta premisa: el token es opcional, pero en cuanto envías HUB_PAT_TOKEN por HTTP, cualquiera que alcance esa entrada puede crear y modificar repositorios con esa identidad. No encaja si solo quieres mirar el catálogo web o planeas exponer el puerto HTTP a la red sin haber leído las notas de seguridad del código fuente. Página oficial: https://github.com/docker/hub-mcp

Primer intento en 3 minutos

Sigue una sola ruta oficial: tras construir en la raíz del repositorio, arranca con el stdio predeterminado. La primera vez no lo cambies a http.

Requisitos previos: Docker instalado y Node.js 22+. El token de acceso personal es opcional; en el primer intento no vincules el token al transporte HTTP.

Dónde instalar y arrancar: abre la raíz del repositorio oficial y ejecuta:

npm install
npm run build
npm start

El transporte predeterminado del código fuente es stdio; también permite npm start -- [--transport=http|stdio] [--port=3000] [--host=127.0.0.1]. La primera vez deja los valores predeterminados.

Acción de bajo riesgo: cuando el cliente MCP se conecte al proceso stdio, haz solo llamadas en la dirección de descubrimiento de contenido. El extracto solo menciona intelligent content discovery y repository management; no da nombres de herramientas ni parámetros concretos, así que no inventes comandos de consulta. Usa las herramientas que liste el cliente y prioriza la cuyo nombre parezca descubrimiento/consulta, no creación o modificación.

Señal de éxito: npm start sigue en ejecución con el stdio predeterminado y el cliente puede listar herramientas, en lugar de salir de inmediato por falta de build o por una versión de Node insuficiente. Si el proceso termina al momento, comprueba primero Node.js 22+ y si npm run build se completó.

Casos de uso

Caso 1: descubrimiento de contenido público. Corresponde a las frases del código «interfaces with Docker Hub APIs» e «intelligent content discovery». Con el stdio predeterminado y sin exigir token, haz que el cliente lance una llamada de tipo descubrimiento. La evidencia no escribe el nombre de la herramienta, los parámetros de filtro ni los campos de retorno, así que solo puedes confirmar si la llamada llegó a la API de Docker Hub y si el cliente devolvió un resultado o un error de API claro; no asumas que existe cierta sintaxis de búsqueda.

Caso 2: gestión de repositorios, con efectos secundarios. El código fuente indica que el transporte http usa el HUB_PAT_TOKEN del operador en cada llamada de herramienta, y quien pueda alcanzar esa entrada HTTP puede estar creating and modifying repositories. Si debes gestionar repositorios, proporciona el token al proceso en local antes de arrancar; el ejemplo del código es HUB_PAT_TOKEN=... npm start -- [--username=...]. Tras confirmar que el cliente está conectado a tu propio proceso y que HTTP sigue enlazado solo a 127.0.0.1, lanza una creación o una modificación. Punto de confirmación: el cambio esperado aparece en el repositorio correspondiente de Docker Hub. La evidencia no lista la tabla de parámetros de las herramientas de gestión; la parte que falta solo puede detenerse en «tiene capacidad de crear/modificar repositorios».

Límites de uso

HTTP se enlaza por defecto a 127.0.0.1 y exige autenticación; el código fuente pide leer Securing the HTTP transport antes de exponerlo a la red. No trates un HTTP sin endurecer como entrada compartida.

En cuanto alguien más alcance el HTTP que lleva el token del operador, podrá crear y modificar repositorios con esa identidad de Docker Hub. Una nota de solo lectura tampoco es riesgo cero: el proceso accederá a la API de Docker Hub y actuará con el token que proporcionaste.

El token es opcional en los requisitos previos, pero el extracto no aclara qué contenido privado se ve sin autenticación; no asumas que podrás leer repositorios privados.

La evidencia no da una lista de clientes ni un inventario completo de herramientas MCP; no completes comandos con otros complementos de Hub. Se necesitan Docker y Node.js 22+; si falta uno, no cambies a un método de instalación que no aparezca en el extracto.