Integracja z protokołem Model Context Protocol (MCP)

Interfejs API modelu wpływu podróży (TIM) obsługuje protokół Model Context Protocol (MCP), otwarty standard przeznaczony dla agentów AI i dużych modeli językowych (LLM), który umożliwia interakcję z interfejsami API i narzędziami. Korzystając z punktu końcowego MCP, agenci AI mogą dynamicznie wykrywać i wykorzystywać możliwości interfejsu TIM API do obliczania emisji z lotów.

Więcej informacji o tym protokole znajdziesz w specyfikacji Model Context Protocol.

Punkt końcowy

Punkt końcowy MCP interfejsu API modelu wpływu podróży to:

https://travelimpactmodel.googleapis.com/mcp

Wszystkie interakcje z MCP są przeprowadzane przez wysyłanie żądań POST w formacie JSON-RPC 2.0 do tego punktu końcowego.

Uwierzytelnianie

Punkt końcowy MCP korzysta z tych samych metod uwierzytelniania co standardowy interfejs Travel Impact Model API. Musisz podać prawidłowy klucz interfejsu API z projektu w chmurze Google, upewniając się, że interfejs „model wpływu podróży API” jest włączony.

Podstawowe metody MCP

Interakcje z punktem końcowym MCP odbywają się głównie za pomocą 2 metod:

  • tools/list: wykrywa dostępne narzędzia, ich opisy oraz schematy wejściowe i wyjściowe JSON.
  • tools/call: wykonuje określone narzędzie z podanymi argumentami.

Dostępne narzędzia

Jako narzędzia udostępniane są te funkcje:

  • compute_flight_emissions: pobiera szczegółowe informacje o emisji w przypadku konkretnych nadchodzących lotów.
  • compute_typical_flight_emissions: pobiera typowe emisje między parami lotnisk bez konieczności podawania szczegółów lotu.
  • compute_scope3_flight_emissions: pobiera dane o emisjach w przypadku lotów historycznych, które można wykorzystać w raportowaniu emisji w zakresie 3.

Dokładne schematy danych wejściowych i wyjściowych są podane w tools/listodpowiedzi.

Integracja z agentami AI

Skonfiguruj popularne aplikacje AI, korzystając z tych instrukcji. Zastąp YOUR_API_KEY kluczem interfejsu API modelu wpływu podróży.

Interfejs wiersza poleceń Gemini

Aby skonfigurować interfejs wiersza poleceń Gemini, wykonaj te czynności:

  1. Utwórz plik rozszerzenia w lokalizacji ~/.gemini/extensions/travel-impact-model/gemini-extension.json.

  2. Zapisz w pliku tę zawartość:

    {
  "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. Uruchom interfejs wiersza poleceń Gemini, wpisując w terminalu gemini.

  4. Uruchom /mcp list, aby sprawdzić, czy serwer travel-impact-model jest skonfigurowany i czy jego narzędzia są dostępne.

Antigravity

Aby skonfigurować Antigravity do korzystania z serwera MCP:

  1. W Antigravity kliknij menu Dodatkowe opcje w panelu Agent > Serwery MCP > Zarządzaj serwerami MCP.

  2. U góry otwartego panelu Zarządzanie serwerami MCP kliknij Wyświetl surową konfigurację, aby edytować plik mcp_config.json:

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

  3. Wróć do sekcji Zarządzaj serwerami MCP i kliknij Odśwież.

Przykładowe interakcje

Po skonfigurowaniu możesz wchodzić w interakcję z interfejsem TIM API za pomocą agenta AI, używając języka naturalnego.

Użytkownik: Jaka jest emisja lotu LX 52 z Zurychu do Bostonu?

Agent: przewidywane emisje dwutlenku węgla na pasażera w przypadku lotu Swiss International Air Lines LX 52 z Zurychu (ZRH) do Bostonu (BOS) na dziś, 25 marca 2026 roku, są następujące:

  • Przesyłka ekonomiczna: 354,10 kg CO2e
  • Klasa ekonomiczna premium: 531,14 kg CO2e
  • Biznes: 1416,38 kg CO2e
  • Pierwsza: 1770,48 kg CO2e

Ten lot ma umiarkowany przewidywany wpływ smug kondensacyjnych.

Użytkownik: Jaka jest typowa emisja podczas lotu z Zurychu do Bostonu?

Agent: Typowa emisja dwutlenku węgla na pasażera w przypadku lotu z Zurychu (ZRH) do Bostonu (BOS) jest następująca:

  • Przesyłka ekonomiczna: 415,41 kg CO2e
  • Klasa ekonomiczna premium: 582,00 kg CO2e
  • Klasa biznes: 1473,95 kg CO2e
  • Pierwszy: 1817,35 kg CO2e