Come collegare MLB Stats API a Gemini via MCP

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

MLB Stats API + Gemini

Dati ufficiali della MLB Stats API, senza API key: calendari e partite live, box score, line score, play by play, squadre, rose, classifiche, giocatori, statistiche, leader di lega e transazioni per la MLB e le minor league. Uso personale e non commerciale secondo i termini della MLB.

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 la MLB Stats API, il feed di dati pubblico dietro MLB.com e l'app MLB. Non servono un account MLB, una API key o un accesso.

1. Nello store dei connettori, scegli MLB Stats API e installalo. Non c'è nulla da inserire e nessun passaggio Authorize with Provider.
2. Verificalo con mlb_list_teams: elenca le squadre MLB con id, lega, division e stadio.

Solo uso personale e non commerciale: i dati appartengono a MLB Advanced Media e ogni risposta riporta l'avviso di copyright della MLB. I termini della MLB consentono un uso individuale, non commerciale e non massivo. Non costruire su questo connettore un prodotto commerciale o un'esportazione massiva: per quello serve una licenza dalla MLB o da un fornitore di dati sportivi.

Rete: tramite il proxy dei connettori: i server della MLB rifiutano molte richieste da indirizzi di datacenter con HTTP 406 Not Acceptable, mentre la stessa richiesta da una connessione di casa o d'ufficio funziona. Per questo ogni strumento passa dal proxy dei connettori dell'istanza. Su AnythingMCP Cloud il proxy è già configurato, con un limite orario per workspace. Un'istanza self-hosted in un datacenter ha bisogno di CONNECTOR_PROXY_URL; su una connessione di casa o d'ufficio funziona anche senza. Un 406 significa bloccato da questa rete, non parametro sbagliato.

Cosa legge: calendari di un giorno o di un intervallo di date, con stato, punteggio e lanciatori probabili; partite live con tutte le azioni da punto e il turno di battuta in corso; box score, line score e play by play; squadre, rose (il roster attivo da 26, il 40-man, la stagione intera e il depth chart) e classifiche con le posizioni per la wild card; giocatori con profilo e statistiche (stagione, carriera, anno per anno, game log, split, contro una squadra); statistiche di squadra; leader di lega; movimenti di roster come scambi, ingaggi e inserimenti nella injured list; e le date chiave di una stagione. Oltre alla MLB copre Triple-A, Double-A, High-A, Single-A, Rookie e le leghe invernali.

Id: partite tramite game_pk da mlb_get_schedule, squadre tramite team_id (147 Yankees, 119 Dodgers) da mlb_list_teams, giocatori tramite person_id da mlb_search_people o da un roster. L'AI converte da sola i nomi in id.

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

Leggere i dati: gli orari delle partite arrivano in UTC e l'AI li converte nel tuo fuso orario; la data ufficiale è la data locale della partita. Medie e percentuali come AVG, OBP, OPS ed ERA arrivano come testo, per esempio .305. Il feed live è grande, quindi l'AI legge prima il riepilogo della partita e passa a box score, line score o play by play per i dettagli.

Limiti: la MLB non pubblica SLA né limiti di richieste, quindi l'AI fa poche chiamate e non interroga una partita in corso ogni pochi secondi. Su Cloud il proxy ha un limite orario per workspace.

Il connettore non accede a un account MLB, non trasmette partite o video e non fornisce dati per uso commerciale o massivo.

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 MLB Stats API.

Tool disponibili

Esempi di prompt

• "Quando giocano i Dodgers questa settimana, e chi sono i lanciatori probabili?"
• "Dammi il box score dell'ultima partita dei Yankees, con il numero di lanci di ogni lanciatore."
• "Chi guida l'American League per fuoricampo e OPS in questa stagione?"
• "Mostrami la classifica della AL East e la corsa alla wild card."
• "Quali movimenti di roster hanno fatto i Mets nelle ultime due settimane?"

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