Aviasales MCP Server

Русский · English · MIT License

Production-oriented Python MCP server for cached Aviasales/Travelpayouts flight-price data and verified Travelpayouts affiliate links. It exposes exactly two tools: search_flights and analyze_price_calendar.

Travelpayouts Data API responses are cached market data, not guaranteed live inventory. Price and availability must be confirmed on Aviasales before purchase.

Русский

Возможности

• Streamable HTTP endpoint: https://YOUR_DOMAIN/mcp;

• строгая Pydantic-валидация запросов;

• Redis Streams, несколько worker-процессов, backpressure и reclaim заданий;

• retry, deadline, cache, rate limit и circuit breaker;

• обязательное преобразование обычных Aviasales URL через Partner Links API;

• Bearer-аутентификация, Host/Origin allowlist, health/readiness и метрики.

Быстрый запуск в Docker

git clone https://github.com/neurologicby/mcp-aviasales-search.git
cd mcp-aviasales-search
cp .env.example .env
nano .env
chmod 600 .env
docker compose config --quiet
docker compose up --build -d
curl http://127.0.0.1:8000/readyz

В .env обязательно замените TRAVELPAYOUTS_TOKEN, TRAVELPAYOUTS_TRS, TRAVELPAYOUTS_MARKER и MCP_BEARER_TOKEN. Для production укажите HTTPS-домен в MCP_ISSUER_URL, MCP_RESOURCE_SERVER_URL, MCP_ALLOWED_HOSTS и MCP_ALLOWED_ORIGINS. Порт по умолчанию привязан только к 127.0.0.1; внешний доступ настраивается через HTTPS reverse proxy.

Подробные руководства:

• Развёртывание на Ubuntu

• Подключение Codex, Claude Code, VS Code, Cursor и OpenAI Agents

• Архитектура и эксплуатация

Проверка

uv sync --extra test --python 3.13
uv run pytest --cov=aviasales_mcp --cov-report=term-missing
uv run ruff check .
uv run bandit -q -r src
docker compose config --quiet

Related MCP server: Airline Reservation MCP Server

English

Features

• Streamable HTTP endpoint at https://YOUR_DOMAIN/mcp;

• strict Pydantic request validation;

• Redis Streams, multiple workers, backpressure and stale-job reclaim;

• retries, deadlines, caching, distributed rate limiting and a circuit breaker;

• mandatory conversion of plain Aviasales URLs through the Partner Links API;

• bearer authentication, Host/Origin allowlists, health/readiness and metrics.

Docker quick start

git clone https://github.com/neurologicby/mcp-aviasales-search.git
cd mcp-aviasales-search
cp .env.example .env
nano .env
chmod 600 .env
docker compose config --quiet
docker compose up --build -d
curl http://127.0.0.1:8000/readyz

Replace TRAVELPAYOUTS_TOKEN, TRAVELPAYOUTS_TRS, TRAVELPAYOUTS_MARKER, and MCP_BEARER_TOKEN in .env. For production, set the HTTPS domain in MCP_ISSUER_URL, MCP_RESOURCE_SERVER_URL, MCP_ALLOWED_HOSTS, and MCP_ALLOWED_ORIGINS. The published port binds to 127.0.0.1 by default; expose it through an HTTPS reverse proxy.

Full guides:

• Ubuntu deployment

• Connect Codex, Claude Code, VS Code, Cursor, and OpenAI Agents

• Architecture and operations (Russian)

Validation

uv sync --extra test --python 3.13
uv run pytest --cov=aviasales_mcp --cov-report=term-missing
uv run ruff check .
uv run bandit -q -r src
docker compose config --quiet

License

Released under the MIT License.