Google Flights

google-flights-mcp

Claude から Google Flights の価格とスケジュールを検索する MCP サーバーです。

1 つのインターフェース（google_flights_mcp/providers/base.py）の背後に、切り替え可能な 2 つのデータソースがあります。

• fast-flights（デフォルト）— Google Flights の内部 protobuf 検索 API を直接スクレイピングします。API キーは不要で、すぐに利用できます。
• SerpApi — SERPAPI_KEY 環境変数が設定されている場合、自動的に使用されます。便名、乗り継ぎの詳細、二酸化炭素排出量が追加されます。

ツール

• search_flights — origin（デフォルトは LIS）、destination、departure_date、省略可能な return_date、搭乗者数、cabin_class、currency（デフォルトは EUR）、max_stops、sort_by。価格順に並べた一覧を返します。価格、航空会社、出発・到着時刻、所要時間、乗り継ぎ回数、Google Flights のリンクが含まれます。
• cheapest_dates — 日付範囲内で最も安い搭乗日（最大 21 日間）を、価格カレンダー形式で表示します。1 日につき 1 回検索を実行します。下記の「既知の制限事項」をご覧ください。
• airport_search — オフラインの airportsdata パッケージを使って、都市名や空港名（「Lisbon」など）を IATA コード（LIS）に変換します。

既知の制限事項

• 往復便：return_date を指定した検索では、どちらのプロバイダーも往路の便を返し、最安の条件に合う復路と組み合わせた推定往復合計価格を付記します。復路を別個の価格で返すわけではありません。stops／duration／legs が示すのは往路便のみです。復路を選ぶには、結果の booking_link を Google Flights で開いてください。
• cheapest_dates：fast-flights も SerpApi の Google Flights エンジンも、実際の一括価格カレンダーエンドポイントを提供していません。そのため、候補日ごとに search_flights を 1 回実行します。処理量を抑えるため、期間は最大 21 日間に制限されています。
• EU／英国の Cookie 同意画面：これらの地域からのリクエストには、実際の検索結果を返す前に Google の Cookie 同意画面が表示されます。fast-flights プロバイダーはこれを検出し、再試行の前にプライバシー保護を重視した「すべて拒否」を自動送信します。Google 側の変更に対応する必要が生じた場合は、providers/fast_flights_provider.py をご覧ください。

インストール

最も手早い方法（uv が必要です）：クローンは不要で、PyPI から直接実行できます。

claude mcp add google-flights -- uvx google-flights-search-mcp

Claude Desktop では、"command": "uvx", "args": ["google-flights-search-mcp"] を使用してください。

ソースからインストールする場合：

Python 3.11 以降と uv が必要です。

git clone https://github.com/ThiagoJacobLannes/google-flights-mcp
cd google-flights-mcp
uv sync --extra dev

Windows でコードをクラウド同期フォルダー（Google Drive、OneDrive）に置く場合は、そのフォルダーの外に仮想環境を作成してください。同期クライアントがフォルダーに desktop.ini マーカーファイルを作成することがあり、起動時にパッケージがクラッシュする可能性があります。

uv venv C:\dev\google-flights-mcp-venv
uv pip install --python C:\dev\google-flights-mcp-venv -e ".[dev]"

以下のコマンドパスは、その仮想環境の場所を前提としています。実際の場所に合わせて変更してください。

Claude Desktop に追加する

claude_desktop_config.snippet.json の内容を Claude Desktop の設定ファイル（%APPDATA%\Claude\claude_desktop_config.json）にマージします。

{
  "mcpServers": {
    "google-flights": {
      "command": "C:\\dev\\google-flights-mcp-venv\\Scripts\\python.exe",
      "args": ["-m", "google_flights_mcp.server"]
    }
  }
}

編集後、Claude Desktop を再起動してください。デフォルトのスクレイパーの代わりに SerpApi を使用するには、env ブロックを追加します。

{
  "mcpServers": {
    "google-flights": {
      "command": "C:\\dev\\google-flights-mcp-venv\\Scripts\\python.exe",
      "args": ["-m", "google_flights_mcp.server"],
      "env": { "SERPAPI_KEY": "your-serpapi-key" }
    }
  }
}

キーは serpapi.com で取得できます（無料プランがあります）。

その他の環境変数：GOOGLE_FLIGHTS_DEFAULT_ORIGIN（デフォルトは LIS）、GOOGLE_FLIGHTS_DEFAULT_CURRENCY（デフォルトは EUR）。

HTTP 経由で実行する（リモートコネクター向け）

C:\dev\google-flights-mcp-venv\Scripts\python.exe -m google_flights_mcp.server --http

または、MCP_TRANSPORT=streamable-http を設定します。MCP_HOST（デフォルトは 127.0.0.1）と MCP_PORT（デフォルトは 8000）でバインドアドレスを設定できます。サーバーは http://<host>:<port>/mcp で待ち受けます。ローカルホストの外部に公開する前に、他のリモートコネクターで使用しているリバースプロキシや認証の背後に配置してください。

スモークテスト

モックを使わず、実際のネットワークに接続して、約 1 か月先の LIS → GRU を検索します。

C:\dev\google-flights-mcp-venv\Scripts\python.exe tools\google-flights-mcp\examples\smoke_test.py

テスト

C:\dev\google-flights-mcp-venv\Scripts\python.exe -m pytest tools\google-flights-mcp\tests

これらはプロバイダー抽象化（ファクトリーの選択、搭乗者数の検証、共有される cheapest_dates の日別ループ、空港の解決）に対する単体テストです。ネットワークアクセスは不要です。