avia-mcp

MCP-сервер для поиска дешёвых авиабилетов через Aviasales Data API (Travelpayouts).

Цены берутся из кэша поисков Aviasales примерно за 48 часов — это не живой поиск. Актуальную цену подтверждает ссылка на Aviasales из ответа. Покупки и бронирования через сервер нет.

Инструменты

Инструмент	Что делает
search_places	IATA-код города или аэропорта по названию. Токен не нужен.
search_flights	Самые дешёвые билеты по маршруту на дату или месяц.
price_calendar	Минимальная цена по дням месяца и три самых дешёвых дня.
cheapest_destinations	Самые дешёвые направления из города, с потолком цены.

Токен

Бесплатный токен: travelpayouts.com → «Инструменты» → API. Без токена работает только search_places.

Подключение

Нужен Node.js 22 или новее. Сервер запускается через npx, ставить вручную ничего не надо.

Claude Code:

claude mcp add avia --scope user -e TRAVELPAYOUTS_TOKEN=ваш_токен -- npx -y avia-mcp

Claude Desktop, Cursor и другие клиенты — в конфиге MCP-серверов (для Claude Desktop это claude_desktop_config.json):

{
  "mcpServers": {
    "avia": {
      "command": "npx",
      "args": ["-y", "avia-mcp"],
      "env": { "TRAVELPAYOUTS_TOKEN": "ваш_токен" }
    }
  }
}

Переменные окружения

Переменная	По умолчанию	Что задаёт
TRAVELPAYOUTS_TOKEN	—	Токен Travelpayouts.
AVIA_CURRENCY	rub	Валюта цен.

Разработка

git clone https://github.com/danyasnov/avia-mcp.git
cd avia-mcp
npm install
npm run build
cp .env.example .env   # впишите токен

При запуске из клона сервер читает .env в корне проекта; переменные окружения процесса важнее файла. Подключить локальную сборку:

claude mcp add avia --scope user -- node /путь/к/avia-mcp/dist/index.js

Проверка

npm test
npm run smoke

npm run smoke запускает собранный сервер и вызывает каждый инструмент по разу. Без токена отвечает только search_places, остальные возвращают подсказку про токен.

Лицензия

MIT