Aviasales

Name: Aviasales
Author: danyasnov

本地服务

github.com/danyasnov地图与出行02 周前更新

代码仓库

关于 Aviasales

Aviasales 是通过 Aviasales Data API 搜索机票价格的 MCP 服务，面向查询航线和日期票价的旅行规划场景。价格来自约 48 小时内的搜索缓存，购买与预订不在服务范围内。

主要功能

01按名称查找城市或机场 IATA 代码
02按航线和日期查询低价机票
03查看月度每日最低价格日历
04按价格上限查找低价目的地

适用场景

01查找城市或机场的 IATA 代码
02比较指定航线的日期票价
03筛选整月较低票价日期
04按预算寻找出发地周边目的地

MCP 相关

作为 MCP 服务，它向客户端提供地点查找、航班搜索、价格日历和低价目的地工具。除 `search_places` 外，工具需要配置 `TRAVELPAYOUTS_TOKEN`；结果价格是缓存数据，最终价格需通过 Aviasales 链接确认。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "danyasnov-avia": {
      "command": "npx",
      "args": [
        "-y",
        "avia-mcp"
      ],
      "env": {
        "TRAVELPAYOUTS_TOKEN": "<TRAVELPAYOUTS_TOKEN>",
        "AVIA_CURRENCY": "<AVIA_CURRENCY>"
      }
    }
  }
}

启动命令npx -y avia-mcp

需要配置的环境变量

TRAVELPAYOUTS_TOKEN密钥Travelpayouts API token (free: travelpayouts.com → Tools → API)

AVIA_CURRENCYPrice currency, e.g. rub, usd, eur

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmavia-mcp0.1.1stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
limit	integer	否	返回的结果数量
query	string	是	俄语或英语的城市或机场名称，例如“Питер”

README 原文English

来自项目 README

README 暂无中文译文，以下为英文原文；中文介绍见上方。

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

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。