Traveler.md

Traveler.md MCP 服务

Traveler.md 为 AI 助手提供旅客自己的旅行记忆。它保存一份持久的旅行偏好档案，以及每次旅行对应的一份计划。数据归旅客所有，旅客只需授权一次即可访问，并可随时撤销授权。

本仓库介绍托管的 MCP（Model Context Protocol）服务，地址为 https://mcp.traveler.md/mcp。此处未发布服务源代码。完整文档请见 https://docs.traveler.md/mcp。

服务功能

服务存储两种文档，并按请求返回。

• traveler.md 是个人档案，记录稳定的偏好：座位选择、酒店风格、预算、用餐风格和同行者。每位旅客一份。
• trip.md 是单次旅行计划，记录目的地、日期、行程、预订和备注。每位旅客可有多份。

助手会在规划或给出建议前读取这些文档，因此旅客无需重复说明。助手还会写入了解到的信息，让下一次对话也能基于相同的知识展开。

范围：仅限旅行记忆。服务不提供库存、价格、可用情况或推荐引擎。由助手负责给出建议。个人档案会影响建议所依据的信息。

工具

工具	用途
read_profile	返回个人档案，可按指定章节筛选
create_profile	首次使用时创建个人档案
update_profile	修改个人档案中的一个或多个章节
list_trips	按标题、内容、状态或日期分页浏览或搜索旅行计划
read_trip	返回一份旅行计划
create_trip	创建包含标题和状态的旅行计划
update_trip	修改旅行计划的状态、日期、章节或带日期的事件
archive_trip	归档旅行计划

每份文档都由一组命名章节组成，每个章节包含若干简短句子。更新时必须提供最近一次读取所返回的 version_hash，这样两个助手同时写入同一条记录时，不会在对方不知情的情况下互相覆盖。

配置

服务使用可流式 HTTP 和 OAuth 2.1。无需 API 密钥或环境变量。首次使用时，客户端会打开浏览器窗口。旅客登录 Traveler.md 并批准连接。

VS Code 和 GitHub Copilot

一键添加：

也可以将以下内容添加到工作区中的 .vscode/mcp.json，或用户级 mcp.json：

{
  "servers": {
    "travelermd": {
      "type": "http",
      "url": "https://mcp.traveler.md/mcp"
    }
  }
}

其他客户端

claude mcp add --transport http travelermd https://mcp.traveler.md/mcp   # Claude Code
codex mcp add travelermd --url https://mcp.traveler.md/mcp               # Codex

任何支持远程 MCP 的客户端都可以直接使用该 URL：

{
  "mcpServers": {
    "travelermd": {
      "url": "https://mcp.traveler.md/mcp"
    }
  }
}

Claude、Cursor、ChatGPT、Gemini 等客户端的使用指南请见 https://docs.traveler.md/mcp。

使用方法

连接后，可以用日常语言询问旅行相关的问题。助手会调用工具。

你说	助手调用
"我们在里斯本应该住哪里？"	read_profile，然后给出推荐
"我的下一趟旅行是什么时候？"	按开始日期排序的 list_trips
"京都的计划是什么？"	list_trips，然后调用 read_trip
"我一直想要靠过道的座位"	update_profile
"我们订好日式旅馆了"	update_trip
"我真希望有一天能去巴塔哥尼亚"	调用 create_trip，状态为 Dreaming

助手经常仅根据对话内容回答旅行问题，而不读取个人资料。在助手的指令文件中添加一条长期指令，让它先读取个人资料：

Before you recommend, plan, shortlist or book anything travel-related, call read_profile on the travelermd server. When a specific trip is in play, find it with list_trips and open it with read_trip.

技能和 Agent 插件

一个将此服务与用于新手引导、旅行访谈、旅行整理和旅行后回顾的技能打包在一起的 Agent 插件，地址为 https://github.com/TravelAiSolution/traveler-md-agent-plugin。这些技能会教助手了解各部分的名称、句子数量上限，以及先读后写的流程。

数据与隐私

每条记录都归旅行者所有。通过 OAuth 按客户端授予访问权限，并可在 Traveler.md 账户页面撤销。该服务会拒绝信用卡号、护照号码、已知旅客号码、社会安全号码以及门锁或门禁密码。工具也会被要求不要记录健康、无障碍、饮食或生物识别信息。隐私政策见 https://traveler.md/privacy。

支持

如有关于服务或其工具的问题，请在此仓库中提交 issue。如涉及账户或安全事宜，请发送邮件至 [email protected]。

许可证

本 README 及此仓库中的文件均根据 MIT License 授权。托管服务由 Traveler.md 提供。Traveler.md 和 TravelAI 是 TravelAI 的商标；此许可证不授予使用这些商标的任何权利。