Seats.aero MCP v2 Server

Seats.aero パートナー API 用の MCP v2 サーバーです。ローカルの stdio と Streamable HTTP トランスポートに対応しています。

公開パッケージ: @kwonye/seats-aero-mcp

要件

• Node.js 20+

• Seats.aero の商用パートナーキー、または対象となる Pro API キー

Related MCP server: Award Flight Daily MCP Server

設定

export SEATS_AERO_API_KEY='your-key'
export SEATS_AERO_PLAN='pro' # pro or commercial

オプション設定:

export SEATS_AERO_REQUEST_TIMEOUT_MS=30000
export MCP_HTTP_HOST=127.0.0.1
export MCP_HTTP_PORT=3000
export MCP_HTTP_BEARER_TOKEN='required-for-non-loopback-http'

Pro モードは、キャッシュ検索、一括空き状況、トリップ、ルート、目的地、キャッシュ更新に対応しています。商用モードは、キャッシュ更新を除くすべてに対応し、さらにライブ検索が追加されます。利用資格、割り当て、商用利用の許可は Seats.aero が管理します。

実行

npm install
npm run build
npm start

または、公開された CLI を直接実行します:

npx @kwonye/seats-aero-mcp

デフォルトのトランスポートは stdio です。Streamable HTTP で実行するには:

npm run start:http

MCP エンドポイントは /mcp です。

ツール

• seats_aero_cached_search

• seats_aero_bulk_availability

• seats_aero_get_trips

• seats_aero_get_routes

• seats_aero_get_destinations

• seats_aero_refresh_cached_data — Pro のみ

• seats_aero_live_search — 商用のみ

更新呼び出しは、上流の非同期ステータスを返します。同じ空き状況 ID を繰り返してポーリングしてください。Live Search が返した ID を他のエンドポイントで使用しないでください。

テスト

npm test

公開

リリースは、npm Trusted Publishing (GitHub OIDC) を使用して GitHub Actions によって公開され、kwonye/yahoo-fantasy-mcp の設定と一致します。このワークフローは長期有効な npm トークンを必要とせず、GitHub リリースタグが表すバージョンを公開します。

最初のパッケージ公開は、npm 認証付きの publish で一度だけブートストラップします。パッケージが存在したら、npm のトラステッドパブリッシャーを GitHub オーナー kwonye、リポジトリ seats-aero-mcp、ワークフローファイル名 release.yml で設定します。その後、一時的な npm トークンを削除し、以降のリリースには Trusted Publishing を使用します。

npm CLI 11.15 以降では、トラステッドパブリッシャーは次のように設定できます:

npm trust github @kwonye/seats-aero-mcp \
  --repo kwonye/seats-aero-mcp \
  --file release.yml \
  --allow-publish