Integracja z protokołem Model Context Protocol (MCP)

Interfejs API modelu wpływu podróży (TIM) obsługuje protokół Model Context Protocol (MCP), czyli otwarty standard zaprojektowany z myślą o agentach AI i dużych modelach językowych (LLM), aby umożliwić im interakcję z interfejsami API i narzędziami. Korzystając z punktu końcowego MCP, agenci AI mogą dynamicznie wykrywać i używać funkcji interfejsu TIM API do obliczania emisji z lotów.

Więcej informacji o protokole znajdziesz w specyfikacji protokołu Model Context Protocol.

Punkt końcowy

Punkt końcowy MCP dla interfejsu Travel Impact Model API to:

https://travelimpactmodel.googleapis.com/mcp

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

Uwierzytelnianie

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

Podstawowe metody MCP

Interakcje z punktem końcowym MCP wykorzystują głównie 2 metody:

  • 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

Następujące funkcje są udostępniane jako narzędzia:

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

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

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 następujące 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 polecenie /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ądzaj serwerami MCP kliknij Wyświetl konfigurację w postaci nieprzetworzonej, 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łady interakcji

Po skonfigurowaniu możesz wchodzić w interakcje z interfejsem TIM API za pomocą agenta AI w języku naturalnym.

Użytkownik: Jakie są emisje z lotu LX 52 z Zurychu do Bostonu?

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

  • Klasa ekonomiczna: 354,10 kg CO2e
  • Klasa ekonomiczna premium: 531,14 kg CO2e
  • Klasa biznes: 1416,38 kg CO2e
  • Klasa pierwsza: 1770,48 kg CO2e

Ten lot ma umiarkowany przewidywany wpływ smug kondensacyjnych.

Użytkownik: Jakie są typowe emisje z Zurychu do Bostonu?

Agent: Typowe emisje dwutlenku węgla na pasażera w przypadku lotu z Zurychu (ZRH) do Bostonu (BOS) są następujące:

  • Klasa ekonomiczna: 415,41 kg CO2e
  • Klasa ekonomiczna premium: 582,00 kg CO2e
  • Klasa biznes: 1473,95 kg CO2e
  • Klasa pierwsza: 1817,35 kg CO2e