Google Flights MCP Server

ホスト型 Model Context Protocol (MCP) サーバーです。Claude、Cursor、Windsurf、その他のあらゆる MCP クライアントに、Google Flights のツールを 1 つ提供します。片道、往復、複数都市の旅程を、運賃、フライト区間、二酸化炭素排出量、価格履歴とともに構造化 JSON として検索できます。Google アカウントは不要で、廃止された旅行 API を回避する必要もありません。

https://mcp.hasdata.com/api/mcp?apis=google_travel_flights

Contents

• 必要なもの

• クイックスタート

• プロンプト例

• ツール

• エラーと失敗の経路

• 料金、無料枠、制限

• ツールの選択

• 他製品との比較

• FAQ

• HasData リンク

• 開発

• 貢献

• ライセンス

Related MCP server: SkyOdyssey MCP

必要なもの

MCP クライアントと、ダッシュボード から取得した HasData API キーが必要です。作成は無料でカードも不要、トライアルでは 15 クレジット換算で約 66 回の呼び出しをカバーします。これはリモートサーバーなので、最も簡単な方法は URL と x-api-key ヘッダーを使うことで、実行するコンテナも、フロー内のどこにも Google アカウントも不要です。stdio のみ対応のクライアントは、npm の @hasdata/google-flights-mcp および PyPI の hasdata-google-flights-mcp として公開されているシンランチャー経由で接続します。以下に示します。

クイックスタート

サーバー URL はどのクライアントでも同じです。当チームは Clade Code と Clade Desktop で実際に運用しています。他のブロックは、各クライアントが公式にドキュメント化しているリモートサーバー向けの形式に従っています。

OAuth に対応したクライアントでは、同じ URL をコネクタとして追加し、設定ファイルにキーを書かずにサインインできます。

claude mcp add --transport http google-flights "https://mcp.hasdata.com/api/mcp?apis=google_travel_flights" \
  --header "x-api-key: HASDATA_API_KEY"

「設定」→「コネクタ」→「カスタムコネクタを追加」の順に進み、https://mcp.hasdata.com/api/mcp?apis=google_travel_flights を貼り付けてサインインします。

設定ファイルを使う場合は、Clade Desktop はローカル (stdio) サーバーのみを読み込むため、リモートサーバーには stdio ランチャーを介して到達します。@hasdata/google-flights-mcp パッケージがそのランチャーで、環境（環境変数）からキーを読み取ります。これを claude_desktop_config.json に追記します:

