Intégration du protocole MCP (Model Context Protocol)

L'API Travel Impact Model (TIM) est compatible avec le protocole MCP (Model Context Protocol), une norme ouverte conçue pour permettre aux agents d'IA et aux grands modèles de langage (LLM) d'interagir avec les API et les outils. En utilisant le point de terminaison MCP, les agents d'IA peuvent découvrir et utiliser de manière dynamique les capacités de l'API TIM pour calculer les émissions des vols.

Pour en savoir plus sur le protocole, consultez la spécification du protocole de contexte du modèle.

Point de terminaison

Le point de terminaison MCP de l'API Travel Impact Model est le suivant :

https://travelimpactmodel.googleapis.com/mcp

Toutes les interactions avec le MCP sont effectuées en envoyant des requêtes POST JSON-RPC 2.0 à ce point de terminaison.

Authentification

Le point de terminaison MCP utilise les mêmes méthodes d'authentification que l'API Travel Impact Model standard. Vous devez fournir une clé API valide depuis votre projet Google Cloud, en vous assurant que l'API Travel Impact Model est activée.

Méthodes MCP de base

Les interactions avec le point de terminaison MCP utilisent principalement deux méthodes :

  • tools/list : découvre les outils disponibles, leurs descriptions et leurs schémas JSON d'entrée/sortie.
  • tools/call : exécute un outil spécifique avec les arguments fournis.

Outils disponibles

Les fonctionnalités suivantes sont exposées en tant qu'outils :

  • compute_flight_emissions : récupère les émissions détaillées pour des vols à venir spécifiques.
  • compute_typical_flight_emissions : récupère les émissions typiques entre des paires d'aéroports, sans nécessiter de détails spécifiques sur les vols.
  • compute_scope3_flight_emissions : récupère les émissions des vols historiques, ce qui convient aux rapports sur le scope 3.

Les schémas exacts pour les entrées et les sorties sont fournis dans la réponse tools/list.

Intégrer des agents IA

Configurez les applications d'IA populaires en suivant ces instructions. Remplacez YOUR_API_KEY par votre clé API Travel Impact Model.

Gemini CLI

Pour configurer Gemini CLI, procédez comme suit :

  1. Créez un fichier d'extension à l'adresse ~/.gemini/extensions/travel-impact-model/gemini-extension.json.

  2. Enregistrez le contenu suivant dans le fichier :

    {
  "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. Lancez Gemini CLI en exécutant gemini dans votre terminal.

  4. Exécutez /mcp list pour vérifier que le serveur travel-impact-model est configuré et que ses outils sont disponibles.

Antigravity

Pour configurer Antigravity afin qu'il utilise le serveur MCP :

  1. Dans Antigravity, cliquez sur le menu Options supplémentaires dans le volet "Agent" > Serveurs MCP > Gérer les serveurs MCP.

  2. En haut du volet "Gérer les serveurs MCP" qui s'ouvre, cliquez sur Afficher la configuration brute pour modifier le fichier mcp_config.json :

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

  3. Revenez à Gérer les serveurs MCP, puis cliquez sur Actualiser.

Exemples d'interactions

Une fois configurée, vous pouvez interagir avec l'API TIM via votre agent d'IA en langage naturel.

Utilisateur : Quelles sont les émissions du vol LX 52 de Zurich à Boston ?

Agent : Voici les émissions de carbone prévues par passager pour le vol Swiss International Air Lines LX 52 de Zurich (ZRH) à Boston (BOS) pour aujourd'hui, le 25 mars 2026 :

  • Économie : 354,10 kg CO2e
  • Classe économique premium : 531,14 kg CO2e
  • Business : 1 416,38 kg de CO2e
  • Premier : 1 770,48 kg de CO₂e

L'impact des traînées de condensation de ce vol est modéré.

Utilisateur : Quelles sont les émissions habituelles pour un vol de Zurich à Boston ?

Agent : Les émissions de carbone habituelles par passager pour un vol de Zurich (ZRH) à Boston (BOS) sont les suivantes :

  • Économie : 415,41 kg CO2e
  • Classe économique premium : 582 kg CO2e
  • Business : 1 473,95 kg de CO2e
  • Premier : 1 817,35 kg de CO2e