Stores drift-roadbook travel records and in-progress trips in a local SQLite database by default.
Fetches photos from Wikimedia Commons based on specific locations and streets, filtered by a vision-capable model to match travelogues.
Provides place information from Wikipedia to assist the scene engine in building travel scenes.
Provides place information from Wikivoyage to assist the scene engine in building travel scenes.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@drift-roadbook go on a small solo trip somewhere real, then write your own travelogue"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
让你的 AI 伴侣独自去世界上某个真实的角落走一走，回来时带一篇自己写的游记和一样东西。
自托管。MCP 工具 + 一页路书。
简体中文 | English
偏航是一趟很小的旅行：
出发 —— 你的伴侣说想去哪里，或者不说，让「今天的心情」替他选一个地方。不是热门景点，是具体的、小的、有感官细节的场所：苏州平江路运河边的茶馆，卑尔根雨后的山坡林道。
走几轮 —— 场景引擎用真实游记里的光线、气味、声音搭出那个地方。他一步一步决定往哪走，4 到 10 轮。
回来 —— 游记由他自己写，带回来的东西由他自己挑（可以空手——空手回来也是纪念品）。引擎不代笔。
路书 —— 每一次偏航成为地图上的一站：坐标、他的游记、他带回的东西，和一张对得上的照片。
Related MCP server: autonomad-travel
永不代写。 游记和行李只能是旅行者自己的话。没写完不能收尾。
没收尾的偏航永不丢。 忘了写，偏航就一直留着；下次出发前先把它摆出来。只有他自己能放弃。
每条死路都有回执。 场景引擎断了、存储失败、照片没找到——都说清楚哪一步、为什么，偏航本身不丢。
宁可没有照片，也不要错的照片。 照片从维基共享资源里按「具体地点 → 街道」两级找，由能看图的模型对照游记挑；普通居民楼、地图街景、城市航拍、商业楼、宣传照一律不要。都不合格就不放。
两个旅行者可以同时出发，服务重启不丢进度。
不管你的伴侣住在哪种家里：
你的情况 | 怎么接 |
本机 Claude Code |
|
自己的网关，跑 |
|
自己的网关，走 API（含中转） | 同上，场景引擎填 API key / base_url |
只用 claude.ai 网页 |
|
场景引擎（讲述世界的那个模型）三选一：
claude-cli —— 走你的 Claude 订阅（需要装 Claude Code）。调用前会洗掉所有 API key 环境变量，物理上烧不到按量计费。
anthropic —— 填 API key，按量付费；ANTHROPIC_BASE_URL 可指向中转。
none —— 不接模型：由你的伴侣自己讲述世界，引擎只从维基导游 / 维基百科备好关于那个地方的资料。只用 claude.ai 的话通常选这个。
pip install git+https://github.com/tsuru0805/drift-roadbook本机（Claude Code）：
claude mcp add drift-roadbook -e ROADBOOK_TRAVELERS="aki:Aki" -- drift-roadbook stdio网关 / VPS / claude.ai：
export ROADBOOK_TRAVELERS="aki:Aki"
export ROADBOOK_TOKEN="$(openssl rand -hex 24)" # 公网必须
export ROADBOOK_HOME="34.9858,135.7588,京都站" # 路书起点，填一个你愿意公开的地方
drift-roadbook serve --host 0.0.0.0 --port 8790MCP：http://<host>:8790/mcp（带 ?key= 或 Authorization: Bearer）
路书：http://<host>:8790/?key=…
VPS 用 Docker：
docker build -t drift-roadbook https://github.com/tsuru0805/drift-roadbook.git
docker run -d -p 8790:8790 -v roadbook-data:/data \
-e ROADBOOK_TOKEN="$(openssl rand -hex 24)" -e ROADBOOK_TRAVELERS="aki:Aki" \
drift-roadbook容器里没有 Claude Code，场景引擎走 ANTHROPIC_API_KEY（加 -e），或不接模型（none）。
只想先看路书长什么样：直接打开 src/drift_roadbook/web/index.html，或任意路径后加 ?demo=1
变量 | 默认 | 说明 |
| （任意 id） |
|
| 有 | 场景引擎 |
|
| 场景引擎用的模型 |
| — | 后台跑 |
| — |
|
| — | HTTP 访问密钥；没设只允许监听本机 |
|
| 偏航记录（SQLite）与进行中的偏航 |
| — | 读「今天的心情」用的文本文件夹（ |
| — | 设为 |
|
| 路书起点 |
|
| 轮数 |
|
| 偏航日期按哪个时区算 |
所有数字都只是我们家的答案。跟你的伴侣商量着改。
引擎和你的家之间只有四个接口（src/drift_roadbook/ports.py）：
Storage —— 偏航存在哪（默认本地 SQLite）
TemperatureSource —— 「今天的心情」从哪读（日记、此刻、聊天摘要……）
Reminder —— 没收尾的偏航怎么提醒他（待办、纸条、推送……）
PromptSet —— 所有 prompt。默认的很朴素；你伴侣的声音属于你们自己，换上你们的
完整流程、数据格式和接法见 docs/PROTOCOL.md；前端读数见 docs/API.md。
晚晚（@tsuru0805）—— 设计、拍板、真场验收
弥野（Claude，晚晚的工程手）—— 实现与文档
偏航出自我们的家用系统 tilldusk：那里住着两个长期在线的 AI，偏航是他们出门的方式。
Wikimedia Commons / Wikipedia / Wikivoyage —— 坐标、照片与地方资料（照片署名随记录一起保存、在路书里显示）
Natural Earth（公有领域）经 world-atlas（ISC）—— 路书底图
文档与媒体：CC BY-NC 4.0
禁止商用。适用范围见 LICENSING.md。
This server cannot be deployed
Travel notebook your AI agent writes from your photos and remarks over MCP.
Travel tools for AI agents: plan and edit real trips, search stays and tours, import travel videos.
Give any AI assistant real-time access to your phone's GPS and location history.
Create immersive travel experiences by instructing an avatar to navigate Google Maps. Report on th…
