Trvl

社区

为 AI 助手提供真实的旅行搜索：航班、酒店、火车、汽车、渡轮，无需 API 密钥，单一 Go 二进制文件。

分类: 其他第 106 / 230
Stars: ★ 87 热门
传输方式: stdio（本地进程）
运行环境: 预编译二进制 · Go · Docker · Node.js
凭据: 可选 API Key
许可证: 其他 / 未声明
最近提交: 1 天前
工具数: 1

55FMRS · C

trvl 是一个强大且创新的旅行 MCP 服务器，提供全面的旅行搜索功能，且无需 API 密钥。其单一工具设计减少了 token 消耗，优化功能（如拆分航空、优化日期）非常实用。但它有隐私风险（自动读取浏览器 cookie）和合规问题（供应商 ToS）。适合个人和开发者使用，但商业用途受限。

最强项 · 文档质量 14/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

10/20

维护活跃度

10/20

文档质量

14/20

安装易用性

13/20

查看各项评分依据

可靠性 8/20: README 描述了 1 个 travel 路由工具外加 66 个兼容别名，manifest 提供了 OCI 与 npm 两种分发方式，架构设计（并发多源抓取、类型化失败状态）看似合理。但静态审查拿不到任何已提交的测试文件或 CI 工作流内容——README 中‘测试代码多于源码’、‘发布前冒烟门’等说法属于不可信的自述证据；且服务依赖抓取 Google Flights、铁路等第三方端点，这些端点有机器人防护和限流，本质上结果易波动。扣分原因：缺乏可验证的执行证据、第三方抓取的固有脆弱性、未提供测试文件。因此按保守原则给 8 分。
安全与权限 10/20: README 显著披露了启动时自动读取浏览器 Cookie（可用 TRVL_NO_BROWSER_COOKIES=1 关闭）、每日匿名心跳（含随机安装 ID，IP 对收集端可见，可用多个开关关闭）、本地状态存于 ~/.trvl 且采用临时文件+重命名原子写入、可选凭据默认仅从环境变量读取（AF-KLM 例外，需显式 --provider afklm 才可能访问钥匙串）、无预订/付款等破坏性默认操作。未触发红线：没有隐蔽外传、没有不可逆的破坏性默认、安装示例中无真实令牌。扣分：Cookie 读取范围宽且无需逐次确认；同一主机 https→http 降级时 Cookie 会随明文发送（README 已坦诚披露但仍属弱点）；遥测请求会暴露客户端 IP。符合锚点 10：主要风险可见，但权限/确认/范围界定不完整。
维护活跃度 10/20: 版本号 1.21.0、README 引用 CI/发布/下载徽章、19 个未关闭 issue、仓库未归档，整体看起来活跃。扣分：仓库元数据许可证为 NOASSERTION，与 README 声称的 PolyForm 非商业 1.0 不一致，存在治理歧义；未提及任何安全响应渠道（如 SECURITY.md）；提交频率与依赖更新节奏无法从现有静态材料核实。符合锚点 10：活跃但存在治理/版本化缺口。
文档质量 14/20: README 本身分层充分：安装方式、隐私与遥测说明、Cookie 读取机制、故障排查、示例提示词、可选密钥对照表、限制披露（限流、空结果、禁用 Cookie 的代价、许可证使用边界）、远程 HTTP/OAuth 文档链接。扣分：引用的 docs/CLI.md、PROVIDERS.md、ARCHITECTURE.md、MCP-TOOLS-REFERENCE.md 等文档未随材料提供，无法核验其内容；仓库许可证元数据与 README 自述矛盾；具体工具参数说明不在提供的材料中。综合给 14 分。
安装易用性 13/20: 提供了多种安装路径（Homebrew tap、curl 二进制、Go install、Docker、npm/npx、源码构建）、`trvl mcp install` 自动检测 10 种客户端、Claude/Cursor 等手动 JSON 配置示例、VS Code/Cursor 一键安装深链，步骤清晰且覆盖主流平台。扣分：静态校准将 setup 上限设为 15 且这里没有可验证的已提交执行证据；`trvl mcp install` 自动检测机制无法核实；macOS 首次启动读 Cookie 会弹 Keychain 提示，可能影响安装体验；给出的材料中没有 Windows 专属步骤。给 13 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么写入 / 删除本地文件访问网络控制浏览器

适合谁

经常使用 AI 助手规划旅行的个人用户。
希望将旅行搜索集成到应用中的开发者，无需付费 API。
需要无 API 密钥且注重隐私的本地工具的用户。

不适合谁

希望简单在网站上预订的用户（建议使用 Google Flights 等）。
需要托管服务、仪表盘和客户支持的用户。
需要商业或内部使用的用户，因为 PolyForm 非商业许可证限制此用途。

所需权限

读取浏览器 cookie（自动，用于访问受保护的 API）
访问本地文件系统（读写 ~/.trvl 下的状态文件）
发送遥测数据（匿名，可关闭）
可选：读取凭证管理器（仅限 AFKLM，需显式请求）
可选：写入 Google 日历（通过日历助手）

风险与副作用

自动访问某些供应商的网站可能违反其服务条款，用户需自行承担风险。
读取浏览器 cookie 可能引发隐私担忧；默认启用，但可通过环境变量禁用。
遥测数据会发送匿名使用信息，但可关闭。
价格信息可能不准确或过期，建议验证后再做决策。

安装接入

准备工作

运行环境：预编译二进制 · Go · Docker · Node.js

AFKLM_KEY 可选密钥 AF-KLM 原生往返和 rail+fly 票价的可选密钥，需自行申请。

AFKL_KLM_COOKIES 可选密钥 AF-KLM Flying Blue 里程搜索用的可选 cookies；在显式 `--provider afklm` 下也可从 macOS Keychain 或 1Password 读取。

