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 IA et aux grands modèles de langage (LLM) d'interagir avec des API et des outils. En utilisant le point de terminaison MCP, les agents IA peuvent découvrir et utiliser de manière dynamique les fonctionnalités de l'API TIM pour calculer les émissions des vols.

Pour en savoir plus sur le protocole, consultez la spécification du protocole MCP.

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 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 à partir de 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/de sortie.
  • tools/call : exécute un outil spécifique avec les arguments donnés.

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 spécifiques à venir.
  • compute_typical_flight_emissions : récupère les émissions types 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 passés, adaptées aux rapports sur le champ d'application 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 dans ~/.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 Additional options (Options supplémentaires) dans le volet "Agent" > MCP Servers (Serveurs MCP) > Manage MCP Servers (Gérer les serveurs MCP).

  2. En haut du volet "Manage MCP Servers" (Gérer les serveurs MCP) qui s'ouvre, cliquez sur View raw config (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 à Manage MCP servers (Gérer les serveurs MCP), puis cliquez sur Refresh (Actualiser).

Exemples d'interactions

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

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

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

  • Économique : 354,10 kg CO2e
  • Classe économique premium : 531,14 kg CO2e
  • Affaires : 1 416,38 kg CO2e
  • Première : 1 770,48 kg CO2e

Ce vol a un impact modéré sur les traînées de condensation.

Utilisateur : Quelles sont les émissions types de Zurich à Boston ?

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

  • Économique : 415,41 kg CO2e
  • Classe économique premium : 582,00 kg CO2e
  • Affaires : 1 473,95 kg CO2e
  • Première : 1 817,35 kg CO2e