🧭 Компас — переговорный тревел-агент для путешествий по России

Агент, которому семья из Екатеринбурга пишет одной фразой:

«Хотим к морю, 45 000 на троих, с ребёнком, без долгих пересадок»

— а он сам находит противоречие между бюджетом и пересадками, показывает развилку прямо на таймлайне, спрашивает чем пожертвовать, помнит ответы и держит наготове план Б на каждое хрупкое звено маршрута.

Проект для ИИ-хакатона Туту MCP, 18–21 августа 2026. Работает поверх Tutu MCP (самолёты, поезда, электрички, автобусы, отели).

Слева направо: стартовая карта-исследование (клики по городам не тратят токены — только Tutu MCP); плашка города с рейсами и ±день; переключение на план Б после сбоя; MCP-виджет (SEP-1865).

Чем это отличается от «ещё одного поиска билетов»

Быстрый старт

git clone https://github.com/svyatrunov/tutu-compass.git && cd tutu-compass

npm install

cp deploy/.env.example apps/server/.env

Заполните OPENROUTER_API_KEY в apps/server/.env и запустите:

npm run dev

Фронт — http://localhost:5173, API — http://localhost:8787 (Vite проксирует /api).

Демо без интернета и без ключей — на записанных фикстурах:

DEMO_MODE=replay npm run dev

Прод целиком в докере:

cd deploy && cp .env.example .env && docker compose up -d --build

Компас как MCP-сервер

Тот же агент доступен как MCP-тул plan_trip — один вызов вместо ручной оркестрации 16 сырых тулов Туту. Endpoint: http://localhost:8787/mcp после npm run dev (Streamable HTTP; на своём сервере — https://<домен>/mcp). Быстро посмотреть виджет без MCP-хоста: http://localhost:8787/api/dev/widget-preview. В хостах с поддержкой MCP Apps (Claude, Claude Desktop, VS Code Copilot, Goose) результат рендерится интерактивным таймлайном прямо в чате (SEP-1865); остальные MCP-клиенты получают текст + структурированный JSON. Память диалога — через sessionId в аргументах тула. Веб-версия — основной канал и от MCP-канала не зависит: оба живут в одном процессе поверх одного ядра agent/*.

Проверка канала: npm run smoke:mcpapp против запущенного сервера.

Полезные команды

Документация

Где смотреть код по критериям хакатона

Правила репозитория

• Секреты только через env. .env в .gitignore, .env.example — в репозитории.

• LLM никогда не генерирует данные маршрута: цены, рейсы и ссылки приходят только из MCP, модель лишь выбирает среди них по id. Это защита от галлюцинаций поверх реальных данных.

Лицензия

MIT — см. LICENSE.