Skip to main content
Glama
deenesjakoruzh
svyatrunov

tutu-compass

by svyatrunov
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

🧭 Компас — 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).

Weggabelung: Budget gegen „ohne Zug“ – der Agent fragt, worauf man verzichten möchte

Startbildschirm: Karte mit Preisen in Nachbarstädte

Klick auf Stadt: nächste Flüge und Preise ohne ein einziges LLM-Token

Verbindungsausfall: „vorher → nachher“, Plan B sofort angewendet

Derselbe Agent als MCP-App: interaktives Widget im Claude-Chat

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

Normale Suche

Компас

Formular mit zehn Feldern

Ein Satz in natürlicher Sprache

„Nichts gefunden“

„Budget und Umstieg < 1 Std. gleichzeitig ist nicht möglich – worauf verzichten wir?“

Bester Wert nach Formel

Weggabelung mit ehrlichem Trade-off und Erinnerung an Ihre Wahl

Tickets ausverkauft – von vorn beginnen

Plan B ist im Voraus berechnet, Umschalten sofort

Related MCP server: GemmaJnana

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

Befehl

Was es tut

npm run mcp:discover

Ermittelt die tatsächliche Spezifikation der Tutu-Tools → docs/MCP-NOTES.md

npm run fixtures:record

Zeichnet MCP-Antworten in fixtures/recorded für die Wiedergabe auf

npm test

Unit-Tests für Konflikte und Plan B + Contract-Tests der MCP-Schemata

npm run smoke

E2E-Durchlauf des Demo-Szenarios gegen den gestarteten Server

npm run lint / npm run typecheck

ESLint / TypeScript strict

Dokumentation

Dokument

Wofür

docs/AGENT-BRIEF.md

Beginnen Sie hier. In sich geschlossene Referenz zur Bewertung: Flow, Stack, Benchmarks, Selbsteinschätzung nach Hackathon-Tracks

docs/SYSTEM-MAP.md

Systemkarte: 16 Tutu-Tools → unsere Module → Kanäle + schnelle Antworten auf Juryfragen

docs/ROADMAP.md

Arbeitsplan bis zum Code Freeze, sortiert nach „Punkten pro Stunde“

docs/MCP-FEEDBACK.md

12 strukturierte Vorschläge zur Tutu-MCP-Spezifikation – mit reproduzierbaren Erkenntnissen

docs/ARCHITECTURE.md

Diagramm, Agentenzyklus, Konflikterkennung

docs/ASSUMPTIONS.md

Ehrliche Liste: Was wirklich vom MCP stammt, was Simulation ist

docs/MCP-NOTES.md

Tatsächliche (nicht behauptete) Spezifikation von Tutu MCP

docs/EVALS.md

Modellstrategie und Protokoll der Benchmark-Erkenntnisse

docs/PITCH.md

Thesen und Timing des Pitches

Wo der Code nach Hackathon-Kriterien zu finden ist

Kriterium

Wo nachsehen

Funktionstiefe

agent/orchestrator.ts – Agentenzyklus

Innovationskraft

agent/conflicts.ts – Konflikt als beweisbare Tatsache, ohne einen einzigen LLM-Aufruf

UX/UI

components/Timeline – Konfliktknoten und gestrichelte Linie von Plan B

Stabilität

mcp/client.ts – Cache, Retry, Fixture-Replay

Architektur

docs/ARCHITECTURE.md

Ehrlichkeit

docs/ASSUMPTIONS.md – was wirklich vom MCP stammt und was Simulation ist

Codequalität

tsconfig.base.json (strict + noUncheckedIndexedAccess), ESLint, CI

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.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers