viator-mcp

viator-mcp

适用于 Viator Partner API（v2）的 MCP 服务，可供 Claude 搜索旅游团、活动和体验。通过结构化筛选条件或自由文本搜索目录，获取产品详情和可用时间表，浏览景点和目的地，所有操作均通过 stdio 完成。

由 AI（Claude Code）开发和维护。请自行决定是否使用。

快速开始

{
  "mcpServers": {
    "viator": {
      "command": "npx",
      "args": ["-y", "@chrischall/viator-mcp"],
      "env": { "VIATOR_API_KEY": "your-viator-partner-api-key" }
    }
  }
}

在 partnerresources.viator.com 注册成为 Viator 联盟营销伙伴，即可获取密钥——Basic Access 层级免费。本服务面向该层级：仅支持只读搜索、内容和可用性查询；不提供预订端点（产品结果会包含 productUrl，指向 viator.com 上带有你的联盟营销 ID 的预订页面）。

工具

区域	工具
产品	vt_search_products、vt_get_product、vt_list_product_tags
搜索	vt_search_freetext
景点	vt_search_attractions、vt_get_attraction
可用性	vt_get_availability_schedule
参考数据	vt_list_destinations、vt_get_locations、vt_get_exchange_rates
健康检查	vt_healthcheck — 此连接器是否正常工作？报告是否已解析 VIATOR_API_KEY、Viator 是否接受了该密钥，以及需要修复的内容。其他工具失败时，请从这里开始排查：结果为空可能表示“没有产品”，也可能表示“从未通过身份验证”。

所有工具均为只读。vt_search_products 和 vt_search_freetext 支持设置 compact: true，返回精简摘要（代码、标题、价格、评分、预订 URL），而非完整记录。

环境变量

变量	必填	说明
VIATOR_API_KEY	是	Viator Partner API 密钥（通过 exp-api-key 发送）
VIATOR_API_BASE_URL	否	API 主机（默认使用生产环境；沙盒密钥请设置为 https://api.sandbox.viator.com/partner）
VIATOR_LANGUAGE	否	响应文本的 Accept-Language（默认值为 en-US）
VIATOR_CACHE_TTL	否	相同读取请求的缓存秒数（默认值为 60；设为 0 可禁用）
VIATOR_STATIC_CACHE_TTL	否	参考数据的缓存秒数，包括目的地、标签、地点和汇率（默认值为 3600）

Viator 会按端点在滚动的 10 秒窗口内实施速率限制，并通过 Retry-After 返回 429/503 响应；客户端会遵循该值重试一次，响应缓存则会处理重复的相同调用。

开发

npm install
npm test          # vitest; no real network calls
npm run build     # tsc + esbuild bundle

本服务所针对的 API 范围固定于 docs/VIATOR-API.md。

许可证

MIT