Seats.aero MCP v2 서버

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

게시

릴리스는 GitHub Actions를 통해 npm Trusted Publishing(GitHub OIDC)을 사용하여 게시되며, kwonye/yahoo-fantasy-mcp 설정과 일치합니다. 워크플로는 장기 npm 토큰이 필요하지 않으며 GitHub 릴리스 태그가 나타내는 버전을 게시합니다.

초기 패키지 게시를 npm 인증 게시로 한 번 부트스트랩하세요. 패키지가 존재하면 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