mcpField
A
Aviasales

Aviasales

ローカル
github.com/danyasnov地図・旅行02 週間前に更新
リポジトリ

Aviasales について

Aviasales は、Aviasales Data API を使って運賃を検索する MCP サーバーです。路線や日付を調べる旅行計画向けで、価格は約 48 時間分の検索キャッシュに基づき、予約や購入には対応しません。

主な機能

  1. 01名称から都市・空港の IATA コードを検索
  2. 02路線と日付で低価格便を検索
  3. 03月間の日別最低運賃カレンダーを表示
  4. 04価格上限を指定して安い目的地を検索

活用シーン

  1. 01空港や都市の IATA コードを確認
  2. 02路線の複数日程の運賃を比較
  3. 03月内で運賃の安い日を特定
  4. 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.1

ツール

4

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
limitintegerいいえ返す候補数
querystringはいロシア語または英語の都市名・空港名。例：「Питер」

README（原文）English

プロジェクトの README より

この 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:

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_CURRENCYrubВалюта цен.

Разработка

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 サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。