Docker Hub MCP: primeiro descubra imagens; depois decida se gerencia repositórios com um token

Para quem é

Para quem precisa que um modelo faça descoberta de conteúdo de imagens pela API do Docker Hub e, após anexar um token de acesso pessoal, gerencie repositórios. Serve se o Docker já está instalado na máquina, há Node.js 22+ e você aceita esta premissa: o token é opcional, mas assim que o HUB_PAT_TOKEN vai no HTTP, quem alcançar essa entrada pode criar e modificar repositórios com essa identidade. Não serve para quem só quer ver o catálogo na web ou planeja expor a porta HTTP na rede sem ter lido as notas de segurança do código-fonte. Página oficial: https://github.com/docker/hub-mcp

Primeira tentativa em 3 minutos

Siga só um caminho oficial: depois de construir na raiz do repositório, inicie com o stdio padrão. Na primeira vez, não mude para http.

Pré-requisitos: Docker instalado e Node.js 22+. O token de acesso pessoal é opcional; na primeira tentativa, não vincule o token ao transporte HTTP.

Onde instalar e iniciar: abra a raiz do repositório oficial e execute:

npm install
npm run build
npm start

O transporte padrão do código-fonte é stdio; também permite npm start -- [--transport=http|stdio] [--port=3000] [--host=127.0.0.1]. Na primeira vez, mantenha os padrões.

Ação de baixo risco: depois que o cliente MCP conectar ao processo stdio, faça só chamadas na direção de descoberta de conteúdo. O trecho só menciona intelligent content discovery e repository management; não dá nomes concretos de ferramentas nem parâmetros, portanto não invente comandos de consulta. Use as ferramentas listadas pelo cliente e prefira a cujo nome pareça descoberta/consulta, não criação ou alteração.

Sinal de sucesso: npm start permanece em execução no stdio padrão e o cliente consegue listar ferramentas, em vez de sair imediatamente por falta de build ou versão insuficiente do Node. Se o processo terminar na hora, confira primeiro o Node.js 22+ e se o npm run build concluiu.

Casos de uso

Caso 1: descoberta de conteúdo público. Corresponde às frases do código «interfaces with Docker Hub APIs» e «intelligent content discovery». No stdio padrão, sem exigir token, faça o cliente emitir uma chamada do tipo descoberta. A evidência não escreve o nome da ferramenta, os parâmetros de filtro nem os campos de retorno, então só dá para confirmar se a chamada chegou à API do Docker Hub e se o cliente devolveu um resultado ou um erro de API explícito; não presuma que existe determinada sintaxe de busca.

Caso 2: gestão de repositórios, com efeitos colaterais. O código-fonte afirma que o transporte http usa o HUB_PAT_TOKEN do operador em cada chamada de ferramenta, e quem puder alcançar essa entrada HTTP pode estar creating and modifying repositories. Se for preciso gerenciar repositórios, forneça o token ao processo na máquina antes de iniciar; o exemplo do código é HUB_PAT_TOKEN=... npm start -- [--username=...]. Depois de confirmar que o cliente está ligado ao seu próprio processo e que o HTTP ainda está vinculado só a 127.0.0.1, dispare uma criação ou alteração. Ponto de confirmação: a mudança esperada aparece no repositório correspondente no Docker Hub. A evidência não lista a tabela de parâmetros das ferramentas de gestão; a parte que falta só pode parar em «tem capacidade de criar/alterar repositórios».

Limites de uso

O HTTP vincula-se por padrão a 127.0.0.1 e exige autenticação; o código-fonte pede para ler Securing the HTTP transport antes de expor na rede. Não trate um HTTP sem reforço como entrada compartilhada.

Assim que alguém alcançar o HTTP que carrega o token do operador, essa pessoa poderá criar e modificar repositórios com essa identidade do Docker Hub. Um aviso de somente leitura também não é risco zero: o processo acessará a API do Docker Hub e agirá com o token que você forneceu.

O token é opcional nos pré-requisitos, mas o trecho não deixa claro quais conteúdos privados são visíveis sem autenticação; não presuma que dá para ler repositórios privados.

A evidência não dá lista de clientes nem inventário completo de ferramentas MCP; não complete comandos com outros plugins do Hub. É preciso Docker e Node.js 22+; se faltar um, não mude para um método de instalação que não aparece no trecho.