Travel Impact Model (TIM) API 支持模型上下文协议 (MCP),这是一种开放标准,旨在让 AI 智能体和大语言模型 (LLM) 与 API 和工具进行交互。通过使用 MCP 端点,AI 智能体可以动态发现和使用 TIM API 的功能来计算航班排放量。
如需详细了解该协议,请参阅模型上下文协议规范。
端点
Travel Impact Model API 的 MCP 端点为:
https://travelimpactmodel.googleapis.com/mcp
所有 MCP 交互都是通过向此端点发送 JSON-RPC 2.0 POST 请求来执行的。
身份验证
MCP 端点使用与标准 Travel Impact Model API 相同的身份验证方法。您必须提供 Google Cloud 项目中的有效 API 密钥,并确保“旅行碳排放影响评估模型 (TIM) 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 替换为您的 Travel Impact Model 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 中,依次点击“智能体”窗格中的其他选项 菜单 > MCP 服务器 > 管理 MCP 服务器。
在打开的“管理 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 航班的排放量是多少?
智能体: 瑞士国际航空公司从苏黎世 (ZRH) 到波士顿 (BOS) 的 LX 52 航班在 2026 年 3 月 25 日(今天)的预计每位乘客碳排放量如下:
- 经济舱: 354.10 千克二氧化碳当量
- 豪华经济舱: 531.14 千克二氧化碳当量
- 商务舱: 1,416.38 千克二氧化碳当量
- 头等舱: 1,770.48 千克二氧化碳当量
此航班的预计航迹云影响适中。
用户: 从苏黎世到波士顿的典型排放量是多少?
智能体: 从苏黎世 (ZRH) 到波士顿 (BOS) 的航班的典型每位乘客碳排放量如下:
- 经济舱: 415.41 千克二氧化碳当量
- 豪华经济舱: 582.00 千克二氧化碳当量
- 商务舱: 1,473.95 千克二氧化碳当量
- 头等舱: 1,817.35 千克二氧化碳当量