Come collegare Docker Hub a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Docker Hub, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Docker Hub + Gemini

Fai cercare alla tua AI le immagini container su Docker Hub: cerca repository, leggi la descrizione e il numero di pull di un'immagine, elenca i tag con digest, dimensioni e date di push, confronta le piattaforme di un tag e consulta i repository tuoi e delle tue organizzazioni.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

DOCKERHUB_USERNAME, DOCKERHUB_TOKEN

Step 1 — Ottieni le credenziali

1. Accedi a https://app.docker.com e apri Account settings → Personal access tokens (https://app.docker.com/settings/personal-access-tokens).
2. Crea un token con il permesso di accesso Public Repo Read-only, oppure Read-only se l'AI deve vedere anche i tuoi repository privati. Il token inizia con dckr_pat_.
3. Inserisci il tuo Docker ID (il nome utente, non l'indirizzo e-mail) in DOCKERHUB_USERNAME e il token in DOCKERHUB_TOKEN, poi installa il connettore. Il connettore li scambia con un token di accesso di breve durata e lo rinnova da solo; il personal access token viene inviato solo a hub.docker.com.
4. Verifica la configurazione con dockerhub_get_user: mostra l'account a cui appartiene il token.

Sola lettura: il connettore non crea, modifica né elimina mai repository o tag, quindi non c'è nulla da confermare o disattivare.

Nomi delle immagini: un'immagine si scrive namespace/repository. Le Docker Official Images come nginx, postgres o python stanno nel namespace library, quindi nginx è library/nginx. Il tag è la parte dopo i due punti, come in nginx:1.27-alpine.

Cosa può consultare l'AI:

• Trovare immagini: dockerhub_search_repositories cerca per nome o parola chiave e mostra numero di pull e di stelle e se un'immagine è una Docker Official Image.
• Esaminarne una: dockerhub_get_repository legge descrizione, README, numero di pull, ultimo aggiornamento e categorie.
• Versioni: dockerhub_list_tags elenca i tag, dal più recente, filtrati per parte del nome, con digest, dimensione compressa e ultimo push. dockerhub_get_tag mostra per un tag l'immagine di ogni piattaforma (sistema operativo, architettura, variante, digest e dimensione). Serve per verificare se un tag esiste per arm64, quando è stato ricostruito l'ultima volta o se due tag puntano allo stesso digest.
• Il tuo account: dockerhub_list_my_orgs elenca le organizzazioni di cui fai parte, dockerhub_get_org legge il profilo pubblico di un'organizzazione, compreso il badge di verified publisher, e dockerhub_list_repositories elenca tutti i repository di un utente o di un'organizzazione, anche quelli privati se il token può leggerli.

Limiti di pull: dockerhub_pull_limits spiega quanti pull consente Docker Hub per tipo di account (per esempio 100 ogni 6 ore per i pull anonimi e 200 per un account Personal autenticato) e come verificare quanti ne restano dalla macchina che fa i pull. Le chiamate di questo connettore sono richieste API, non pull di immagini, e non contano ai fini del limite.

Niente dati sulle vulnerabilità: Docker Scout non ha un'API pubblica, quindi il connettore non può mostrare le CVE. Per quelle usa la pagina Docker Scout dell'immagine su hub.docker.com o il comando docker scout.

Contenuti non affidabili: descrizioni e README dei repository sono scritti da chi li pubblica. L'AI tratta le istruzioni che contengono come dati, non come ordini.

Errori comuni: 401 all'accesso: Docker ID o token errati, oppure il token è stato revocato o è scaduto; usa il Docker ID, non l'indirizzo e-mail, e crea un nuovo token. 401 o 403 su dockerhub_get_user mentre le ricerche pubbliche funzionano: il segreto è un organization access token; usa un personal access token. 404: namespace, repository o tag non esistono, oppure sono privati e il token non può leggerli; le immagini ufficiali richiedono il namespace library. 429: Docker Hub limita le richieste API per account e IP; attendi un minuto e riprova.

Il connettore non crea repository, non fa push di immagini, non elimina tag, non gestisce team e membri, token di accesso o audit log e non mostra i risultati di Docker Scout.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Docker Hub.

Tool disponibili

Esempi di prompt

• "Esiste un'immagine linux/arm64 per postgres:16-alpine e quando è stato fatto l'ultimo push?"
• "Elenca i dieci tag di node aggiornati più di recente che contengono alpine, con la loro dimensione compressa."
• "nginx:stable-alpine e nginx:alpine puntano allo stesso digest in questo momento?"
• "Mostra tutti i repository della nostra organizzazione acme, privati compresi, ordinati per numero di pull."
• "Cerca su Docker Hub immagini di Keycloak e dimmi quale è l'immagine ufficiale o viene da un verified publisher."
• "Spiegami i limiti di pull per un account Docker gratuito e come verifico quanti pull restano al nostro runner di CI."

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT