旅遊影響模型 (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,請按照下列步驟操作:
- 在
~/.gemini/extensions/travel-impact-model/gemini-extension.json建立擴充功能檔案。 將下列內容儲存到檔案中:
{ "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" } } } }在終端機中執行
gemini,啟動 Gemini CLI。執行
/mcp list,確認travel-impact-model伺服器已設定完成,且工具可用。
Antigravity
如要設定 Antigravity 使用 MCP 伺服器,請按照下列步驟操作:
- 在 Antigravity 中,依序按一下「Agent」窗格中的「Additional options」 選單 >「MCP Servers」 >「Manage MCP Servers」。
在開啟的「管理 MCP 伺服器」窗格頂端,按一下「查看原始設定」,即可編輯
mcp_config.json檔案:{ "mcpServers": { "TravelImpactModel": { "serverUrl": "https://travelimpactmodel.googleapis.com/mcp", "headers": { "X-Goog-Api-Key": "YOUR_API_KEY" } } } }返回「管理 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 公斤二氧化碳當量