Come collegare Eurostat a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Eurostat, installalo senza chiave, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Eurostat + Gemini

Statistiche ufficiali dell'Unione europea da Eurostat, senza API key: leggi uno qualsiasi dei circa 8.000 dataset (PIL, inflazione, disoccupazione, popolazione, energia, ambiente, dati regionali NUTS) filtrando per paese, periodo e dimensione, esamina dimensioni, codici e disponibilità tramite SDMX, consulta le liste di codici, segui il feed degli aggiornamenti quotidiani e interroga i dati dettagliati sul commercio Comext.

Prerequisiti

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

(nessuna: dati pubblici, nessuna API key)

Step 1 — Configura il connettore

Dati pubblici, senza chiave: la configurazione richiede meno di un minuto. Il connettore legge le API pubbliche di diffusione di Eurostat, l'ufficio statistico dell'Unione europea (https://ec.europa.eu/eurostat/api/dissemination). Sono gratuite e non servono un account, una API key o un accesso.

1. Nello store dei connettori scegli Eurostat e installalo. Non c'è nulla da inserire e nessun passaggio Authorize with Provider.
2. Verificalo con eurostat_get_dataset_info e il dataset nama_10_gdp: mostra il titolo del PIL annuale, il numero di osservazioni, il periodo più vecchio e più recente e l'ultimo aggiornamento.

Riutilizzo: i dati si possono riutilizzare secondo l'avviso di copyright di Eurostat. Cita "Fonte: Eurostat" con il codice del dataset.

Trovare un dataset: non esiste una ricerca per parole chiave, quindi l'AI lavora con i codici dei dataset. Conosce quelli più usati, come nama_10_gdp (PIL annuale), namq_10_gdp (PIL trimestrale), prc_hicp_manr (inflazione IPCA, tasso annuo), une_rt_m (disoccupazione mensile), demo_pjan (popolazione al 1° gennaio), gov_10dd_edpt1 (deficit e debito pubblico), nrg_pc_204 (prezzi dell'elettricità per le famiglie), env_air_gge (emissioni di gas serra) e nama_10r_2gdp (PIL regionale per NUTS 2). Qualsiasi altro codice compare nell'URL e nel titolo del dataset nel Data Browser di Eurostat (https://ec.europa.eu/eurostat/databrowser). eurostat_list_recent_updates elenca i dataset aggiunti, eliminati o aggiornati negli ultimi 7 giorni, e eurostat_list_comext_datasets i dataset Comext e PRODCOM.

Cosa legge:

• Circa 8.000 dataset su economia, prezzi, mercato del lavoro, popolazione, salute, istruzione, energia, ambiente, agricoltura, trasporti e regioni (NUTS da 1 a 3).
• I metadati di un dataset: titolo, numero di osservazioni, periodo più vecchio e più recente, ultimo aggiornamento di dati e struttura, prossimo aggiornamento previsto, istituzioni fonte e pagina della metodologia (ESMS).
• Le dimensioni di un dataset nell'ordine della chiave, con ogni codice usato e la sua etichetta, i codici che hanno davvero dati insieme ai periodi disponibili, la struttura dati SDMX e intere liste di codici come GEO, UNIT, NA_ITEM o NACE_R2.
• Valori filtrati per paese o regione (geo, oppure geoLevel per tutti i paesi, le regioni NUTS 1, 2 o 3 o le città in un colpo solo), periodo, unit, freq e qualsiasi altra dimensione tramite filters, un valore per dimensione.
• Serie tramite chiave SDMX, quando una dimensione diversa da geo, time, unit o freq richiede più valori, per esempio A.CP_MEUR.B1GQ+P3.DE+FR.
• Il commercio dettagliato di merci dell'UE da Comext per paese dichiarante, paese partner, prodotto (dai capitoli HS fino al CN8), flusso e indicatore, e la produzione industriale PRODCOM.
• Il feed ufficiale degli aggiornamenti degli ultimi 7 giorni, rigenerato alle 11:00 e alle 23:00 CET.

Formati dei dati: i valori arrivano in JSON-stat 2.0. id elenca le dimensioni in ordine e size il numero di codici restituiti per ciascuna; dimension.<id>.category associa a ogni codice la sua posizione e la sua etichetta; value contiene le celle indicizzate per posizione piatta, e le celle mancanti non compaiono. status segnala le celle, per esempio p provvisorio, e stimato, b interruzione della serie, c riservato. L'AI legge l'unità prima di confrontare le cifre (milioni di euro, percentuale o indice). I periodi hanno la forma 2024, 2024-Q3, 2024-09 o 2024-09-30. Eurostat pubblica con un certo ritardo, quindi l'AI cita l'ultimo periodo restituito, non la data di oggi. Le etichette sono in inglese di default, oppure in francese o tedesco con lang.

Filtri temporali: lastTimePeriod 1 restituisce il valore più recente; sinceTimePeriod e untilTimePeriod danno un intervallo e sono gli unici due parametri temporali combinabili. In Comext lastTimePeriod conta anche i mesi futuri vuoti, quindi lì l'AI preferisce sinceTimePeriod.

Nessuna paginazione: una richiesta restituisce tutte le celle corrispondenti in una volta. Per questo l'AI filtra per paese, unità e periodo, così le risposte restano piccole.

Solo lettura: ogni strumento legge soltanto, quindi non c'è nulla da confermare e nessuno strumento è disattivato all'installazione.

Limiti: le richieste stimate sopra le 500.000 celle non ricevono risposta immediata, e sopra le 5.000.000 vengono rifiutate con 413 "EXTRACTION_TOO_BIG". Una risposta con warning.status 413 "ASYNCHRONOUS_RESPONSE" significa che Eurostat sta ancora preparando l'estrazione: l'AI restringe i filtri o riprova poco dopo. Le liste di codici complete sono grandi (GEO ha più di 3.000 codici), quindi per un singolo dataset l'AI usa eurostat_get_dataset_codes. La dimensione prodotto di Comext ha decine di migliaia di codici, perciò l'AI imposta sempre paese dichiarante, prodotto, flusso e indicatore.

Errori comuni: 400 indica il problema in error[0].label, per esempio un filtro su una dimensione che il dataset non ha, oppure geo e geoLevel inviati insieme. 404 "is not available for dissemination" indica un codice di dataset sconosciuto o rimosso. Un value vuoto significa che per quella combinazione non ci sono dati: l'AI controlla i codici con eurostat_get_dataset_availability.

Il connettore non scarica i file bulk in TSV o SDMX, non legge l'indice completo dei contenuti e non usa l'API di estrazione asincrona.

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 Eurostat.

Tool disponibili

Esempi di prompt

• "Di quanto è cresciuto il PIL reale di Germania, Francia e Italia negli ultimi cinque anni?"
• "Mostra l'ultimo tasso di inflazione IPCA annuo per ogni paese dell'area euro, dal più alto."
• "Come è cambiato il tasso di disoccupazione mensile in Spagna da gennaio 2020?"
• "Quali regioni NUTS 2 della Polonia hanno il PIL più alto, e come è cambiato dal 2015?"
• "Quanto ha esportato ogni anno la Germania negli Stati Uniti in veicoli (capitolo HS 87) dal 2022, in euro?"

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
• Collegare a Cursor
• Collegare a Meta Muse
• Collegare a Microsoft Copilot