关于 TravelLog
TravelLog 是面向旅行规划和旅行记录用户的托管 MCP 服务。AI 助手可读取行程详情,并在获准后添加或修改旅行数据;建议也可先保留为待处理项,待用户确认后再纳入行程。
主要功能
- 01读取旅行和逐日行程
- 02查看备注、开支和旅行历史
- 03管理去过和想去的地点列表
- 04添加旅行、条目、预订和开支
- 05将想法作为待处理建议提交
- 06经确认后编辑或删除行程条目
适用场景
- 01查询某次旅行特定日期的安排
- 02在旅行中记录开支或预订
- 03将过往旅行批量导入 TravelLog
- 04查看旅行历史和已保存地点
MCP 相关
通过 https://travellogapp.web.app/mcp 提供托管 MCP 端点,支持 OAuth 2.1 with PKCE 或访问密钥。连接的客户端可读取 TravelLog 数据,并通过工具执行获准的更改。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://travellogapp.web.app/mcpclaude mcp add --transport http jarm-dev-travellog https://travellogapp.web.app/mcp{"mcpServers":{"jarm-dev-travellog":{"type":"http","url":"https://travellogapp.web.app/mcp"}}}在 Cursor 中打开{"servers":{"jarm-dev-travellog":{"type":"http","url":"https://travellogapp.web.app/mcp"}}}在 VS Code 中打开{"mcpServers":{"jarm-dev-travellog":{"type":"http","url":"https://travellogapp.web.app/mcp"}}}{"mcpServers":{"jarm-dev-travellog":{"serverUrl":"https://travellogapp.web.app/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
TravelLog MCP 服务
TravelLog 是一款旅行规划和旅行日志工具。按天规划行程,记录去过的地方,并整理想去的地点清单。
这是托管的 MCP 服务,并非开源项目。 TravelLog 为 TravelLog 用户运行此服务。本仓库仅包含文档:没有可供安装或运行的服务端代码。你可以将 AI 助手连接到下方的托管地址,并使用 TravelLog 账户登录。
https://travellogapp.web.app/mcp
目录
功能介绍
连接后,助手可以读取你的 TravelLog 旅行数据:每趟旅行的行程、旅行和每日备注、费用、旅行历史摘要(过去的旅行、离家天数、国家和城市),以及“去过”和“想去”地点清单。如果你允许,助手还可以创建旅行,将自己的想法作为建议添加到旅行中,供你采纳或忽略;添加预订、行程条目、费用、每日备注和你指定的地点;批量导入过去的旅行;以及编辑或删除行程条目。
助手自己的想法不会直接进入你的计划:它们会以“来自 ”的标签作为建议出现。只有当你添加后(在应用中操作,或要求助手添加),建议才会成为正式行程条目。助手被告知,只有当你明确要求添加某项内容时,才直接添加;编辑或删除任何内容前,都要先征求你的同意。
示例:询问“我明天在里斯本的行程是什么?”助手就会读取那天的旅行行程。
完整的工具参考文档位于 TravelLog 网站:https://travellogapp.web.app/mcp-docs。 面向普通用户(非开发者)的设置帮助位于 https://travellogapp.web.app/connect-ai。
设置助手
菜单会不时变化,自定义连接器可能需要付费套餐。如果某个步骤与实际情况不符,请在助手设置中查找“连接器”或“MCP”。
Claude
- 在 Claude 中,打开 设置 › 连接器,然后选择 添加自定义连接器。
- 粘贴地址并选择 添加:
https://travellogapp.web.app/mcp - Claude 会打开 TravelLog 登录页面。登录并允许访问。
ChatGPT
- 在 ChatGPT 中,打开 设置 › 连接器,并启用 开发者模式。
- 添加自定义 MCP 服务,地址为:
https://travellogapp.web.app/mcp - ChatGPT 会打开 TravelLog 登录页面。登录并允许访问。
开发者模式是否可用取决于你的 ChatGPT 套餐。
Grok
- 在 grok.com 上添加自定义连接器。
- 粘贴地址:
https://travellogapp.web.app/mcp - Grok 会打开 TravelLog 登录页面。登录并允许访问。
TravelLog 团队尚未核实 grok.com 上的具体菜单名称。
其他 MCP 客户端
| 设置 | 值 |
|---|---|
| 地址 | https://travellogapp.web.app/mcp |
| 传输方式 | Streamable HTTP |
| 登录 | 使用 PKCE 的 OAuth 2.1。客户端会自行注册(通过动态客户端注册或客户端 ID 元数据文档),因此你无需客户端 ID 或密钥。也可以使用访问密钥。 |
| 元数据 | https://travellogapp.web.app/.well-known/oauth-protected-resource/mcp |
| 协议版本 | 2026-07-28、2025-11-25、2025-06-18 |
你自己的机器人:访问密钥
对于无法打开登录页面的工具(例如你基于 xAI Grok API 构建的机器人),请在 https://travellogapp.web.app/account 创建个人访问密钥,或在 TravelLog 应用中选择 设置 › 已连接的应用 › 创建访问密钥:
- 为密钥命名,选择 只读 或 读写,并选择过期时间:30 天、90 天(默认)、1 年或永不过期。
- 密钥以
tlpat_开头,且只会显示一次。请当场复制;TravelLog 只存储该密钥的单向哈希值。 - 将上述地址提供给你的工具,并将密钥作为 bearer 令牌发送(
Authorization: Bearer tlpat_…),或粘贴到工具要求填写 API 密钥或令牌的位置。 - 你最多可以有 5 个有效密钥,也可以随时撤销其中任何一个。持有密钥的人可以按密钥权限使用你的 TravelLog,因此请妥善保密。
没有 TravelLog 账户?让你的助手为你创建一个
添加此地址即可,无需登录:
https://travellogapp.web.app/mcp?signup=1
你的助手会询问 TravelLog 注册时需要的相同信息(你的电子邮件地址、其他人看到的姓名、唯一的 @handle,以及你是否接受服务条款和隐私政策并且年满 18 岁),且只有在你告知它可以同意时才会回答是。随后,TravelLog 会向你发送一封包含验证链接的电子邮件:你只需点击该链接。然后,助手会收到新账户的访问密钥(读写权限,有效期为 90 天,列在你的访问密钥列表中,你可以撤销该密钥),并且当前聊天会登录该账户。
在你点击链接之前,注册连接只会列出 3 个注册工具;使用其他任何工具时,助手都会收到需要 TravelLog 账户的提示,并且不会执行任何操作。账户验证完成后,连接会告知助手工具列表已更改,并要求助手重新列出工具。注册流程会在 24 小时后过期;如果 3 天内无人点击链接,TravelLog 会删除账户并释放 @handle。
之后,日常使用时请改用上述常规地址。你也可以在 https://travellogapp.web.app/account 或助手打开的登录页面自行创建账户。应用并非必需;稍后安装也可以,所有内容都会在那里。
登录
TravelLog 使用 OAuth。连接时,助手会打开 TravelLog 的连接页面,你可以在其中:
- 使用 TravelLog 账户登录(Google、Apple 或电子邮件),或在同一页面创建账户。
- 查看发起请求的助手、它将返回的网站,以及它想要执行的操作(参见权限)。你可以开启 只读。
- 点击 允许。
点击“允许”之前,不会共享任何内容。助手会获得一个有效期为 1 小时的访问密钥,并使用一个有效期为 60 天的续期密钥续期;每次使用续期密钥时,其有效期都会延长。因此,如果助手 60 天内没有续期,连接便会自动结束。
在网站上创建的账户必须先验证电子邮件,助手才能进行任何更改;在此之前,助手只能读取信息。在 TravelLog 应用中创建的账户不受影响。
权限
连接页面会列出助手请求的权限。你可以全部接受,也可以开启 只读,此时只保留 trips:read。访问密钥分为只读(trips:read)和读写(全部 4 项)。
| 权限范围 | 通俗说明 |
|---|---|
trips:read | 查看你的旅行、行程安排、备注、费用、旅行历史和已保存的地点 |
trips:write | 创建和导入旅行,添加你要求添加的条目、费用、备注和地点,并编辑或移除你有权编辑的旅行中的条目 |
suggestions:write | 向你的旅行添加建议,并将其忽略 |
bookings:write | 将你自己的预订添加到旅行中 |
工具
登录后有 21 个工具,注册地址还额外提供 3 个注册工具。服务端版本为 1.5.0。“读取”工具不会进行任何更改。每个更改工具都会接收一个 clientRequestId,因此重试请求只会执行一次。
阅读(trips:read)
| 工具 | 读取或更改 | 功能 |
|---|---|---|
list_trips | 读取 | 你的行程(你自己的行程和与你共享的行程):名称、日期、目的地、你的角色以及每个行程包含多少条目。按最新优先排序,支持分页。 |
get_itinerary | 读取 | 单个行程的行程安排,可选择指定日期范围:每个条目的标题、类别、地点、当地时间和时区、备注;每日备注;以及待处理的建议。 |
list_suggestions | 读取 | 你可查看的行程待处理建议。 |
get_wishlist | 读取 | 你的“去过”和“想去”地点列表,以及你的备注。 |
get_travel_history | 读取 | 根据你的行程整理出的旅行记录:过往行程、行程数量、离家天数、国家和城市,以及即将开始的行程。 |
get_trip_notes | 读取 | 行程级备注和每日备注。 |
get_trip_expenses | 读取 | 行程费用(标题、金额、货币、类别、日期、付款人、分摊方式)以及每种货币的总额。仅限你拥有或可编辑的行程。 |
request_account_deletion | 更改(仅发送电子邮件) | 请求 TravelLog 向你发送删除账户的链接。此操作不会删除任何内容:只有你能通过该链接删除账户。每分钟最多一个链接,每天最多 3 个。 |
行程(trips:write)
| 工具 | 读取或更改 | 功能 |
|---|---|---|
create_trip | 更改 | 根据名称、目的地和起止日期创建一个新的空行程。 |
add_entry | 更改 | 将你指定的一处停留点或地点添加到行程的某一天,并附上时间、备注以及是否已到访的信息。 |
add_expense | 更改 | 添加你指定的一笔费用,并注明付款人以及在行程参与者之间的分摊方式。 |
add_day_note | 更改 | 为某一天添加备注。保留现有备注;新文本追加到末尾。 |
add_to_wishlist | 更改 | 将一个地点添加到你的“想去”列表,可附带备注。不会编辑或删除已保存的地点。 |
add_been_place | 更改 | 将一个地点添加到你的“去过”列表。不会编辑或删除已保存的地点。 |
import_trips | 更改 | 导入你要求添加的过往行程:每次最多 20 个,每个行程包含其条目和每日备注。每个行程要么整体导入,要么不导入;如果已有同名且日期相同的行程,则会跳过。 |
accept_suggestion | 更改 | 将待处理建议转换为正式条目,效果与在应用中点按 Add 相同。 |
update_entry | 更改 | 更改你拥有或可编辑的行程中的条目:仅更改指定字段。助手必须说明将要更改的内容并获得你的同意。 |
remove_entry | 更改 | 从你拥有或可编辑的行程中移除一个条目,并在所有设备上为行程中的所有人移除。助手必须说明要移除的条目并获得你的同意。 |
建议(suggestions:write)
| 工具 | 读取或更改 | 功能 |
|---|---|---|
add_suggestions | 更改 | 将助手针对某个行程提出的想法一次性提交为一批建议,标记为 "From ",每次最多 40 条。在你添加之前,这些建议都不会成为行程条目。在共享行程中,只有你能看到这些建议。 |
dismiss_suggestion | 更改 | 移除待处理建议而不将其添加为条目,效果与在应用中点按 Dismiss 相同。不会触及行程中已有的条目。 |
预订(bookings:write)
| 工具 | 读取或更改 | 功能 |
|---|---|---|
add_booking | 更改 | 将你实际完成的预订(航班、住宿、餐厅、活动或交通)作为正式条目添加,效果类似于在应用中粘贴确认信息。同一预订已在行程中时,不会重复添加。 |
注册(仅限 https://travellogapp.web.app/mcp?signup=1,不提供登录)
| 工具 | 读取或更改 | 功能说明 |
|---|---|---|
get_started | 读取 | 说明如何在聊天中创建 TravelLog 账户。 |
create_account | 更改 | 经你同意后创建 TravelLog 账户,并发送验证链接到你的邮箱。 |
check_account_status | 更改 | 显示你是否已点击链接;点击后,它会将访问密钥交给助手,并让当前聊天登录。 |
每个工具的参数和完整说明:https://travellogapp.web.app/mcp-docs。
限制
对于你账户中连接的每个助手和每个访问密钥:
- 每小时 60 次调用(其中 20 次为更改),每天 600 次调用。
- 导入有单独的账户限额(所有助手和密钥合计):每小时 10 次导入调用,每天 200 次行程,每次调用 20 次行程,每次行程 80 条记录和 15 条每日备注。每次导入调用仍计入每小时 60 次和每天 600 次的限额,但不计入 20 次更改。
- 每次调用最多 40 条建议(
add_suggestions、accept_suggestion、dismiss_suggestion)。 - 地点列表最多容纳 500 个地点。
- 最多 5 个有效访问密钥。
- 账户删除链接:每分钟 1 个,每天 3 个。每个链接约 1 小时后过期。
- 助手注册:每个网络每分钟 3 个、每天 10 个新账户;每个邮箱地址每天 3 个。
连接助手和使用每个工具,对拥有免费 TravelLog 账户的用户均免费;任何工具都不需要 TravelLog Pro。TravelLog 的 MCP 工具不会在 TravelLog 端运行 AI。
撤销和断开连接
助手添加的建议会标注其名称,并在你添加或忽略之前一直保留为建议。 助手添加或更改的其他所有内容都与你自行编辑的内容一样:你可以在应用中更改或删除,也可以要求助手处理。无法一步撤销助手所做的更改。
在 TravelLog 应用中,前往 设置 › 已连接的应用;或者在网站上前往 https://travellogapp.web.app/account:
- 断开连接(助手)或撤销(访问密钥)会立即停止其访问,并删除 TravelLog 为其保存的请求记录。它已添加的内容仍会保留在你的行程中。此操作不会删除你的账户。
- 退出所有助手和密钥会一步断开所有助手并撤销所有密钥。
你也可以在助手提供相应选项时,从助手内部断开连接;但为确保断开,请在 TravelLog 中操作。 删除 TravelLog 账户会断开所有助手并撤销所有密钥。
隐私
完整政策:https://travellogapp.web.app/privacy(第 3a 节介绍了 AI 助手)。
- **它可以查看的内容:**仅限你允许的内容:行程的名称、日期和目的地(你自己的行程,以及与你共享的行程);每个行程的日程条目(标题、类别、地点、本地开始和结束时间、备注);行程和每日备注;助手为你添加的建议;你的「去过」和「想去」列表及备注;在你询问时整理出的旅行历史摘要;以及在你拥有或可以编辑的行程中,查看费用(标题、金额、货币、类别、日期、付款人和分摊情况)及总额。
- **它绝不会查看的内容:**任何类型的位置追踪数据(追踪记录的位置点、检测到的停留点、距离或时间)、你的私人条目和备注、其他成员的私人条目、结算付款、收据、照片、确认码、他人的个人资料、评论、电子邮件地址或邀请链接。对于以查看者身份与你共享的行程,它无法查看费用,且只能读取。
- **它不能执行的操作:**删除行程、共享行程、更改你的账户,或查看、更改、移除其他成员的私人条目或任何人自己的到访记录。医疗保健场所不会被接受为建议,也不会添加到你的地点列表中。
- **TravelLog 会保留的内容:**仅保留你要求助手存储的内容;每次请求的记录(使用了哪个助手、执行了什么操作、是否成功以及时间),不包含行程内容,保存 90 天;仅以哈希形式保存访问密钥;以及当助手将地点添加到你的列表中时,保存一条简短的添加记录(名称和坐标),保留 30 天,以免尚未同步的手机遗漏该地点。
- **助手所属公司:**助手读取的内容会发送给运营该助手的公司,并受该公司自己的隐私政策约束;即使你断开连接,该公司也可能继续保留这些内容。TravelLog 不会出售这些数据,也不会将助手发送给它的数据用于广告、用户画像或 AI 训练。
- **删除:**助手无法删除你的账户。它只能请求 TravelLog 给你发送一封电子邮件,其中包含一个链接,打开后会显示将要删除的内容,你可以轻点一次确认。无论你是在应用、网站还是通过该链接删除账户,都会删除你的数据、断开与所有助手的连接并撤销所有密钥。
测试情况
TravelLog 团队使用 TravelLog 服务端代码进行了以下测试:
- **MCP Inspector CLI 2.10.1:**在当前及较旧的协议版本上执行
tools/list,并调用list_trips(在该服务端的首个版本上)。 - MCP 一致性测试套件(
@modelcontextprotocol/conformance0.2.0-alpha.12):针对协议版本2026-07-28和2025-11-25(在该服务端的首个版本上)。 - 使用脚本编写的 Streamable HTTP 客户端,针对本地测试服务端运行:完整的 OAuth 流程(客户端注册、登录、授权、代码交换、密钥续期、撤销)、权限检查、上文列出的所有工具、访问密钥、各项限制、断开连接、从
create_account到登录会话的助手注册流程,以及账户删除。
上文介绍的 Claude、ChatGPT 和 Grok 操作步骤来自 TravelLog 网站,目前尚未列为已测试项目。
支持
请发送电子邮件至 [email protected]。隐私问题:请参阅隐私政策。设置帮助:https://travellogapp.web.app/connect-ai。工具参考:https://travellogapp.web.app/mcp-docs。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。