VoyageHacks

VoyageHacks MCP 服务

VoyageHacks.com 的官方 Model Context Protocol 服务。VoyageHacks.com 是一家旅游出版商，在 10 种语言中各提供约 680 篇经过事实核查的指南，涵盖航班、航空公司评测、酒店、目的地、租车、火车、机场接送、eSIM、旅行 VPN、旅行信用卡和旅行装备。

在线端点： https://voyagehacks.com/mcp 版本： 2.3.0 文档： https://voyagehacks.com/en/mcp-server/

无状态 Streamable HTTP 传输（通过 POST 发送 JSON-RPC 2.0、返回单个 JSON 响应、无 SSE、无会话），无需身份验证。任何 MCP 客户端都可以立即连接并调用工具。GET 请求会按设计返回 405：服务不提供 SSE 流，而 Streamable HTTP 规范要求在这种情况下提供 SSE 流。

已作为 com.voyagehacks/travel 列入官方 MCP 注册表。

连接

Claude Code

claude mcp add --transport http voyagehacks https://voyagehacks.com/mcp

**Claude.ai / Claude Desktop：**依次打开 Settings、Connectors、Add custom connector，输入 https://voyagehacks.com/mcp，身份验证选择 "No authentication"。

**ChatGPT：**打开 Settings、Connectors，添加 https://voyagehacks.com/mcp，无需身份验证。

Perplexity（Pro、Max、Enterprise）：依次打开 Settings、Connectors、Custom connector、Remote，输入 https://voyagehacks.com/mcp，身份验证选择 "None"。

**Gemini Enterprise：**使用 HTTPS 端点和 "No Authentication" 创建自定义 MCP 服务数据存储。传输协议为 StreamableHTTP，这是 Gemini Enterprise 所要求的。

MCP Inspector

npx @modelcontextprotocol/inspector

工具

全部十二个工具均为只读，标注为 readOnlyHint: true 和 destructiveHint: false，除了返回结果外不会产生任何副作用。每个工具都声明了 outputSchema，并在返回可读文本的同时提供 structuredContent。

工具	功能
search_articles	按语言全文搜索指南，可选择按章节筛选
get_article	以 Markdown 格式返回单篇文章，并提供从页面本身读取的标题、语言、章节、发布日期和最后更新日期
search_travel_gear	搜索 VoyageHacks 旅行装备目录，其中约有 320 款产品，精选自约 50 篇已发布的选购指南
recommend_travel_gear	根据行程描述生成打包清单，每个类别推荐一款产品，并支持可选的结构化提示
get_flight_links	获取指定航线和日期的航班搜索链接
get_hotel_links	获取指定城市、日期、宾客人数和房间数的酒店搜索链接
get_car_rental_links	获取汽车和踏板车租赁比价链接
get_airport_transfer_links	获取机场出租车和预订接送服务的链接
get_esim_links	获取目的地旅行 eSIM 商店链接
get_travel_vpn_links	获取旅行 VPN 链接
get_credit_card_links	获取 American Express Germany 和 Revolut 的官方页面，以及经过核实的德国费用数据（不含推荐链接）
get_booking_links	在一次调用中获取某趟行程的多个类别的预订链接，可通过 include 筛选
find_destination	根据月份、旅行类型、预算和同行人数推荐三个目的地，并提供指南、带日期的酒店和航班链接以及打包建议；如果缺少月份或旅行类型，则返回待确认的问题

get_hotel_links 也会通过 Expedia、Vrbo 和 Agoda（Stay22）返回相同的搜索结果。装备产品链接到 VoyageHacks 指南中评测该产品的页面卡片（productUrl、<guide>#p-<asin>），绝不直接链接到 Amazon：Amazon 的政策只允许在出版商自己的网站上使用带标签的链接。

聊天内行程查找器（MCP Apps）

find_destination 声明了一个 MCP Apps 视图 ui://voyagehacks/trip-finder.html（functions/_mcp-app.js）。支持渲染 MCP Apps 的宿主（Claude、ChatGPT、VS Code 等）会显示三张目的地卡片和一个测验，并通过宿主重新运行该工具。它会遵循宿主的浅色或深色主题，并通过 ui/open-link 打开链接。其他客户端会收到相同的文本答复。

提示词

where_to_go、plan_trip 和 pack_for_trip，供将 MCP 提示词显示为斜杠命令的客户端使用。

每个垂直领域工具还会以请求的语言返回最多 4 篇匹配的 VoyageHacks 指南，让 Agent 可以在引用链接的同时引用完整文章。

语言： en、de、fr、es、it、pl、cs、ja、nl、pt、zh。 每个工具都接受 lang 参数，默认值为 en。每种语言的指南都是独立编写的版本， 并非机器翻译。

配置

