travelpayouts-mcp

Travelpayouts MCP — AI アシスタント向けフライト・ホテル検索

Claude などの AI アシスタントに、ある路線の最安フライトを探してもらったり、日程に余裕のある場合に日付ごとの料金カレンダーを表示したり、空港コードや航空会社コードを調べたり、ホテルを検索したりする方法をお探しなら、これがぴったりです。Travelpayouts（Aviasales）API を利用する 13 個のツールで、フライト検索、料金カレンダー、ホテル検索、空港・航空会社・都市の検索、直行便の路線、日程に余裕がある場合の料金検索ができます。

インストール

npm install -g @theyahia/travelpayouts-mcp

または、npx から直接使用できます。

npx @theyahia/travelpayouts-mcp

環境変数

変数	必須	説明
TRAVELPAYOUTS_TOKEN	はい	Travelpayouts の API トークン

Claude Desktop の設定

{
  "mcpServers": {
    "travelpayouts": {
      "command": "npx",
      "args": ["-y", "@theyahia/travelpayouts-mcp"],
      "env": {
        "TRAVELPAYOUTS_TOKEN": "your-token"
      }
    }
  }
}

ツール（13 個）

フライト（8 個）

ツール	説明
search_flights_prices	路線、日程、通貨を指定して格安フライトを検索します
get_cheapest_month	1 か月分の最安フライトを検索します
get_calendar_prices	日ごとの最安料金を表示する料金カレンダーです
get_popular_directions	都市からの人気フライト路線と料金を取得します
get_airline_directions	特定の航空会社が運航する路線を取得します
get_special_offers	全路線の最新フライト特別割引を取得します
get_direct_routes	2 都市間の直行便のみを検索します
get_nearest_prices	指定日を中心とした前後 ±N 日の料金を取得します（日程に柔軟性がある場合）

ホテル（2 個）

ツール	説明
search_hotels	都市、日程、宿泊人数を指定してホテルを検索します
get_hotel_prices	ID を指定して特定のホテルの料金を取得します

検索（3 個）

ツール	説明
lookup_airports	空港名または IATA コードで空港を検索・オートコンプリートします
lookup_airlines	航空会社名または IATA／ICAO コードで航空会社を検索します
lookup_cities	都市名または IATA コードで都市を検索・オートコンプリートします

認証

API トークンは X-Access-Token ヘッダーまたはクエリパラメーターで渡されます。429（レート制限）および 5xx（サーバーエラー）の場合は、指数バックオフで再試行します。

デモ用プロンプト

1. 「6 月にモスクワからイスタンブールへの最安フライトを探して」 lookup_cities で IATA コードを調べてから、get_cheapest_month でその月のお得なフライトを検索します。

2. 「今、サンクトペテルブルク発の人気の目的地はどこ？」 出発地に LED を指定して get_popular_directions を使用し、人気の路線と現在の料金を表示します。

3. 「7 月 10 日から 17 日まで、ソチで大人 2 人分のホテルを検索してから、モスクワ発のフライトも探して」 search_hotels で宿泊先の候補を検索し、続いて search_flights_prices で日程に合うフライトを検索します。

4. 「3 月 15 日ごろにモスクワからドバイへ行きたいけど、安ければ前後 3 日でも大丈夫」 get_nearest_prices で、3 月 15 日を中心とする 7 日間の料金を比較します。

5. 「モスクワからミンスクへの直行便だけを探して」 get_direct_routes を direct=true フィルター付きで使用します。

開発

npm install
npm run dev          # Run with tsx
npm test             # Run tests
npm run build        # Compile TypeScript

ライセンス

MIT

---

Telegram: @vhodvai