Integration von Model Context Protocol (MCP)

Die Travel Impact Model (TIM) API unterstützt das Model Context Protocol (MCP), einen offenen Standard, der für die Interaktion von KI-Agenten und Large Language Models (LLMs) mit APIs und Tools entwickelt wurde. Durch die Verwendung des MCP-Endpunkts können KI-Agents die Funktionen der TIM API dynamisch erkennen und verwenden, um Flugemissionen zu berechnen.

Weitere Informationen zum Protokoll finden Sie in der Model Context Protocol Specification.

Endpunkt

Der MCP-Endpunkt für die Travel Impact Model API lautet:

https://travelimpactmodel.googleapis.com/mcp

Alle MCP-Interaktionen erfolgen durch Senden von JSON-RPC 2.0-POST-Anfragen an diesen Endpunkt.

Authentifizierung

Für den MCP-Endpunkt werden dieselben Authentifizierungsmethoden wie für die Standard-Travel Impact Model API verwendet. Sie müssen einen gültigen API-Schlüssel aus Ihrem Google Cloud-Projekt angeben und darauf achten, dass die „Travel Impact Model API“ aktiviert ist.

Wichtige MCP-Methoden

Bei Interaktionen mit dem MCP-Endpunkt werden hauptsächlich zwei Methoden verwendet:

  • tools/list: Ermittelt die verfügbaren Tools, ihre Beschreibungen und ihre JSON-Ein-/Ausgabeschemas.
  • tools/call: Führt ein bestimmtes Tool mit den angegebenen Argumenten aus.

Verfügbare Tools

Die folgenden Funktionen sind als Tools verfügbar:

  • compute_detailed_flight_emissions: Ruft detaillierte Emissionsdaten ab und bietet eine umfassende Datenzuordnung für bestimmte bevorstehende Flüge.
  • compute_flight_emissions: Ruft detaillierte Emissionsdaten für bestimmte bevorstehende Flüge ab.
  • compute_typical_flight_emissions: Ruft die typischen Emissionen zwischen Flughafenpaaren ab, ohne dass bestimmte Flugdetails erforderlich sind.
  • compute_scope3_flight_emissions: Ruft Emissionen für frühere Flüge ab, die für die Berichterstellung zu Scope 3 geeignet sind.

Die genauen Schemas für Ein- und Ausgaben sind in der tools/list-Antwort enthalten.

Mit KI-Agents integrieren

Konfigurieren Sie beliebte KI-Anwendungen anhand dieser Anleitung. Ersetzen Sie YOUR_API_KEY durch Ihren API-Schlüssel für das Travel Impact Model.

Gemini CLI

So konfigurieren Sie die Gemini CLI:

  1. Erstellen Sie eine Erweiterungsdatei unter ~/.gemini/extensions/travel-impact-model/gemini-extension.json.

  2. Speichern Sie den folgenden Inhalt in der Datei:

    {
  "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. Starten Sie die Gemini CLI, indem Sie gemini in Ihrem Terminal ausführen.

  4. Führen Sie /mcp list aus, um zu prüfen, ob der travel-impact-model-Server konfiguriert ist und seine Tools verfügbar sind.

Antigravity

So konfigurieren Sie Antigravity für die Verwendung des MCP-Servers:

  1. Klicken Sie in Antigravity im Bereich „Agent“ auf das Menü Zusätzliche Optionen > MCP-Server > MCP-Server verwalten.

  2. Klicken Sie oben im Bereich „MCP-Server verwalten“, der geöffnet wird, auf Rohkonfiguration ansehen, um die mcp_config.json-Datei zu bearbeiten:

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

  3. Kehren Sie zu MCP-Server verwalten zurück und klicken Sie auf Aktualisieren.

Beispielinteraktionen

Nach der Konfiguration können Sie über Ihren KI-Agenten in natürlicher Sprache mit der TIM API interagieren.

Nutzer:Wie hoch sind die Emissionen für Flug LX 52 von Zürich nach Boston?

Kundenservicemitarbeiter:Die geschätzten CO2-Emissionen pro Passagier für den Swiss International Air Lines-Flug LX 52 von Zürich (ZRH) nach Boston (BOS) für heute, den 25. März 2026, sind wie folgt:

  • Economy:354,10 kg CO2e
  • Premium Economy:531,14 kg CO2e
  • Business:1.416,38 kg CO2e
  • Erste:1.770,48 kg CO2e

Dieser Flug hat voraussichtlich einen moderaten Einfluss durch Kondensstreifen.

Nutzer:Wie hoch sind die typischen Emissionen auf der Strecke von Zürich nach Boston?

Kundenservicemitarbeiter:Die typischen CO₂-Emissionen pro Passagier für einen Flug von Zürich (ZRH) nach Boston (BOS) sind:

  • Economy:415,41 kg CO2e
  • Premium Economy:582,00 kg CO2e
  • Business:1.473,95 kg CO2e
  • Erste:1.817,35 kg CO2e