Model Context Protocol (MCP) 整合

旅遊影響模型 (TIM) API 支援 Model Context Protocol (MCP),這項開放標準專為 AI 代理和大型語言模型 (LLM) 設計,可與 API 和工具互動。使用 MCP 端點後,AI 代理程式就能動態探索及使用 TIM API 的功能,計算航班的碳排放量。

如要進一步瞭解通訊協定,請參閱「Model Context Protocol 規格」。

端點

旅遊影響模型 API 的 MCP 端點為:

https://travelimpactmodel.googleapis.com/mcp

所有 MCP 互動都是透過將 JSON-RPC 2.0 POST 要求傳送至這個端點來進行。

驗證

MCP 端點使用的驗證方法與標準 Travel Impact Model API 相同。您必須提供 Google Cloud 專案的有效 API 金鑰,並確保已啟用「旅遊影響模型 API」。

核心 MCP 方法

與 MCP 端點互動時,主要會使用兩種方法:

  • tools/list:探索可用工具、工具說明,以及輸入/輸出 JSON 結構定義。
  • tools/call:使用指定引數執行特定工具。

可用工具

下列功能會以工具形式公開:

  • compute_flight_emissions:擷取特定近期航班的詳細排放量。
  • compute_typical_flight_emissions:擷取機場組合之間的典型排放量,不必提供特定航班詳細資料。
  • compute_scope3_flight_emissions:擷取歷來航班的排放量,適用於範圍 3 報表。

輸入和輸出的確切結構定義會顯示在tools/list回應中。

與 AI 代理整合

按照這些操作說明設定熱門 AI 應用程式。將 YOUR_API_KEY 替換成您的旅遊影響模型 API 金鑰。

Gemini CLI

如要設定 Gemini CLI,請按照下列步驟操作:

  1. ~/.gemini/extensions/travel-impact-model/gemini-extension.json 建立擴充功能檔案。
  2. 將下列內容儲存到檔案中:

    {
      "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. 在終端機中執行 gemini,啟動 Gemini CLI。

  4. 執行 /mcp list,確認 travel-impact-model 伺服器已設定完成,且工具可用。

Antigravity

如要設定 Antigravity 使用 MCP 伺服器,請按照下列步驟操作:

  1. 在 Antigravity 中,依序按一下「Agent」窗格中的「Additional options」 選單 >「MCP Servers」 >「Manage MCP Servers」
  2. 在開啟的「管理 MCP 伺服器」窗格頂端,按一下「查看原始設定」,即可編輯 mcp_config.json 檔案:

    {
      "mcpServers": {
        "TravelImpactModel": {
          "serverUrl": "https://travelimpactmodel.googleapis.com/mcp",
          "headers": {
            "X-Goog-Api-Key": "YOUR_API_KEY"
          }
        }
      }
    }
    
  3. 返回「管理 MCP 伺服器」,然後按一下「重新整理」

互動範例

設定完成後,您就能透過 AI 代理,以自然語言與 TIM API 互動。

使用者:從蘇黎世飛往波士頓的 LX 52 航班碳排放量是多少?

服務專員:以下是 2026 年 3 月 25 日從蘇黎世 (ZRH) 飛往波士頓 (BOS) 的瑞士國際航空 LX 52 航班,每位乘客的預估碳排放量:

  • 經濟型配送:354.10 公斤 CO2e
  • 豪華經濟艙:531.14 公斤 CO2e
  • 商家:1,416.38 公斤 CO2e
  • 第一:1,770.48 公斤 CO2e

這趟航班預計會產生中等程度的飛機雲影響。

使用者:從蘇黎世到波士頓的碳排放量一般是多少?

服務專員:從蘇黎世 (ZRH) 飛往波士頓 (BOS) 的航班,每位乘客的碳排放量通常如下:

  • 經濟型配送服務:415.41 公斤 CO2e
  • 豪華經濟艙:582.00 公斤 CO2e
  • 商務:1,473.95 公斤 CO2e
  • 第一:1,817.35 公斤二氧化碳當量