🧭 指南针 — 俄罗斯境内旅行的谈判式旅行代理

一个代理，叶卡捷琳堡的一个家庭用一句话就能向它描述需求：

“想去海边，三人共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 使用——一次调用即可替代手动编排16个原始Tutu工具。端点：http://localhost:8787/mcp，在 npm run dev 之后（Streamable HTTP；在您自己的服务器上 — https://<域名>/mcp）。快速查看小部件而无需MCP主机：http://localhost:8787/api/dev/widget-preview。在支持MCP应用的主机（Claude、Claude Desktop、VS Code Copilot、Goose）中，结果会以交互式时间线的形式直接渲染在聊天中（SEP-1865）；其他MCP客户端则接收文本 + 结构化JSON。对话记忆通过工具参数中的 sessionId 实现。Web版本是主要渠道，不依赖MCP渠道：两者都运行在同一个进程中，基于同一个 agent/* 核心。

渠道检查：npm run smoke:mcpapp 针对已启动的服务器运行。

有用的命令

文档

按黑客马拉松标准查看代码

仓库规则

• 秘密仅通过环境变量传递。.env 在 .gitignore 中，.env.example 在仓库中。

• LLM 绝不生成路线数据：价格、航班和链接仅来自MCP，模型只根据 id 从中选择。这是对真实数据之上幻觉的防护。

许可证

MIT — 参见 LICENSE。