mcpField
M
MCP Flight Search

MCP Flight Search

ローカル
pypi.org検索442 週間前に更新

MCP Flight Search について

Claude、Cursor などの MCP クライアントから SerpApi 経由で Google Flights を検索する MCP サーバーです。片道・往復に対応し、構造化されたフライト情報を返します。

主な機能

  1. 01IATA 空港コードでフライト検索
  2. 02片道・往復の検索
  3. 03料金、所要時間、経由地、時刻の取得
  4. 04サーバー状態とバージョンの確認

活用シーン

  1. 012 つの空港間のフライト候補を比較
  2. 02旅行日の料金と行程の詳細を確認

MCP 対応

MCP クライアントにフライト検索とサーバー状態確認のツールを提供します。デフォルトの stdio に加え、Streamable HTTP で動作します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"flight-search": {
"command": "uvx",
"args": [
"mcp-flight-search"
],
"env": {
"SERP_API_KEY": "<SERP_API_KEY>"
}
}
}
}
起動コマンドuvx mcp-flight-search
設定が必要な環境変数
SERP_API_KEYシークレットYour SerpApi key (serpapi.com)

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypimcp-flight-search0.3.0

ツール

2

掲載時のツール一覧 · 3 週間前に更新

パラメーター型必須説明
originstringはいIATA 空港コード。例:JFK、LAX
destinationstringはいIATA 空港コード。例:JFK、LAX
return_dateanyいいえ往復便の復路の日付。形式:YYYY-MM-DD
outbound_datestringはい出発日。形式:YYYY-MM-DD

詳細

MCP Flight Search

Claude、Cursor、その他の MCP クライアント向けに、SerpApi を通じて Google Flights を検索する MCP サーバーです。IATA 空港コードを使って片道と往復の検索ができ、料金、所要時間、乗り継ぎ回数、時刻を確認できます。

CI PyPI

必要条件

  • Python 3.10 以降(または uv)
  • SERP_API_KEY に設定した SerpApi キー(serpapi.com には無料プランがあります)

MCP クライアントから使う

クライアントの MCP 設定に追加します(Claude Desktop、Claude Code、Cursor など)。

{
  "mcpServers": {
    "flight-search": {
      "command": "uvx",
      "args": ["mcp-flight-search"],
      "env": { "SERP_API_KEY": "your-serpapi-key" }
    }
  }
}

または、pip install mcp-flight-search でインストールし、"command": "mcp-flight-search" を使用します。

自分で実行する

export SERP_API_KEY="your-serpapi-key"
mcp-flight-search                                    # stdio (default)
mcp-flight-search --connection_type http --port 3001 # Streamable HTTP at http://127.0.0.1:3001/mcp

LOG_LEVEL=DEBUG を設定すると、stderr により詳細な情報が表示されます。API キーがログに記録されることはありません。

Docker を使用する場合:

docker build -t mcp-flight-search .
docker run -i --rm -e SERP_API_KEY=your-serpapi-key mcp-flight-search

ツール

ツール機能
search_flights_tool2 つの空港間のフライトを検索します。origin、destination:ATL、LAX のような IATA コード。outbound_date:YYYY-MM-DD。return_date(任意):往復の場合は YYYY-MM-DD。航空会社、料金(USD)、所要時間、乗り継ぎ回数、出発時刻、到着時刻、客室クラスを含む構造化された検索結果を返します。
server_statusサーバーが実行中か確認し、バージョンを報告します。

開発

uv sync
uv run pytest
uv run ruff check .

ライセンス

MIT

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。