Model Context Protocol (MCP) 集成

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, 请按以下步骤操作:

  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 中,依次点击“智能体”窗格中的其他选项 菜单 > MCP 服务器 > 管理 MCP 服务器
  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 航班的排放量是多少?

智能体: 瑞士国际航空公司从苏黎世 (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 千克二氧化碳当量