🧭 Компас — Verhandlungs-Reiseagent für Reisen durch Russland

Ein Agent, dem eine Familie aus Jekaterinburg mit einem Satz schreibt:

„Wir möchten ans Meer, 45 000 für drei, mit Kind, ohne lange Umstiege“

— und er selbst findet den Widerspruch zwischen Budget und Umstiegen, zeigt die Weggabelung direkt auf der Timeline, fragt, worauf man verzichten möchte, merkt sich die Antworten und hält für jedes fragile Glied der Route einen Plan B bereit.

Projekt für den Tutu-MCP-KI-Hackathon, 18.–21. August 2026. Läuft auf Tutu MCP (Flüge, Züge, S-Bahnen, Busse, Hotels).

Von links nach rechts: Startkarte zur Erkundung (Klicks auf Städte verbrauchen keine Tokens – nur Tutu MCP); Stadtkachel mit Verbindungen und ±Tag; Umschalten auf Plan B nach einem Ausfall; MCP-Widget (SEP-1865).

Was es von einer „weiteren Ticketsuche“ unterscheidet

Schnellstart

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

npm install

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

Füllen Sie OPENROUTER_API_KEY in apps/server/.env aus und starten Sie:

npm run dev

Frontend – http://localhost:5173, API – http://localhost:8787 (Vite proxied /api).

Demo ohne Internet und ohne Schlüssel – mit aufgezeichneten Fixtures:

DEMO_MODE=replay npm run dev

Produktion komplett in Docker:

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

Компас als MCP-Server

Derselbe Agent ist als MCP-Tool plan_trip verfügbar – ein Aufruf statt manueller Orchestrierung von 16 rohen Tutu-Tools. Endpoint: http://localhost:8787/mcp nach npm run dev (Streamable HTTP; auf eigenem Server – https://<domain>/mcp). Widget ohne MCP-Host schnell ansehen: http://localhost:8787/api/dev/widget-preview. In Hosts mit MCP-App-Unterstützung (Claude, Claude Desktop, VS Code Copilot, Goose) wird das Ergebnis als interaktive Timeline direkt im Chat gerendert (SEP-1865); andere MCP-Clients erhalten Text + strukturiertes JSON. Dialogspeicher – über sessionId in den Tool-Argumenten. Die Webversion ist der Hauptkanal und unabhängig vom MCP-Kanal: Beide laufen in einem Prozess auf demselben Kern agent/*.

Kanalprüfung: npm run smoke:mcpapp gegen den laufenden Server.

Nützliche Befehle

Dokumentation

Wo der Code nach Hackathon-Kriterien zu finden ist

Repository-Regeln

• Geheimnisse nur über env. .env in .gitignore, .env.example – im Repository.

• Das LLM generiert niemals Routendaten: Preise, Flüge und Links kommen nur vom MCP, das Modell wählt lediglich anhand von id daraus aus. Das ist ein Schutz vor Halluzinationen auf Basis echter Daten.

Lizenz

MIT – siehe LICENSE.