🧭 Компас — agente de viajes negociador para viajes por Rusia

Un agente al que una familia de Ekaterimburgo le escribe con una sola frase:

«Queremos ir al mar, 45 000 para tres, con un niño, sin transbordos largos»

— y él mismo encuentra la contradicción entre el presupuesto y los transbordos, muestra la bifurcación directamente en la línea de tiempo, pregunta con qué sacrificar, recuerda las respuestas y tiene listo un plan B para cada eslabón frágil de la ruta.

Proyecto para el hackathon de IA Tutu MCP, del 18 al 21 de agosto de 2026. Funciona sobre Tutu MCP (aviones, trenes, cercanías, autobuses, hoteles).

De izquierda a derecha: mapa de exploración inicial (los clics en las ciudades no gastan tokens — solo Tutu MCP); tarjeta de ciudad con vuelos y ±día; cambio al plan B tras un fallo; widget MCP (SEP-1865).

En qué se diferencia de «una búsqueda de billetes más»

Inicio rápido

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

npm install

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

Complete OPENROUTER_API_KEY en apps/server/.env y ejecute:

npm run dev

Frontend — http://localhost:5173, API — http://localhost:8787 (Vite hace proxy de /api).

Demo sin internet y sin claves — con fixtures grabadas:

DEMO_MODE=replay npm run dev

Producción completa en Docker:

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

Компас como servidor MCP

El mismo agente está disponible como herramienta MCP plan_trip — una sola llamada en lugar de la orquestación manual de las 16 herramientas crudas de Tutu. Endpoint: http://localhost:8787/mcp después de npm run dev (Streamable HTTP; en su propio servidor — https://<домен>/mcp). Para ver rápidamente el widget sin un host MCP: http://localhost:8787/api/dev/widget-preview. En hosts con soporte para MCP Apps (Claude, Claude Desktop, VS Code Copilot, Goose) el resultado se renderiza como una línea de tiempo interactiva directamente en el chat (SEP-1865); el resto de clientes MCP reciben texto + JSON estructurado. La memoria del diálogo — a través de sessionId en los argumentos de la herramienta. La versión web es el canal principal y no depende del canal MCP: ambos viven en el mismo proceso sobre el mismo núcleo agent/*.

Comprobación del canal: npm run smoke:mcpapp contra el servidor en ejecución.

Comandos útiles

Documentación

Dónde ver el código según los criterios del hackathon

Reglas del repositorio

• Secretos solo a través de env. .env en .gitignore, .env.example — en el repositorio.

• LLM nunca genera los datos de la ruta: los precios, los vuelos y los enlaces provienen solo de MCP, el modelo solo elige entre ellos por id. Es una protección contra alucinaciones sobre datos reales.

Licencia

MIT — ver LICENSE.