Model Context Protocol（MCP）の統合

Travel Impact Model（TIM）API は、AI エージェントと大規模言語モデル（LLM）が API やツールとやり取りするために設計されたオープン標準である Model Context Protocol（MCP）をサポートしています。MCP エンドポイントを使用すると、AI エージェントは TIM API の機能を動的に検出して使用し、フライトの排出量を計算できます。

プロトコルの詳細については、Model Context Protocol の仕様をご覧ください。

エンドポイント

Travel Impact Model API の MCP エンドポイントは次のとおりです。

https://travelimpactmodel.googleapis.com/mcp

すべての MCP インタラクションは、このエンドポイントに JSON-RPC 2.0 POST リクエストを送信することで行われます。

認証

MCP エンドポイントは、標準の Travel Impact Model API と同じ認証方法を使用します。Google Cloud プロジェクトから有効な API キーを指定する必要があります。このとき、「Travel Impact Model API」が有効になっていることを確認してください。

コア MCP メソッド

MCP エンドポイントとのインタラクションでは、主に次の 2 つのメソッドを使用します。

  • 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 の排出量はどれくらいですか？

エージェント: 2026 年 3 月 25 日のチューリッヒ（ZRH）発ボストン（BOS）行きのスイス インターナショナル エアラインズ フライト LX 52 の乗客 1 人あたりの推定炭素排出量は次のとおりです。

  • エコノミー: 354.10 kg CO2e
  • プレミアム エコノミー: 531.14 kg CO2e
  • ビジネス: 1,416.38 kg CO2e
  • ファースト: 1,770.48 kg CO2e

このフライトの推定飛行機雲の影響は中程度です。

ユーザー: チューリッヒからボストンまでの一般的な排出量はどれくらいですか？

エージェント: チューリッヒ（ZRH）発ボストン（BOS）行きのフライトの乗客 1 人あたりの一般的な炭素排出量は次のとおりです。

  • エコノミー: 415.41 kg CO2e
  • プレミアム エコノミー: 582.00 kg CO2e
  • ビジネス: 1,473.95 kg CO2e
  • ファースト: 1,817.35 kg CO2e