Google-Flights-MCP-Server

by opspawn
Verified

Google フライト MCP サーバー

この MCP サーバーは、バンドルされたfast_flightsライブラリを使用して Google Flights データと対話するためのツールを提供します。

特徴

次の MCP ツールを提供します。

  • get_flights_on_date : 特定の日付に 2 つの空港間で利用可能な片道航空便を取得します。
    • 引数: origin (str)、 destination (str)、 date (str、 YYYY-MM-DD)、 adults (int、 オプション)、 seat_type (str、 オプション)、 return_cheapest_only (bool、 オプション、 デフォルトはFalse )。
  • get_round_trip_flights : 特定の出発日と帰着日に利用可能な往復航空券を取得します。
    • 引数: origin (str)、 destination (str)、 departure_date (str、YYYY-MM-DD)、 return_date (str、YYYY-MM-DD)、 adults (int、オプション)、 seat_type (str、オプション)、 return_cheapest_only (bool、オプション、デフォルトはFalse )。
  • find_all_flights_in_range : 指定した日付範囲内で利用可能な往復航空券を検索します。オプションで、日付の組み合わせごとに見つかった最も安いフライトのみを返すこともできます。
    • 引数: origin (str)、 destination (str)、 start_date_str (str、YYYY-MM-DD)、 end_date_str (str、YYYY-MM-DD)、 min_stay_days (int、オプション)、 max_stay_days (int、オプション)、 adults (int、オプション)、 seat_type (str、オプション)、 return_cheapest_only (bool、オプション、デフォルトはFalse )。

設定

  1. リポジトリをクローンします。
    git clone https://github.com/opspawn/Google-Flights-MCP-Server.git cd Google-Flights-MCP-Server
  2. 仮想環境を作成します (推奨):
    python -m venv .venv source .venv/bin/activate # On Windows use `.venv\Scripts\activate`
  3. 依存関係をインストールします:
    pip install -r requirements.txt
  4. Playwright ブラウザをインストールします ( fast_flightsに必要)。
    playwright install

サーバーの実行

Python を使用してサーバーを直接実行できます。

python server.py

サーバーはデフォルトで STDIO トランスポートを使用します。

MCP クライアント (例: Cline、Claude Desktop) との統合

MCPクライアントの設定ファイルにサーバーを追加します。例: cline_mcp_settings.jsonまたはclaude_desktop_config.json

{ "mcpServers": { "google-flights": { "command": "/path/to/your/.venv/bin/python", // Use absolute path to venv python "args": [ "/absolute/path/to/flight_mcp_server/server.py" // Use absolute path to server script ], "env": {}, "disabled": false, "autoApprove": [] } // ... other servers } }

重要: commandargsのパスを、仮想環境の Python 実行可能ファイルとシステム上のserver.pyスクリプトへの絶対パスに置き換えます。

注記

  • このサーバーは、コアとなるフライトスクレイピング機能としてfast_flightsライブラリ( https://github.com/AWeirdDev/flightsより提供)をバンドルしています。利用規約については、付属のLICENSEファイルをご覧ください。
  • Googleフライトの変更やネットワーク状況によっては、フライトスクレイピングが不安定になったり、遅くなったりすることがあります。ツールには基本的なエラー処理機能が含まれています。
  • find_all_flights_in_rangeツールは、多くの日付の組み合わせをチェックするため、多くのリソースを消費する可能性があります。
-
security - not tested
-
license - not tested
-
quality - not tested

このMCPサーバーは、AIアシスタントがGoogleフライトを使ってオンラインでフライト情報を検索することを可能にします。特定の日付のフライトを検索したり、日付の範囲を指定してすべての選択肢や最安値のフライトだけを検索したりできます。

  1. Features
    1. Setup
      1. Running the Server
        1. Integrating with MCP Clients (e.g., Cline, Claude Desktop)
          1. Notes
            ID: 2gtyt12ucq