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 dinamicamente le funzionalità dell'API TIM per calcolare le emissioni dei voli.

Per saperne di più 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 standard Travel Impact Model. 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 forniti.

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 i report sull'ambito 3.

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

Integrare con gli agenti AI

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

Gemini CLI

Per configurare la CLI Gemini, 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 Opzioni aggiuntive 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.

Interazioni di esempio

Una volta configurata, puoi interagire con l'API TIM tramite il tuo 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 Swiss International Air Lines LX 52 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 CO2e
  • Business:1416,38 kg CO2e
  • Primo: 1770,48 kg di CO2e

Questo volo ha un impatto moderato previsto delle scie di condensazione.

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

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

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