🧭 Компас — ロシア旅行のための交渉型トラベルエージェント

エカテリンブルクの家族が一言で書き込むエージェント：

「海に行きたい、3人で45,000、子供連れ、長時間の乗り継ぎなし」

— そしてエージェント自身が予算と乗り継ぎの矛盾を見つけ、タイムライン上に分岐点を直接表示し、 何を犠牲にするかを尋ね、回答を覚えていて、ルートの脆い各リンクに対してプランBを 用意している。

Туту MCP AIハッカソン（2026年8月18日〜21日）のプロジェクト。Tutu MCP 上で動作する （飛行機、列車、電車、バス、ホテル）。

左から右へ：探索用スタートマップ（都市のクリックはトークンを消費しない — Tutu MCPのみ）； 都市の便と±日のプレート；障害後のプランBへの切り替え；MCPウィジェット（SEP-1865）。

これは「もう一つのチケット検索」とどう違うのか

クイックスタート

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

npm install

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

apps/server/.env の OPENROUTER_API_KEY を入力して、次を実行します：

npm run dev

フロントは http://localhost:5173、APIは http://localhost:8787（Viteが /api をプロキシ）。

インターネットもキーも不要なデモ — 記録済みフィクスチャを使用：

DEMO_MODE=replay npm run dev

本番はすべてDockerで：

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

MCPサーバーとしてのКомпас

同じエージェントはMCPツール plan_trip として利用可能 — 手動オーケストレーションの代わりに1回の呼び出しで済む Тутуの16の生ツール。エンドポイント：npm run dev 実行後は http://localhost:8787/mcp （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 を参照。