Docker Hub MCP Server

Servidor MCP do Docker Hub

Um servidor Model Context Protocol (MCP) para consultar estatísticas de imagens do Docker Hub. Fornece contagens de pulls, contagens de estrelas, descrições, status oficial/verificado e catálogos de editores por meio da API pública do Docker Hub — sem necessidade de chave de API.

Recursos

• get_image_stats(image) — metadados de uma única imagem (pulls, estrelas, última atualização, descrição, is_official, is_verified)
• search_images(query, limit) — busca por palavras-chave no Docker Hub
• batch_image_stats(images) — consulta simultânea de até 100 imagens
• get_publisher_images(publisher, limit) — catálogo de todas as imagens de um namespace (ex.: library, bitnami, grafana)

Instalação

uv (recomendado)

uvx docker-hub-mcp

pip

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

Configuração

Claude Desktop

Adicione em claude_desktop_config.json:

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

Cursor / VS Code

Adicione à sua configuração do MCP:

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

Hermes Agent (MCP Gateway)

Adicione em ~/.hermes/gateway.yaml:

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

Ferramentas

Ferramenta	Descrição	Parâmetros principais
get_image_stats	Contagem de pulls, contagem de estrelas, última atualização, descrição, status oficial/verificado	image (obrigatório) — "nginx" ou "grafana/grafana"
search_images	Busca por palavras-chave, resultados classificados	query (obrigatório), limit (padrão 50)
batch_image_stats	Consulta simultânea de até 100 imagens	images (obrigatório, lista)
get_publisher_images	Todas as imagens em um namespace	publisher (obrigatório), limit (padrão 100)

Exemplos

# 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})

Fonte de Dados

Usa a API do Docker Hub (/v2/repositories e /v2/search).

• Autenticação: Nenhuma necessária para dados públicos
• Limite de taxa: ~4.400 solicitações por 6 horas (sem autenticação)

Desenvolvimento

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

Execute os testes:

uv run pytest tests/

Projetos Relacionados

Outros servidores MCP do Docker Hub no ecossistema:

Projeto	Linguagem	Ferramentas	Autenticação	Testes	Instalação
docker/hub-mcp (oficial)	TypeScript	13	PAT (opcional)	Sim	npm install
lucadruda/docker-hub-mcp-server	TypeScript	49 (dinâmico)	PAT	Nenhum	npm install
RSVINEETHA/DockerHub-MCP-Server	TypeScript	8	PAT (obrigatório)	Nenhum	npm install
Este (nosso)	Python	4	Nenhuma	46 testes	uvx / pip install

Nossos diferenciais

• Zero autenticação — sem chave de API, sem PAT, sem necessidade de conta Docker. Apenas uvx docker-hub-mcp
• Ecossistema Python — única implementação em Python. Instale via pip ou uvx, sem necessidade de Node.js
• Operações em lote — batch_image_stats é exclusivo — nenhum concorrente oferece consulta simultânea de múltiplas imagens
• Cobertura de testes — 46 testes com HTTP simulado (pytest-httpx), a suíte de testes mais completa de qualquer servidor MCP do Docker Hub
• Licença MIT — permissiva, fácil de incorporar

Quando usar as alternativas

• docker/hub-mcp — se você precisar de gerenciamento de repositórios (criar, atualizar, excluir), listagem de tags ou Docker Hardened Images. Requer PAT para operações de escrita.
• lucadruda/docker-hub-mcp-server — se você precisar de cobertura completa da API do Docker Hub (colaboradores, webhooks, estrelas, namespaces). Requer PAT.
• RSVINEETHA/DockerHub-MCP-Server — alternativa mínima, requer PAT.

Licença

MIT