Flights Mcp Server

Google Flights MCP サーバー

エージェントや LLM を Google Flights のデータに接続する Model Context Protocol (MCP) サーバーの実装です。フライト情報にアクセスし、最安の選択肢を見つけ、時間制限でフィルタリングし、Google Flights のベストなおすすめを取得できます！

🌍 概要

この MCP サーバーは Google Flights のデータへのシームレスなアクセスを提供し、AI エージェントが次のことを行えるようにします：

• 包括的なフライト情報の取得
• 利用可能な最安フライトの検索
• 特定の時間制約に基づくフライトのフィルタリング
• Google Flights が推奨するベストフライトの取得

注: 現在、このツールは片道のみに対応しています（往復をリクエストした場合でも、2 つの片道として処理されます！）。これは MCP について学ぶための趣味のプロジェクトとして作成したものです。

これが実際に役立つと感じた方や、機能追加を希望される方がいれば、往復やマルチシティの機能を追加できます！！ PR を出すか、ご連絡ください！

🎥 使い方とデモ

クイックスタートに従って Claude Desktop、Cursor、または別の MCP クライアントで設定し、あとは希望するフライト情報について質問するだけです！！

[Claude Desktop のデモ動画を挿入]

🛠️ ツール

利用可能な関数／ツール

1. get_general_flights_info(): 指定したルートの包括的なフライト情報を取得します

   • 最大 40 件のフライトの詳細情報を提供します
   • 人間が読める形式のフライト説明のリストを返します

2. get_cheapest_flights(): 最も手頃なフライトの選択肢を検索します

   • フライトを最低価格順に並べ替えて返します
   • 現在のルート全体の価格情報を含みます

3. get_best_flights(): Google Flights のトップ推奨フライトを取得します

   • Google Flights によって「ベスト」とマークされたフライトを特定して返します
   • ユーザーが最適なフライトを選ぶのに役立ちます

4. get_time_filtered_flights(): 特定の時間制約でフライトをフィルタリングします

   • 指定した時刻より前または後のフライトを検索します
   • 正確なスケジュールの希望に対応できます

入力パラメータ

必須パラメータ

• origin: str - 出発空港の IATA コード（例："ATL"、"SCL"、"JFK"）

• destination: str - 目的地空港の IATA コード（例："DTW"、"ICN"、"LIR"）

• departure_date: str - 出発日（YYYY-MM-DD 形式）

任意パラメータ

• trip_type: str - 旅行タイプ。"one-way" または "round-trip"（デフォルト："one-way"）

• seat: str - 座席タイプ："economy"、"premium-economy"、"business"、または "first"（デフォルト："economy"）

• adults: int - 大人の乗客数（デフォルト：1）

• children: int - 子どもの乗客数（デフォルト：0）

• infants_in_seat: int - 座席が必要な乳幼児の数（デフォルト：0）

• infants_on_lap: int - 膝の上で旅行する乳幼児の数（デフォルト：0）

特定の関数用の追加パラメータ

• n_flights: int - 返すフライトの数（デフォルト：40、get_general_flights_info() のみ）

• state: str - 時間フィルタの状態。"before" または "after"（get_time_filtered_flights() のみ）

• target_time_str: str - 対象時刻（HH:MM AM/PM 形式、get_time_filtered_flights() のみ）

⚡ クイックスタート

Claude Desktop

1. 最新の Claude for Desktop をダウンロードしていることを確認してください！

2. このリポジトリをクローンします

3. Python 環境をセットアップするために uv をインストールします

   MacOS

   # Check if uv is already installed
   uv --version
   
   # If not installed
   curl -LsSf https://astral.sh/uv/install.sh | sh
   

   Windows

   # Check if uv is already installed
   uv --version
   
   # If not installed
   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   

   ⚠️ 重要: インストール後、uv コマンドが認識されるようにターミナルを再起動する必要があります！

4. この flights MCP サーバーを Claude for Desktop の設定に追加します:

   MacOS

   • ターミナルから設定ファイルの場所に移動します: ~/Library/Application Support/Claude/claude_desktop_config.json
   • または、VSCode と Code エイリアスがある場合は、次のコマンドで作成・編集できます:

   code ~/Library/Application\ Support/Claude/claude_desktop_config.json
   

   Windows

   • PowerShell から設定ファイルの場所に移動します: %AppData%\Claude\claude_desktop_config.json
   • または、VSCode と Code エイリアスがある場合は、次のコマンドで作成・編集できます:

   code $env:AppData\Claude\claude_desktop_config.json
   

   注意: ~/Library/Application Support/Claude/config.json は別の無関係なファイルです。編集しないでください。

