Integrazione del Model Context Protocol (MCP)

L'API Travel Impact Model (TIM) supporta il Model Context Protocol (MCP), uno standard aperto progettato per consentire agli agenti AI e ai modelli linguistici di grandi dimensioni (LLM) di interagire con API e strumenti. Utilizzando l'endpoint MCP, gli agenti AI possono scoprire e utilizzare in modo dinamico le funzionalità dell'API TIM per calcolare le emissioni dei voli.

Per ulteriori informazioni sul protocollo, consulta la specifica del Model Context Protocol.

Endpoint

L'endpoint MCP per l'API Travel Impact Model è:

https://travelimpactmodel.googleapis.com/mcp

Tutte le interazioni MCP vengono eseguite inviando richieste POST JSON-RPC 2.0 a questo endpoint.

Autenticazione

L'endpoint MCP utilizza gli stessi metodi di autenticazione dell'API Travel Impact Model standard. Devi fornire una chiave API valida dal tuo progetto cloud Google, assicurandoti che l'API "Travel Impact Model" sia abilitata.

Metodi MCP principali

Le interazioni con l'endpoint MCP utilizzano principalmente due metodi:

  • tools/list: rileva gli strumenti disponibili, le relative descrizioni e gli schemi JSON di input/output.
  • tools/call: esegue uno strumento specifico con gli argomenti specificati.

Strumenti disponibili

Le seguenti funzionalità sono esposte come strumenti:

  • compute_flight_emissions: recupera le emissioni dettagliate per voli specifici in programma.
  • compute_typical_flight_emissions: recupera le emissioni tipiche tra coppie di aeroporti, senza richiedere dettagli specifici del volo.
  • compute_scope3_flight_emissions: recupera le emissioni per i voli storici, adatte per la generazione di report di ambito 3.

Gli schemi esatti per input e output sono forniti nella risposta tools/list.

Eseguire l'integrazione con gli agenti AI

Configura le applicazioni AI più diffuse utilizzando queste istruzioni. Sostituisci YOUR_API_KEY con la chiave API Travel Impact Model.

Gemini CLI

Per configurare Gemini CLI, segui questi passaggi:

  1. Crea un file di estensione in ~/.gemini/extensions/travel-impact-model/gemini-extension.json.

  2. Salva i seguenti contenuti nel file:

    {
  "name": "travel-impact-model",
  "version": "3.0.0",
  "mcpServers": {
    "travel-impact-model": {
      "httpUrl": "https://travelimpactmodel.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

  3. Avvia Gemini CLI eseguendo gemini nel terminale.

  4. Esegui /mcp list per verificare che il server travel-impact-model sia configurato e che i relativi strumenti siano disponibili.

Antigravity

Per configurare Antigravity in modo che utilizzi il server MCP:

  1. In Antigravity, fai clic sul menu Altre opzioni nel riquadro Agente > Server MCP > Gestisci server MCP.

  2. Nella parte superiore del riquadro Gestisci server MCP che si apre, fai clic su Visualizza configurazione non elaborata per modificare il file mcp_config.json:

    {
  "mcpServers": {
    "TravelImpactModel": {
      "serverUrl": "https://travelimpactmodel.googleapis.com/mcp",
      "headers": {
        "X-Goog-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

  3. Torna a Gestisci server MCP e fai clic su Aggiorna.

Esempi di interazioni

Una volta configurata, puoi interagire con l'API TIM tramite l'agente AI utilizzando il linguaggio naturale.

Utente: quali sono le emissioni del volo LX 52 da Zurigo a Boston?

Agente: le emissioni di anidride carbonica previste per passeggero per il volo LX 52 di Swiss International Air Lines da Zurigo (ZRH) a Boston (BOS) per oggi, 25 marzo 2026, sono le seguenti:

  • Spedizione economica: 354,10 kg di CO2e
  • Premium Economy: 531,14 kg di CO2e
  • Business: 1416,38 kg di CO2e
  • Prima classe: 1770,48 kg di CO2e

Questo volo ha un impatto moderato sulle scie di condensazione previste.

Utente: quali sono le emissioni tipiche da Zurigo a Boston?

Agente: le emissioni di anidride carbonica tipiche per passeggero per un volo da Zurigo (ZRH) a Boston (BOS) sono le seguenti:

  • Spedizione economica: 415,41 kg di CO2e
  • Premium Economy: 582,00 kg di CO2e
  • Business: 1473,95 kg di CO2e
  • Prima classe: 1817,35 kg di CO2e