配置	端点	工具数
full（默认）	https://voyagehacks.com/mcp	13
research	https://voyagehacks.com/mcp?profile=research	11
guides	https://voyagehacks.com/mcp?profile=guides	5

research 配置不包含 get_travel_vpn_links 和 get_credit_card_links，因为这些工具的 链接会跳转到订阅注册页面和金融产品申请页面。此配置适用于其指南限制链接到 会发起订阅或购买的页面的应用目录。

guides 配置限制更多，不包含任何预订工具，仅保留 search_articles、get_article、search_travel_gear、 recommend_travel_gear 和 find_destination；其中 find_destination 返回目的地推荐、 指南和行李打包推荐，不含预订链接。其产品链接指向 VoyageHacks 指南，这些指南会在 Amazon 上销售 实体旅行用品，因此符合只允许实体商品交易的目录要求。它还提供自己的 initialize 指令， 介绍的是其实际提供的五种工具，而非全部十三种。

每种配置都支持两种访问方式：/mcp?profile=guides 和 /mcp/guides 指向 同一个处理程序。提供路径形式是因为 OpenAI 插件提交门户会拒绝 MCP Server URL 字段中的查询字符串。

如果指定的配置无法识别，无论使用哪种形式，都会回退到完整工具集，因此即使拼写错误， 也绝不会在不知情的情况下提供比预期更少的工具。

不支持的功能

该服务返回已发布的编辑内容和搜索链接。它不提供实时票价、实时房价、可用性查询、星级评分或评论数， 也无法预订或收款。

旅行用品目录是 VoyageHacks 自行编辑挑选的商品，并非对 Amazon 全部商品的搜索结果。它不提供价格、 评分、评论数或库存：此账户未启用 Amazon Product Advertising API，因此任何此类数值 都是编造的。工具绝不会返回这些字段。

限制

每个 IP 每分钟约 90 个请求；每个请求正文最大 256 KB；每个 JSON-RPC 批次最多 25 条消息；文章截断于 60,000 个字符。超过速率限制时，服务会返回 HTTP 429 和 Retry-After。请参阅 SECURITY.md。

面向 Agent 的 Markdown

整个网站都可供 Agent 读取，而不仅是此服务：

• get_article 以 Markdown 格式返回任意页面。
• 请求时附带 Accept: text/markdown 标头，voyagehacks.com 上的任意页面都会直接返回 Markdown （由边缘中间件处理，不影响浏览器）。
• 发现文件： /.well-known/mcp/server-card.json、 /llms.txt、 /.well-known/agent-skills/index.json、 /.well-known/api-catalog、 /auth.md。

透明度

VoyageHacks 是由联盟营销资助的内容发布商。这些工具返回的部分预订和购物链接是联盟链接（通过 CJ Affiliate 合作的 Booking.com 和其他广告商、Travelpayouts、Stay22）。工具输出中不会出现 Amazon 或推荐链接。用户通过符合条件的预订或购买，VoyageHacks 可能会获得佣金，用户无需额外付费。

每个商业工具都会在其 description 中说明这一点，每个商业响应也会在文本内容和 structuredContent.disclosure 中重复说明，以便助手向最终用户披露。工具的 name 和 title 值中不包含“affiliate”一词，因为 Agent 会根据这些字符串进行路由，而该词会显著降低工具被选中的概率；它应出现在说明和响应中，因为披露义务实际适用于这两处。

文章内容可免费阅读，无付费墙，也无需身份验证。

自托管

这是一个 Cloudflare Pages Function（functions/mcp.js）。要部署自己的实例：

1. 使用 Cloudflare Pages 项目部署 functions/ 目录。
2. 服务会从其所服务的网站实时读取内容：一个 Hugo 构建的网站会生成 /<lang>/index.json（搜索索引）和 /<lang>/gear.json（装备目录）。将 SITE 常量指向你的部署。
3. 将 mcp.js 顶部附近的联盟营销常量（Travelpayouts 标记、CJ ID、Stay22 aid）替换为你自己的项目 ID。find_destination 还会读取 /<lang>/trip-finder/ 中的行程查找器数据块，以及 assets/js/trip-match.mjs 中的共享匹配规则。

此代码仓库镜像了生产环境中的函数。唯一有意保留的差异是 htmlToMarkdown 的导入方式：生产环境从网站的 _middleware.js 导入 htmlToMarkdown，此镜像则从自己的 html-to-markdown.js 导入。若要派生此项目，请确保联盟营销常量与你自己的网站配置保持同步。

隐私、条款和支持

• 隐私政策：https://voyagehacks.com/en/privacy/
• 使用条款：https://voyagehacks.com/en/terms/
• 安全政策：SECURITY.md
• 支持和安全问题报告：[email protected]

许可证

MIT