wanderlog-mcp

一个 MCP 服务器，允许 Claude（或任何兼容 MCP 的智能体）通过对话查看和构建 Wanderlog 旅行行程。

无需在 Wanderlog 用户界面中点击来规划行程，你只需询问：

“创建一个 14 天的日本黄金路线之旅——东京、箱根、京都、奈良和大阪。”

智能体将调用工具，为每一天插入地点和笔记，添加酒店板块和清单，几分钟内你就能得到一个内容详实的 Wanderlog 行程。

查看真实示例： 14 天日本黄金路线 —— 完全由 AI 智能体使用此 MCP 服务器构建。

v0.1.0 新功能

• 完整的行程构建：在单次对话中添加地点、笔记、酒店和清单

• wanderlog_search_places —— 使用 Wanderlog 的地点数据库查找目的地附近的真实地点

• wanderlog_add_note —— 在地点之间插入交通提示、预订信息和当地建议

• wanderlog_add_checklist —— 旅行前和每日清单（签证、货币、定时入场券）

• 启动时注入 MCP 服务器指令，以便 Claude 自动构建完整的行程

• 启动身份验证探测 —— 立即捕获过期的 Cookie，而不是在对话中途失败

示例提示

"What trips do I have in Wanderlog?"

"Create a 7-day itinerary for Lisbon starting June 1 — include restaurants, day trips,
and a hotel near the waterfront."

"Add a day trip to Sintra on day 3 of my Lisbon trip."

"I'm spending 5 days in Tokyo — build me a full itinerary with museum visits, ramen spots,
and a ryokan in Shinjuku."

"Look at my Barcelona trip and add practical notes for getting between each place."

"Add a pre-trip checklist to my Paris trip — visa, currency, offline maps, travel insurance."

"Move my Rome trip back by two weeks."

"Give me the shareable link to my Kyoto itinerary."

"Remove the Colosseum from day 2 of my Rome trip."

工具

先决条件

• Node.js 22 或更高版本

• 一个 Wanderlog 账户

• 兼容 MCP 的客户端：Claude Code、Claude Desktop、OpenAI Codex、Cursor、VS Code 或任何 stdio MCP 主机

设置

第 1 步 — 获取你的 Wanderlog 会话 Cookie

Wanderlog 没有公共 API，因此 wanderlog-mcp 使用你的浏览器会话 Cookie (connect.sid) 进行身份验证。它大约一年有效，且永远不会离开你的机器。

请像对待密码一样对待它 —— 它授予你在 Wanderlog 用户界面中拥有的相同访问权限。

Chrome / Edge

1. 前往 wanderlog.com 并登录

2. 按 F12 打开开发者工具

3. 点击 Application（应用）选项卡

4. 在左侧边栏展开 Storage → Cookies → https://wanderlog.com

5. 找到 Name 为 connect.sid 的行

6. 点击该行，然后双击 Value 单元格并复制完整字符串 —— 它以 s%3A 开头，长度约为 100 个字符

Firefox

1. 前往 wanderlog.com 并登录

2. 按 F12 打开开发者工具

3. 点击 Storage（存储）选项卡

4. 在左侧边栏展开 Cookies → https://wanderlog.com

5. 在表格中找到 connect.sid，点击它并复制 Value

为什么我不能在控制台中使用 document.cookie？ Wanderlog 设置了带有 HttpOnly 标志的 connect.sid，这会刻意阻止 JavaScript 读取它（XSS 保护）。开发者工具绕过了此限制 —— 这就是为什么它有效而控制台无效的原因。

第 2 步 — 配置你的 MCP 客户端

Claude Code

claude mcp add wanderlog-mcp npx wanderlog-mcp \
  --env WANDERLOG_COOKIE="s%3A...your value here..."

Claude Desktop

编辑 claude_desktop_config.json：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "wanderlog": {
      "command": "npx",
      "args": ["wanderlog-mcp"],
      "env": {
        "WANDERLOG_COOKIE": "s%3A...your value here..."
      }
    }
  }
}

保存后重启 Claude Desktop。

Cursor

设置 → MCP → 添加服务器，或编辑 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "wanderlog": {
      "command": "npx",
      "args": ["wanderlog-mcp"],
      "env": {
        "WANDERLOG_COOKIE": "s%3A...your value here..."
      }
    }
  }
}

VS Code (GitHub Copilot)

添加到你的工作区 .vscode/mcp.json：

{
  "servers": {
    "wanderlog": {
      "type": "stdio",
      "command": "npx",
      "args": ["wanderlog-mcp"],
      "env": {
        "WANDERLOG_COOKIE": "s%3A...your value here..."
      }
    }
  }
}

OpenAI Codex

编辑 ~/.codex/config.toml：

[mcp_servers.wanderlog]
command = "npx"
args = ["wanderlog-mcp"]

[mcp_servers.wanderlog.env]
WANDERLOG_COOKIE = "s%3A...your value here..."

在 Codex 中运行 /mcp 以确认服务器已加载。

Smithery (一键安装)

npx @smithery/cli install wanderlog-mcp --client claude

第 3 步 — 验证

询问你的智能体：“我在 Wanderlog 中有哪些行程？”

它应该调用 wanderlog_list_trips 并返回你账户中的行程。如果失败，请参阅下方的 故障排除。

刷新你的 Cookie

Cookie 大约持续一年，但如果你注销 wanderlog.com、更改密码或 Wanderlog 撤销了会话，它可能会提前失效。当这种情况发生时，每个工具调用都会返回：

Wanderlog 会话无效或已过期 —— 从 wanderlog.com 开发者工具中捕获新的 connect.sid Cookie，并更新 MCP 配置中的 WANDERLOG_COOKIE。

重复上述第 1 步，更新你的配置，并重启你的 MCP 客户端。

故障排除

服务器启动但 list_trips 返回身份验证错误 你的 Cookie 已过期或错误。从开发者工具中重新捕获它并更新你的配置。

npx wanderlog-mcp 挂起或无反应 该服务器使用 stdio MCP 通信 —— 它旨在由 MCP 主机启动，而不是直接在终端中运行。按照上述说明通过 Claude Code 或 Claude Desktop 运行它。

工具正常工作但智能体忽略了笔记/清单 服务器将指令注入到 MCP initialize 响应中，告诉智能体插入地点和笔记并添加清单。这在 Claude 上运行可靠。其他客户端的表现可能有所不同。

安全性

• Cookie 仅存储在你的 MCP 客户端配置中，绝不会被提交或记录

• wanderlog-mcp 完全在你的机器上运行 —— 没有中继服务器

• 启动身份验证探测会在不打印其值的情况下验证你的 Cookie

• 要撤销访问权限：注销 wanderlog.com（使所有会话失效），然后重新捕获

贡献

欢迎提交 Pull Request。在提交之前：

npm run build && npm run test

对于传输或工具代码的更改，也请运行：

npm run test:integration

免责声明

wanderlog-mcp 是一个非官方的第三方工具，不隶属于 Wanderlog，也不受其认可。它通过调用 Wanderlog 的私有 Web 客户端 API 工作，该 API 可能会在不另行通知的情况下更改。使用风险自负。

许可证

MIT — 参见 LICENSE

由 shaikhspeare 制作