Integration von Model Context Protocol (MCP)

Die Travel Impact Model (TIM) API unterstützt das Model Context Protocol (MCP), einen offenen Standard für die Interaktion von KI-Agenten und Large Language Models (LLMs) mit APIs und Tools. Über den MCP-Endpunkt können KI-Agenten die Funktionen der TIM API dynamisch ermitteln und verwenden, um Flugemissionen zu berechnen.

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

Endpunkt

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

https://travelimpactmodel.googleapis.com/mcp

Alle MCP-Interaktionen werden durch Senden von JSON-RPC 2.0-POST-Anfragen an diesen Endpunkt ausgeführt.

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-Schemas für Ein- und Ausgabe.
  • tools/call: Führt ein bestimmtes Tool mit den angegebenen Argumenten aus.

Verfügbare Tools

Die folgenden Funktionen werden als Tools bereitgestellt:

  • compute_flight_emissions: Ruft detaillierte Emissionsdaten für bestimmte bevorstehende Flüge ab.
  • compute_typical_flight_emissions: Ruft typische 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 Berichterstattung zu Scope 3 geeignet sind.

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

In KI-Agenten einbinden

Folgen Sie dieser Anleitung, um beliebte KI-Anwendungen zu konfigurieren. Ersetzen Sie YOUR_API_KEY durch Ihren API-Schlüssel für die Travel Impact Model API.

Gemini CLI

So konfigurieren Sie 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“ auf Rohkonfiguration ansehen, um die Datei mcp_config.json 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 mit der TIM API über Ihren KI-Agenten in natürlicher Sprache interagieren.

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

Agent:Die prognostizierten Kohlenstoffemissionen pro Passagier für den Flug LX 52 der Swiss International Air Lines 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 Klasse:1.770,48 kg CO2e

Dieser Flug hat einen moderaten prognostizierten Einfluss auf die Kondensstreifen.

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

Agent:Die typischen Kohlenstoffemissionen pro Passagier für einen Flug von Zürich (ZRH) nach Boston (BOS) sind wie folgt:

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