Docker Hub MCP Server

Docker Hub MCP Server

Un servidor de Model Context Protocol (MCP) para consultar estadísticas de imágenes de Docker Hub. Proporciona recuentos de pulls, recuentos de estrellas, descripciones, estado oficial/verificado y catálogos de publicadores a través de la API pública de Docker Hub — no se requiere clave de API.

Características

• get_image_stats(image) — metadatos de una sola imagen (pulls, estrellas, last_updated, descripción, is_official, is_verified)
• search_images(query, limit) — búsqueda por palabras clave en Docker Hub
• batch_image_stats(images) — consulta concurrente de hasta 100 imágenes
• get_publisher_images(publisher, limit) — catálogo de todas las imágenes de un namespace (p. ej. library, bitnami, grafana)

Instalación

uv (recomendado)

uvx docker-hub-mcp

pip

pip install docker-hub-mcp
docker-hub-mcp

Configuración

Claude Desktop

Añade a claude_desktop_config.json:

{
  "mcpServers": {
    "docker-hub-mcp": {
      "command": "uvx",
      "args": ["docker-hub-mcp"]
    }
  }
}

Cursor / VS Code

Añade a tu configuración de MCP:

{
  "mcpServers": {
    "docker-hub-mcp": {
      "command": "uvx",
      "args": ["docker-hub-mcp"]
    }
  }
}

Hermes Agent (MCP Gateway)

Añade a ~/.hermes/gateway.yaml:

docker-hub-mcp:
  command: uvx docker-hub-mcp
  lazy_spawn: true
  timeout: 30s
  env: {}

Herramientas

Herramienta	Descripción	Parámetros clave
get_image_stats	Recuento de pulls, recuento de estrellas, última actualización, descripción, estado oficial/verificado	image (obligatorio) — "nginx" o "grafana/grafana"
search_images	Búsqueda por palabras clave, resultados clasificados	query (obligatorio), limit (por defecto 50)
batch_image_stats	Consulta concurrente de hasta 100 imágenes	images (obligatorio, lista)
get_publisher_images	Todas las imágenes de un namespace	publisher (obligatorio), limit (por defecto 100)

Ejemplos

# Get stats for nginx
get_image_stats({"image": "nginx"})
# → pull_count: 13.2B, star_count: 21K, is_official: true

# Search for postgres
search_images({"query": "postgres", "limit": 5})
# → ranked results with pulls, stars, official flags

# Batch compare web servers
batch_image_stats({"images": ["nginx", "httpd", "caddy", "traefik"]})

# Catalog a publisher
get_publisher_images({"publisher": "bitnami", "limit": 25})

Fuente de datos

Utiliza la API de Docker Hub (/v2/repositories y /v2/search).

• Autenticación: No se requiere para datos públicos
• Límite de peticiones: ~4.400 solicitudes cada 6 horas (sin autenticación)

Desarrollo

git clone https://github.com/GeniusTechnoMystic/docker-hub-mcp.git
cd docker-hub-mcp
uv sync
uv run docker-hub-mcp

Ejecuta las pruebas:

uv run pytest tests/

Proyectos relacionados

Otros servidores MCP de Docker Hub en el ecosistema:

Proyecto	Lenguaje	Herramientas	Autenticación	Pruebas	Instalación
docker/hub-mcp (oficial)	TypeScript	13	PAT (opcional)	Sí	npm install
lucadruda/docker-hub-mcp-server	TypeScript	49 (dinámicas)	PAT	Ninguna	npm install
RSVINEETHA/DockerHub-MCP-Server	TypeScript	8	PAT (obligatorio)	Ninguna	npm install
Este (el nuestro)	Python	4	Ninguna	46 pruebas	uvx / pip install

Nuestros diferenciadores

• Cero autenticación — sin clave de API, sin PAT, sin cuenta de Docker. Solo uvx docker-hub-mcp
• Ecosistema Python — única implementación en Python. Instala mediante pip o uvx, sin necesidad de Node.js
• Operaciones por lotes — batch_image_stats es único — ningún competidor ofrece consulta concurrente de múltiples imágenes
• Cobertura de pruebas — 46 pruebas con HTTP simulado (pytest-httpx), la suite de pruebas más completa de cualquier servidor MCP de Docker Hub
• Licencia MIT — permisiva, fácil de integrar

Cuándo usar las alternativas

• docker/hub-mcp — si necesitas gestión de repositorios (crear, actualizar, eliminar), listado de etiquetas o Docker Hardened Images. Requiere PAT para operaciones de escritura.
• lucadruda/docker-hub-mcp-server — si necesitas cobertura completa de la API de Docker Hub (colaboradores, webhooks, estrellas, namespaces). Requiere PAT.
• RSVINEETHA/DockerHub-MCP-Server — alternativa mínima, requiere PAT.

Licencia

MIT