MCP Flight Search

🚀 MCPベースのフライト検索

Model Context Protocol (MCP) を使用して構築されたフライト検索サービスです。このプロジェクトは、MCPツールを実装してフライト検索機能をサポートする方法を示しています。

🚀 クイックスタート

このサービスは、Model Context Protocol (MCP) を使用してフライト検索機能を提供します。以下の手順に従って、サービスを起動してください。

✨ 主な機能

• MCP標準に準拠したフライト検索機能ツール
• SerpAPI Google Flights を統合して使用
• 片道と往復のフライトをサポート
• 豊富なログ記録機能で、構造化されたログを出力
• モジュール化され、保守が容易なコード構造

📦 インストール

# PyPI からインストール
pip install mcp-flight-search

# または開発モードで直接インストール
pip install -e .

💻 使用例

基本的な使用法

MCPサーバーを起動するには、以下のコマンドを実行します。

# コマンドラインエントリポイントを使用
mcp-flight-search --connection_type http

# または直接実行
python main.py --connection_type http

高度な使用法

カスタムポートを指定することもできます。

python main.py --connection_type http --port 5000

📚 ドキュメント

環境変数

SerpAPIキーを環境変数として設定します。

export SERP_API_KEY="your-api-key-here"

MCPツール

このパッケージは、以下のModel Context Protocolツールを提供します。

• search_flights_tool：空港間のフライトを検索します。パラメータは以下の通りです。

  • origin：出発空港コード（例：ATL, JFK）
  • destination：到着空港コード（例：LAX, ORD）
  • outbound_date：出発日（YYYY-MM-DD）
  • return_date：オプションの帰り日（YYYY-MM-DD）

• server_status：MCPサーバーが実行中かどうかを確認します。

プロジェクト構造

mcp-flight-search/
├── mcp_flight_search/
│   ├── __init__.py              # パッケージの初期化とエクスポート
│   ├── config.py                # 設定変数（APIキー）
│   ├── models/
│   │   ├── __init__.py          # モデルパッケージの初期化
│   │   └── schemas.py           # Pydanticモデル（FlightInfo）
│   ├── services/
│   │   ├── __init__.py          # サービスパッケージの初期化
│   │   ├── search_service.py    # 主なフライト検索ロジック
│   │   └── serpapi_client.py    # SerpAPIクライアントのラッパー
│   ├── utils/
│   │   ├── __init__.py          # ユーティリティパッケージの初期化
│   │   └── logging.py           # ログ記録の設定
│   └── server.py                # MCPサーバーの設定とツールの登録
├── main.py                      # エントリポイント
├── pyproject.toml               # Pythonパッケージの設定
├── LICENSE                      # MITライセンス
└── README.md                    # プロジェクトのドキュメント

作者

AI/MLや生成AIに関する記事をもっと知りたい場合は、私のMediumブログをご覧ください：https://medium.com/@arjun-prabhulal

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。