{
  "mcpServers": {
    "google-flights": {
      "command": "npx",
      "args": ["-y", "@hasdata/google-flights-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

Node の代わりに Python を使う場合は、ランチャーを PyPI パッケージに置き換えます。uvx なら手動インストールなしで実行できます:

{
  "mcpServers": {
    "google-flights": {
      "command": "uvx",
      "args": ["hasdata-google-flights-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

全プロジェクトでは ~/.cursor/mcp.json、単一プロジェクトでは .cursor/mcp.json を使います:

{
  "mcpServers": {
    "google-flights": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=google_travel_flights",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

~/.codeium/windsurf/mcp_config.json を使用します。Windsurf はフィールド名として url ではなく serverUrl を使います:

{
  "mcpServers": {
    "google-flights": {
      "serverUrl": "https://mcp.hasdata.com/api/mcp?apis=google_travel_flights",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

ワークスぺース内の .vscode/mcp.json に記します:

{
  "servers": {
    "google-flights": {
      "type": "http",
      "url": "https://mcp.hasdata.com/api/mcp?apis=google_travel_flights",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

プロンプト例

コードではなくプロンプトです。いずれかを貼り付ければ、エージェントが自動でツールを選択します。成功した呼び出しはすべて 15 クレジットを消費するため、各プロンプトには必要な呼び出し回数を注記しています。

9月15日に JFK からロンドン・ヒースローへ向かう片道便を、価格順で検索し、航空会社と二酸化炭素排出量の目安を含めて最安い3つを教えて。

1回の呼び出し、15クレジット。運賃、区間、排出量がすべ一度に返ってきます。

同じルートで、直行便のみ、ビジネスクラスで、どの選択肢が最少ない排出量か教えて。

1回の呼び出し、15クレジット。座席クラスと経由回数は、1つのリクエスト内のフィルターです。

今、JFK から LHR への運賃として $295 は、価格履歴を踏まえると良い価格ですか？

1回の呼び出し、15クレジット。レスポンスには priceInsights が含まれ、典型レンジと価格レベルが示されます。

JFK から LHR への往復、9月15日出発・9月22日帰り、最安運賃。

2回の呼び出し、30クレジット。Google はまず往路の選択肢を返し、その次に、選択した選択肢に紐づく復路を取得するのが2回目の呼び出しです。

往復は設計上2回の呼び出しです。1回目は、それぞれに departureToken が付いた往路の旅程を返します。そのトークンを渡すと、対応する復路便を取得できます。片道と価格チェックはそれぞれ1回の呼び出しで済みます。

ツール

ツールは1つだけで、読取り出し専用です。下のサンプルは実際の呼び出しから簡略したもので、運賃は常に変動します。形として捉えてくださし。ツール名は、完全なパラメータ一覧を載せたエンドポイント参照にリンクしています。

サンプルはペイロードであり、レスポンス全体ではありません。tools/call の結果には1つのテキストブロックが含まれ、そのテキスト自体が url、status、text、json を持つ JSON で、スクレイピングされたデータは json の下にあります。生の JSON-RPC レスポンスでは、パスは result.content[0].text をパースしてから .json です。チャットクライアントはこれを自動的に展開してくれますが、エンドポイントに直接通信するコードではそうではありません。

Google Flights の結果を取得

hasdata_google_travel_flights_getGoogleFlights

ルートと日付に対する旅程を、運賃、区間、排出量、価格履歴とともに返します。

リファレンスには includeConnections、excludeConnections、layoverDuration、outboundTimes、returnTimes、showHidden、lessEmissions、multiCityJson も記載されています。

結果は bestFlights と otherFlights に分かれます。各旅程には price、type、分単位の totalDuration、区間の配列 flights、carbonEmissions オブジェクト、bookingToken が含まれます。各区間には、departureAirport と arrivalAirport（それぞれ id、name、現地の time を持つ）、duration、airline、flightNumber、airplane、legroom、travelClass、extensions 配列、そして Google がフラグする区間の oftenDelayedByOver30Min が含まれます。直行便の旅程は区間1つ、乗継ぎ便は複数の区間になります。

carbonEmissions の単位はグラムであり、キログラムではありません。thisFlight: 433000 は 433 kg です。differencePercent はこれを typicalForThisRoute と比較するため、負の数値は平均より環境に優しい便を意味します。

{
  "price": 295,
  "type": "One way",
  "totalDuration": 415,
  "flights": [
    {
      "departureAirport": { "id": "JFK", "name": "John F. Kennedy International Airport", "time": "2026-09-15 8:15" },
      "arrivalAirport": { "id": "LHR", "name": "Heathrow Airport", "time": "2026-09-15 20:10" },
      "duration": 415,
      "airline": "Virgin Atlantic",
      "flightNumber": "VS 26",
      "airplane": "Boeing 787",
      "travelClass": "Economy"
    }
  ],
  "carbonEmissions": { "thisFlight": 367000, "typicalForThisRoute": 419000, "differencePercent": -12 },
  "bookingToken": "W1t7..."
}

priceInsights は旅程と並んで配置され、lowestPrice、typicalPriceRange、typical などの priceLevel、そして [timestamp, price] の点からなる priceHistory を含みます。airports は、解決された出発・到着空港を都市と国とともに返します。

エラーと失敗の経路

クライアントがツール呼び出しから HTTP エラーコーを見ることはほぼありません。MCP レイヤは 200 を返し、失敗を結果の内部に置きます。isError は true に設定され、理由はテキストとして含まれます。エージェントは、ステータス行を期待する場面で、メッセージを読み取ります。

誤ったキーは、接続失敗ではなくツール出力として表面化します。 tools/list は空でないキーを受け入れてツールを返すため、クライアントはハンドシェークを完了して緑表示になります。その後の最初のツール呼び出しが、isError: true とテキスト HasData API error: 401 Unauthorized を返します。それ以前のフローでは問題を報告するものが何もないため、その文字列に注意してくださし。

キーが欠如している場合は、唯一の実際の HTTP エラーになります。 認証はどのツールよりも前に実行され、接続自体が 401 で失敗します。CORS ヘッダーは存在するため、ブラウザのクライアントは不透明なネットワーク障害ではなくステータスを読み取ります。

ツールのスキーマを壊す引数は、スクレイピングになる前に拒否されます。 サーバーは isError: true とテキスト MCP error -32602: Input validation error で応答し、問題のフィールド名を挙げます。returnDate なしの roundTrip、および includeAirlines と excludeAirlines の同時指定は、ここで検出されます。

その日付に便がないルートは、エラーではなく、旅程配列が空の成功結果を返します。 requestMetadata.status は依然として ok です。順位付け前に便があるか確認してくださし。

不正な空港コードは400を返します。requestMetadata.status は error に設定されます。都市名ではなく、IATAコードまたはkgmidsを使用してください。

データを返す結果には、サポートで引用する価値のある requestMetadata.id も含まれます。

料金、無料枠、制限

Google Flightsへの各呼び出しは、成功した呼び出しごとに15クレジットかかります。レスポンスのサイズによって価格は変わりません。ディープ検索も標準検索と同じコストです。

無料トライアルはカード不要で30日間1,000クレジットで、約66回のフライト検索に相当します。その後も、アクティブなアカウントは残高が100を下回るたびに毎日100クレジットが補充されます。そのため、利用量の少ないエージェントは無料枠で無期限に実行できます。

有料プランは 月額49ドル で20万クレジット、約13,000回の検索に相当します。単価はボリュームに応じて下がり、エントリープランでは 1,000回の呼び出しにつき3.68ドル、Businessでは 1.49ドル、Growthでは 1.25ドル、最大規模の 高ボリュームプラン では 1.12ドル です。

プランによって同時実行数も決まります。無料トライアルは同時1リクエスト、Startupは15、Businessは30、Growthは50、高ボリュームプランは200〜1,500です。無人で動作させるものには、オーバーフローに備えた防御的な処理を入れてください。

200以外のステータスが返ったリクエストは課金されません。往復は2回の呼び出しになるため、予算に組んでください。

ツールの選択

apis クエリパラメータによって、エージェントが参照できるツールが決まります。ツールが少なければツール定義に費やすコンテキストが減り、モデルが誤ったツールを選ぶ可能性も減ります。

?apis=google_travel_flights          the one tool in this repo
?apis=google_travel                   add Google Hotels
?apis=google_travel_flights,airbnb    flights plus Airbnb stays

このパラメータには、google_travel のようなプロバイダ名や、google_travel_flights のような個別のAPI名を指定します。スペルミスのある名前は無視されます。すべての名前が間違っていた場合はリクエストが400で失敗し、ボディには認識できなかった名前と有効な値の一覧が両方記載されます。パラメータを省略すると、同じエンドポイントでHasDataの57ツールすべてが公開されます。

比較

Googleは2018年にQPX ExpressフライトAPIを廃止し、後継を提供していません。そのため、公式のGoogle Flights APIは存在しません。残された選択肢は、公開結果をスクレイピングするか、生のGDS運賃データをライセンスすることですが、これは重く費用もかかります。このサーバーは、サイトが表示する同じ結果を読み取り、JSONとして返します。

このサーバーが行わないこと。 予約も支払いもありません。運賃・区間・Google自身が予約へ進むために使うトークンを読み取り、予約ステップはあなたに委ねます。

FAQ

公式のGoogle Flights APIはありますか？

いいえ、ありません。Googleは2018年にQPX Expressを終了し、後継をリリースしていません。どの選択肢も、ウェブサイトが提供する同じ公開結果を読み取ります。このサーバーはHasDataがメンテナンスし、それらを構造化されたJSONとして返します。

Google Flights MCPサーバーとは何ですか？

AIクライアントが呼び出せるツールとしてGoogle Flightsを公開するサーバーです。クライアントはModel Context Protocolを介してツール呼び出しを送り、サーバーは旅程を取得して構造化JSONを返し、モデルが結果を扱います。このサーバーは単一のツールを公開し、リモートで実行されます。

往復が2回の呼び出しなのはなぜですか？

Googleはまず行きのオプションを返します。それぞれに departureToken が付いています。1つを選んでそのトークンを送り返すと、それに対応する帰りのフライトを取得できます。これはサイトの動作を反映したもので、往復が30クレジットかかる理由です。

炭素排出量の数値はキログラム単位ですか？

いいえ、グラムです。thisFlight: 433000 は433 kgを意味し、differencePercent はそれをルート平均と比較します。

ディープ検索とは何ですか？

ブラウザにGoogle Flightsが表示するものと完全に同じ結果を返す、速度の遅いモードです。速度を優先するならオフにし、サイトとの完全一致が必要なときはオンにします。

他のHasData APIと一緒に使えますか？

はい。apis パラメータはリストを受け付けます。?apis=google_travel を指定すると、フライトに加えてGoogle Hotelsも追加されます。パラメータを省略する と、すべてを取得できます。

コンプライアンスと個人データ

HasDataは公開されているデータのみにアクセスします。プラットフォームの利用規約が自動アクセスを制限する場合があり、自らのコンプライアンスについては利用者側に責任があります。

HasData リンク

開発

このリポジトリは、リモートサーバーの設定とドキュメントです。ビルドステップもコンテナ化するものもありません。

test/ 内のテストは、ツール契約を検証します。これは、ここにコミットがなくても壊れ得る部分です。?apis=google_travel_flights が正しく1つのツールを返すこと、必須パラメータをまだ宣言していること、名前が変わっていないこと、使用中のキーが実際に受理されることを確認します。最後のチェックはツールを実際に呼び出し、15クレジットかかります。これは、正しい理由で失敗できるカナリーの代価です。

# macOS and Linux
HASDATA_API_KEY=your_key_here npm test

# Windows PowerShell
$env:HASDATA_API_KEY="your_key_here"; npm test

同じスイートは、プッシュのたびにCIで、また週に1回スケジュールで実行されます。上流のツールリストは、誰かがこのリポジトリを触ることなく変わり得るためです。失敗は、ツールリストが変動した、キーが動かなくなった、またはエンドポイントに到達できなかったことを意味し、アサーション・メッセージにその原因が示されます。

コントリビューション

最も有益な貢献は、パラメータ表とレスポンス例の訂正です。これらは乖離しやすい部分だからです。実行した呼び出しと得られたレスポンスを添付してください。フォークからのプルリクエストはキーなしでスイートを実行し、ライブチェックは赤にならずにスキップされます。

ライセンス

MIT。LICENSE を参照してください。