seats.aero MCP server

seats.aero MCP サーバー

重要

この MCP サーバーはメンテナンスされておらず、今後更新されることはありません。 seats.aero は現在、 公式 MCP サーバーを提供しています。新規および既存のインテグレーションには、公式サーバーをご利用ください。

seats.aero とは無関係です

seats.aero Partner API を使用して特典航空券の空席状況を検索する、最小限の TypeScript MCP サーバーです。

seats.aero Partner API キーが必要です。対象となる seats.aero Pro ユーザーは、seats.aero の設定からキーを生成できます。利用には引き続き seats.aero の利用規約と API の制限が適用されます。

エンドポイントへのアクセス

すべての Partner API ユーザーが、すべてのエンドポイントを利用できるわけではありません。

• live_search は seats.aero Pro API キーでは使用できません。seats.aero との商用契約が必要です。
• refresh_cached_data は現在、商用ユーザーは使用できません。API ドキュメントでは、商用ユーザーに代わりに live_search を使用するよう案内しています。

サーバーは API キーの種類をローカルで判別できないため、MCP の指示、ツールの説明、およびツールのメタデータでこれらの制限を案内しています。

セットアップ

Node.js 20 以降が必要です。

pnpm install
pnpm build
pnpm start

MCP クライアントの設定で SEATS_API_KEY を設定してください。

{
  "mcpServers": {
    "seats": {
      "command": "node",
      "args": ["/absolute/path/to/seats-mcp/build/index.js"],
      "env": {
        "SEATS_API_KEY": "YOUR_SEATS_AERO_API_KEY"
      }
    }
  }
}

ツール

ツール	seats.aero エンドポイント	アクセス	目的
get_flights	キャッシュ検索	Partner API	空港、日付、客室クラス、航空会社、マイレージプログラムを指定して、キャッシュされた空席状況を検索します。
get_bulk_avail	一括空席状況	Partner API	1 つのマイレージプログラムから、キャッシュされた多数の空席状況オブジェクトを取得します。
get_routes	ルートの取得	Partner API	1 つのマイレージプログラムで追跡されているルートを一覧表示します。
get_destinations	目的地の取得	Partner API	1 つの空港から、または 1 つの空港への直行便で到達可能な空港と、客室クラス別の最安の未加工価格を検索します。
get_trips	フライトの取得	Partner API	空席状況オブジェクトのフライト単位の詳細を取得します。
refresh_cached_data	キャッシュデータの更新	Pro ユーザー向け。商用ユーザーは対象外	キャッシュされた空席状況オブジェクトの更新をキューに登録するか、更新状況を確認します。
live_search	ライブ検索	商用契約が必要。Pro は対象外	1 つのマイレージプログラムについて、特定のルートと日付をライブ検索します。

キャッシュ検索では、カンマ区切りの空港リスト（SFO,LAX）、客室クラスのリスト（economy,business）、航空会社のリスト（DL,AA）、および検索元のリスト（aeroplan,united）を指定できます。日付には YYYY-MM-DD を使用します。

ライブ検索には通常 5～15 秒かかります。航空会社が利用できない場合は失敗することがあるため、呼び出し側は再試行を制限し、指数バックオフを使用してください。キャッシュされた空席状況で十分な場合は、get_flights を優先してください。

このサーバーは、現在の seats.aero API リファレンスにある有効な 7 つの Partner-Authorization エンドポイントすべてを対象としています。OAuth の同意、トークン、およびユーザー情報のエンドポイントは、特典航空券の空席状況に関する操作ではなく、アプリケーションの認可フローであるため、ツールとして公開していません。このサーバーは SEATS_API_KEY で認証します。

開発

pnpm test

テストではサーバーをビルドし、seats.aero API をモックしてリクエストの構築を検証します。

リリース

リリースは セマンティックバージョニング に従い、 GitHub 上で Release Please によって管理されます。

• fix: コミットはパッチリリースを生成します。
• feat: コミットはマイナーリリースを生成します。
• タイプの後に ! が付いたコミット、または BREAKING CHANGE: フッターを含むコミットは、 メジャーリリースを生成します。
• docs:、test:、chore:、その他のユーザーに影響しないコミットは、それ自体では リリースをトリガーしません。

リリース対象となるコミットが main にマージされると、GitHub Actions が次のバージョンと 変更履歴を含むリリース PR を作成または更新します。その PR をマージすると、対応する vX.Y.Z Git タグが作成され、GitHub Release が公開されます。ワークフロー全体については CONTRIBUTING.md を参照してください。