Flights MCP

🚀 ✈️ フライトMCPサーバー

Aviasalesのフライト検索APIを使用して、フライト検索機能を提供するモデルコンテキストプロトコル（MCP）サーバーです。このサーバーを使用すると、フライトを検索し、結果をフィルタリングし、詳細なフライト情報を取得し、予約リンクを生成することができます。

https://github.com/user-attachments/assets/87d79d54-c4ab-4938-9792-18572315f1ba

🚀 クイックスタート

リモートMCPサーバーを使用するか、独自のインスタンスをデプロイすることができます。

• リモートMCP
  公開インスタンスは以下のURLで利用可能です。
  https://findflights.me/sse
  このサーバーはSSEトランスポートプロトコルを使用しており、設定なしですぐに使用できます。

  ⚠️ 重要: 現在、すべてのLLMクライアントがリモートMCP接続をサポートしているわけではありません。例えば、Claude.aiはPro+プランでのみリモートMCP統合をサポートしています。

• セルフホスティングデプロイメント
  独自のサーバーを実行したい場合は、インストールセクションの手順に従ってください。

  注意: 独自のサーバーをデプロイするには、AviasalesのAPIキーとマーカーIDを取得する必要があります。

✨ 主な機能

• フライト検索：片道、往復、マルチシティのフライトを検索できます。
• 高度なフィルタリング：価格、飛行時間、航空会社、出発/到着時間、経由回数などで結果をフィルタリングできます。
• 複数の並べ替えオプション：価格、出発時間、到着時間、または飛行時間で並べ替えることができます。
• 詳細なフライト情報：手荷物許容量や航空会社情報を含む包括的なフライト詳細を取得できます。
• 予約リンク：選択したフライトの予約リンクを生成できます。
• ローカルストレージ：実行された検索はローカルに保存されるため、LLMは過去の検索結果にすぐにアクセスできます。
• 複数のMCPトランスポートオプション：stdio、HTTP、およびSSEトランスポートをサポートしています。

📦 インストール

前提条件

• AviasalesのAPIキー
• Python 3.12以上
• UVパッケージマネージャー

セットアップ

1. リポジトリをクローンします。

git clone <repository-url>
cd flights-mcp

3. 環境変数を設定します（環境変数セクションを参照）

4. サーバーを起動します。

uv run src/flights-mcp/main.py

サーバーは0.0.0.0にバインドされるため、ホストマシンのすべてのネットワークインターフェイスからアクセスできます。

環境変数

以下の環境変数が必要です。

MCPツール

サーバーは以下のMCPツールを提供します。

💻 使用例

基本的な使用法

1. search_flights()を使用してフライトを検索します - 柔軟な日付で複数回呼び出すことができます。
2. get_flight_options()を使用してオプションをフィルタリングして閲覧します - 軽量なツールで、異なるフィルターとソートオプションで複数回呼び出すことができます。
3. get_flight_option_details()を使用して詳細情報を取得します - ユーザーが選択したオプションに対して。
4. request_booking_link()を使用して予約リンクを生成します - ユーザーが予約の意思を確認した場合のみ。

サポート

以下の問題に関しては：

• MCPサーバー：このリポジトリに問題を登録してください。
• MCPプロトコル：モデルコンテキストプロトコルドキュメントを参照してください。