SERPAPI_KEY 可选密钥启用经核实的酒店 provider 价格（`trvl serpapi`），在 serpapi.com 获取。

TRAVELPAYOUTS_TOKEN 可选密钥启用历史价格趋势，在 Travelpayouts 获取。

TRANSAVIA_API_KEY 可选密钥启用 Transavia 航班，向 Transavia 申请。

DISTRIBUSION_API_KEY 可选密钥启用巴士和长途汽车地面段，向 Distribusion 申请。

FOURSQUARE_API_KEY 可选密钥启用附近地点查询，在 Foursquare 开发者平台获取。

GEOAPIFY_API_KEY 可选密钥启用目的地地理数据，在 geoapify.com 获取。

OPENTRIPMAP_API_KEY 可选密钥启用景点数据，在 opentripmap.com 获取。

TICKETMASTER_API_KEY 可选密钥启用活动查询，在 Ticketmaster 开发者平台获取。

TRVL_GMAIL_APP_PASSWORD 可选密钥通过 Gmail 邮寄行程摘要所需的应用专用密码，在 Google 账号安全设置中生成。

其他可选配置项（10 个）

TRVL_NO_TELEMETRY 可选设为 1 可关闭每日匿名心跳遥测。

NO_TELEMETRY 可选通用约定的遥测关闭开关，设为 1 生效。

DO_NOT_TRACK 可选跨工具 Do-Not-Track 信号，设为 1 关闭遥测。

TRVL_TELEMETRY_ENDPOINT 可选覆盖遥测心跳的目标端点，适合自建收集器。

TRVL_NO_BROWSER_COOKIES 可选设为 1 时绝不读取浏览器 cookie，也不在真实浏览器中开窗口；会损失部分受 bot 保护站点的结果。

TRVL_NO_TIER2_CDP 可选设为 1 时绝不启动自己的无头浏览器；同样会损失部分结果。

TRVL_WATCH_MAX_POINTS_PER_WATCH 可选每个价格监控保留的最大历史点数，默认 1000，可调。

TRVL_WATCH_MAX_POINTS_TOTAL 可选所有价格监控共享的历史点数总上限，默认 50000；设为 0 将拒绝启动。

TRVL_WATCH_ROUTE_TTL_DAYS 可选无日期路线监控的存活天数，默认 90，过期后不再每30分钟重查。

TRVL_STEALTH_ALLOWLIST 可选 `--stealth` 模式允许激活 Chrome HTTP/2 指纹传输的主机白名单，如 `.google.com`；为空则永不激活。

通过 Homebrew 安装：brew install MikkoParkkola/tap/trvl 或直接下载二进制文件。
运行 trvl mcp install 自动检测并配置 AI 客户端。
重启 AI 客户端。
或者，手动添加 MCP 配置：

{
  "mcpServers": {
    "trvl": {
      "command": "trvl",
      "args": ["mcp"]
    }
  }
}

claude_desktop_config.json

{"mcpServers":{"trvl":{"command":"trvl","args":["mcp"]}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "trvl": {
      "command": "trvl",
      "args": [
        "mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add trvl -- trvl mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

安装后重启 AI 客户端，在工具列表中应看到名为 travel 的单一工具；也可以运行 `trvl status` 查看各 provider 的成功率与健康状态，或用 `trvl flights HEL LHR 2026-07-01` 验证能返回真实航班结果。

常见排障

没有工具显示？重启 AI 客户端，并确认 `trvl` 在你的 PATH 中。
航班结果为空？尝试测试主要航线如 `trvl flights HEL LHR 2026-07-01`。
地面交通超时？可能被限流，等待 30 秒或使用 `--timeout 3m`。
被阻止？使用 `trvl status` 检查提供商状态，并查看提供的提示。
如果遇到 cookie 相关错误，设置 `TRVL_NO_BROWSER_COOKIES=1` 禁用浏览器 cookie 读取。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

帮我找7月1日到5日长周末从赫尔辛基出发最便宜的现实的行程，只要直飞，酒店在市中心附近。
比较8月15日 HEL→LHR 公务舱的里程甜点，用8万 Amex MR 加2万 Virgin 积分。
给 HEL→BCN 创建一个7月1日至8日的错误票价监控，低于90欧元时提醒我。
我有300欧元和一个空闲周末，给我一个惊喜行程。

工具能力 1

travel 只读

一个自然语言路由器，可处理航班、酒店、火车、汽车、渡轮等搜索，并返回优化后的结果。

使用场景

让 AI 助手规划真实的多模式旅行，包括航班、酒店、火车和汽车。

比较机票价格，寻找最便宜的出行日期。

监控价格并设置提醒，例如错误票价或低价警报。

搜索酒店、查看房间详情和价格。

查找火车、巴士和渡轮时刻及票价。

发现旅行技巧，如隐藏城市机票、多程优化等。

支持客户端

Claude Desktop

Claude Code

Cursor

Windsurf

Codex

VS Code

Zed

Gemini

Amazon Q

LM Studio

依据项目文档列出，未经本站实测。

详细介绍

trvl 是一个开源的旅行 MCP 服务器，允许 AI 助手（如 Claude、Cursor、Windsurf、Codex 等）直接搜索真实的旅行信息，包括航班、酒店、火车、巴士、渡轮、租车和价格提醒。它只有一个智能工具（travel 路由器），通过并行访问多个旅行数据源（如 Google Flights、Google Hotels、Kiwi 等）来提供综合搜索、优化和建议。无需 API 密钥，无需注册。它是本地运行的工具，数据保留在本地，但会读取浏览器 cookie 来访问受保护的站点。