5. mcpServers キーにこの flights MCP サーバーを追加します:

   {
     "mcpServers": {
       "flights": {
         "command": "/ABSOLUTE/PATH/.local/bin/uv",
         "args": [
           "--directory",
           "/ABSOLUTE/PATH/TO/PARENT/FOLDER",
           "run",
           "flights.py"
         ]
       }
     }
   }
   

   command パラメータには uv の絶対パスを、args パラメータにはこのリポジトリの絶対パスを含めるようにコードを修正してください。

   command フィールドに uv 実行ファイルのフルパスを指定する必要がある場合があります。これは次のコマンドで取得できます:

   • MacOS/Linux では which uv
   • Windows では where uv

   例:

   {
     "mcpServers": {
       "flights": {
         "command": "/Users/sahitmamidipaka/.local/bin/uv",
         "args": [
           "--directory",
           "/Users/sahitmamidipaka/Documents/Google-Flights-MCP-Server",
           "run",
           "flights.py"
         ]
       }
     }
   }
   

6. 以上です！ Claude for Desktop を開くと、小さな MCP Tools アイコンが表示されるはずです（変更を反映するにはアプリを再度開いてください—claude_desktop_config.json ファイルを変更するたびにこれを行う必要があります 😊）

詳細については、Official MCP Documentation を参照してください。

Cursor

1. Cursor を開き、Settings に移動します

2. 左パネルの MCP タブを押します

3. 新しい MCP サーバーを追加します（いずれかを選択）:

   プロジェクト設定

   • プロジェクトディレクトリに .cursor/mcp.json ファイルを作成します
   • 単一のプロジェクトに固有のツールに最適です

   グローバル設定

   • ホームディレクトリに ~/.cursor/mcp.json ファイルを作成します
   • すべての Cursor ワークスペースで MCP サーバーを利用できるようにします

4. mcp.json ファイルに次の設定を追加します:

   {
     "mcpServers": {
       "flights": {
         "command": "uv",
         "args": [
           "--directory",
           "/ABSOLUTE/PATH/TO/PARENT/FOLDER",
           "run",
           "flights.py"
         ]
       }
     }
   }
   

   /ABSOLUTE/PATH/TO/PARENT/FOLDER をこのリポジトリへの実際のパスに置き換えてください。

   command フィールドに uv 実行ファイルのフルパスを指定する必要がある場合があります。これは次のコマンドで取得できます:

   • MacOS/Linux では which uv
   • Windows では where uv

   例:

   {
     "mcpServers": {
       "flights": {
         "command": "/Users/sahitmamidipaka/.local/bin/uv",
         "args": [
           "--directory",
           "/Users/sahitmamidipaka/Documents/Google-Flights-MCP-Server",
           "run",
           "flights.py"
         ]
       }
     }
   }
   

詳細については、Official Cursor MCP Documentation を参照してください。

🚀 使用例

• 2026年1月1日のアトランタから上海へのフライトの選択肢を教えてください
• 今週末のデトロイトからアトランタへのフライトの価格はどのくらいですか？
• 私はニューヨークに住んでいて日本に行きたいです。今週の金曜日に出発する最も安いフライトの選択肢を、私の近くのすべての空港を考慮して探してください！
• 今日の LAX のフライトの選択肢を、午後8時以降のものだけ教えてください

✨ 今後の機能

• より良い往復機能 🚀
• マルチシティ機能 🌍
• Explore / Go Anywhere 機能 🗺️
• 価格グラフと価格履歴 📈

🤝 コントリビューション

お気軽にどうぞ:

• バグや機能リクエストの issue を作成する
• プルリクエストを送信する
• [email protected] まで直接ご連絡ください

📄 ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています - 詳細については LICENSE ファイルをご覧ください。

つまり、以下のことが自由にできます:

• ソフトウェアを商業的に使用する
• ソースコードを改変する
• ソフトウェアを配布する
• ソフトウェアを私的に使用する

MIT ライセンスの条項に従い、配布するソフトウェアまたは派生作品には、元の著作権表示と引用を含める必要があります。

---

このプロジェクトをチェックしていただきありがとうございます! 理由を問わず、いつでもお気軽にご連絡ください。

Note: このプロジェクトは楽しみのために作成されたものであり、Google、Google Flights、その他の Alphabet の子会社とは一切承認または提携していません。