Aviasales

io.github.danyasnov由 GitHub 账号 danyasnov 发布v0.1.1更新于 Oct 24, 2026

Cheap flight search via Aviasales Data API: fares by route, price calendar, cheapest destinations.

概览

AI 生成的概览

本地 MCP 服务器,让助手通过 Aviasales Data API 查询廉价机票:航线票价、价格日历和最便宜目的地。

可以做什么
按名称把城市或机场解析为 IATA 代码(仅此步骤无需令牌,search_places)。查询某航线在指定日期或月份的最便宜机票(search_flights)。显示一个月内每天的最低价格及最便宜的三天(price_calendar)。列出从某城市出发的最便宜目的地,可设价格上限(cheapest_destinations)。
适用场景
适合想探索低价机票、按月比较票价,或查找从某城市出发的便宜目的地,并且可以接受缓存价格而非实时价格的场景。
运行要求
通过 npx 在本地运行,需要 Node.js 22 或更高版本。除地点查询外,都需要在 TRAVELPAYOUTS_TOKEN 环境变量中提供免费的 Travelpayouts API 令牌。AVIA_CURRENCY 可选,用于设置价格货币(默认 rub)。需要访问 Aviasales Data API 的网络连接。
安装前请注意
令牌是敏感信息,通过环境变量传入,请勿写入共享配置。价格来自约 48 小时前的 Aviasales 搜索缓存,并非实时搜索,需通过回复中的 Aviasales 链接确认实际票价。服务器不购买也不预订任何东西。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Aviasales,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

avia-mcp

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

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

Инструменты

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

Токен

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

Подключение

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

Claude Code:

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

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

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

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

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

Разработка

bash
git clone https://github.com/danyasnov/avia-mcp.gitcd avia-mcpnpm installnpm run buildcp .env.example .env   # впишите токен

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

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

Проверка

bash
npm testnpm run smoke

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

Лицензия

MIT

来源:README.md,提交 fe189af

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v0.1.1最新Oct 15, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分