Seats.aero MCP v2 Server

MCP-сервер v2 для партнёрского API Seats.aero. Поддерживает локальные транспорты stdio и Streamable HTTP.

Опубликованный пакет: @kwonye/seats-aero-mcp

Требования

• Node.js 20+

• Коммерческий партнёрский ключ Seats.aero или подходящий Pro API-ключ

Related MCP server: seats.aero 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 поддерживает кэшированный поиск, массовую доступность, поездки, маршруты, направления и обновление кэша. Коммерческий режим поддерживает всё это, кроме обновления кэша, и добавляет Live Search. 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 доступности для опроса; не используйте ID, возвращённые Live Search, с другими конечными точками.

Тестирование

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