Cruise Itinerary

面向 Claude、ChatGPT 和其他 MCP 客户端的 Cruise Itinerary

向 AI 助手询问邮轮信息，即可获取真实数据：哪些航次会停靠某个港口、某艘邮轮每天的行程如何、某个航次的票价每周如何变化、每月有多少邮轮运力抵达某个港口，以及邮轮价格总体呈现怎样的趋势。

此代码仓库包含：

• Cruise Itinerary 远程 MCP 服务的连接详情，地址为 https://cruise-itinerary.com/mcp，
• 一个 Claude 插件，可添加该服务和 cruise-research 技能，帮助 Claude 了解数据的注意事项，
• server.json，即该服务在官方 MCP Registry 中的条目。

该服务由 Cruise Itinerary（Agile Travel Group, Inc.，以 Cruiseable 名义运营）运行。数据与其 REST API 相同：API 文档、MCP 文档。

你可以询问什么

• “2027 年 7 月有哪些航次停靠 Juneau？按阳台房价格从低到高排列。”
• “显示该航次每天的行程。”
• “自 9 月以来，该航次的票价是涨了还是跌了？”
• “明年冬天每个月有多少邮轮泊位运力抵达 Cozumel？”
• “邮轮价格指数显示本月票价如何？”

工具

所有工具均为只读（readOnlyHint: true）。每个工具都会通过 structuredContent 返回与对应 REST 端点相同的 JSON，并附带一个 outputSchema。

工具	可回答的问题	最低套餐
resolve_entity	将港口、邮轮或邮轮公司名称（无论拼写如何）解析为其他工具所需的 ID	免费
cruise_price_index	每周邮轮价格指数：最近 12 周（免费），或按邮轮公司、舱房和细分市场查看完整序列（Business）	免费 / Business
search_sailings	按邮轮、邮轮公司、港口、出发港、区域、日期、航程长度和票价搜索即将出发的航次，并显示最新的每周票价	Developer（免费：每月 10 次试用调用）
get_itinerary	某个航次按日期排列的每日行程，或某次邮轮行程的停靠港列表	Developer（免费：每月 10 次试用调用）
get_price_history	某个航次的所有每周票价快照	Business（免费：10 次试用调用）
port_month_capacity	某个港口每月的邮轮停靠天数、不同邮轮数量和泊位数	Business

免费账户（仅需电子邮件地址，无需信用卡）每月包含 500 次调用。每次成功的工具调用均计为一次 API 调用。如果某工具超出你的套餐限制，它会返回一条简短消息、一个指向定价页面的链接；如果该调用指定了航次或邮轮行程，还会提供一个指向 Cruiseable 免费页面的链接。

设置

Claude（claude.ai、桌面端、移动端）

将其添加为连接器：Customize → Connectors → Add custom connector，将其命名为 Cruise Itinerary，并粘贴 https://cruise-itinerary.com/mcp。Claude 会检测到 OAuth 登录，并在添加时提示你登录：输入电子邮件地址，打开我们发送的链接，然后批准连接。

如需同时获取 cruise-research 技能，请将此代码仓库安装为插件（见下文），或等它在 Claude 目录中上架后从该目录安装。

Claude Code

作为插件（服务和技能）安装：

/plugin marketplace add BigBalli/cruise-itinerary-mcp
/plugin install cruise-itinerary@cruise-itinerary

或仅安装服务：

claude mcp add --transport http cruise-itinerary https://cruise-itinerary.com/mcp

然后运行 /mcp 并选择 cruise-itinerary 登录。

ChatGPT

使用 URL https://cruise-itinerary.com/mcp 添加自定义应用（连接器），并启用 OAuth 身份验证。在该条目出现在 ChatGPT 目录之前，需要启用开发者模式。

Cursor、VS Code、Windsurf 和其他客户端

将客户端指向该 URL。支持 MCP OAuth 的客户端会在浏览器中登录：

{
  "mcpServers": {
    "cruise-itinerary": {
      "url": "https://cruise-itinerary.com/mcp"
    }
  }
}

不支持 OAuth 的客户端可以改为在标头中发送你从控制面板获取的 API 密钥。请勿将密钥放在共享文件中。

{
  "mcpServers": {
    "cruise-itinerary": {
      "url": "https://cruise-itinerary.com/mcp",
      "headers": { "Authorization": "Bearer <your API key>" }
    }
  }
}

登录方式

该服务遵循 MCP 授权规范：采用带 PKCE（S256）的 OAuth 2.1，在 https://cruise-itinerary.com/.well-known/oauth-protected-resource/mcp 提供受保护资源元数据，并在 https://cruise-itinerary.com 提供授权服务，支持客户端 ID 元数据文档和动态客户端注册。登录通过电子邮件链接完成；新地址可获得免费账户。你可以在同意页面上批准各个应用，该页面会显示请求授权的应用及其返回地址。访问令牌有效期为一小时，刷新令牌每次使用时都会轮换。连接时不会向应用共享你的 API 密钥、电子邮件地址或账单信息，应用只能读取数据。

每个请求都需要账户，包括 initialize：没有令牌时，服务会返回带有 WWW-Authenticate 标头的 401 响应，其中指向受保护资源元数据，客户端据此知道应开始登录。

正确读取数据

• 票价是每周快照，自 2026 年 9 月 6 日起每周一采集，并非实时或可预订的价格。meta.as_of 表示数据加载日期。
• 缺失的（null）票价表示该舱房未开放销售或已售罄；数据不会说明具体是哪种情况。
• 标记为 estimated 的行程日期，是根据港口间距离推算的，日期可能有一天偏差。标记为 exact 的日期，来自邮轮公司的已发布行程。
• 港口容量数据仅按月提供，泊位数表示船舶容量，而非乘客人数。
• 数据覆盖以北美邮轮公司为主。不覆盖 TUI Cruises/Marella、AIDA、Saga、Fred. Olsen 和 Hapag-Lloyd。

数据与隐私

此插件不包含任何会在你的计算机上运行的代码。它声明了一个远程 MCP 服务 https://cruise-itinerary.com/mcp，以及一个由说明组成的技能。当你的助手调用工具时，工具名称及其参数（港口、船舶或邮轮公司的名称、日期、ID）会连同你的访问令牌发送至 cruise-itinerary.com。这些信息用于响应调用、计入你的方案用量并执行速率限制。不会发送其他内容，也不会将任何内容发送到其他地方。

• 隐私政策：https://cruise-itinerary.com/privacy
• 条款：https://cruise-itinerary.com/terms
• 支持：[email protected]

许可证

MIT，详见 LICENSE。API 提供的数据受 Cruise Itinerary 条款约束，不受此许可证约束。