cruisescope

cruisescope

cruisescope 是一个小型本地桥接程序，用于连接 gangwaze 托管的 MCP 服务。该服务收录了邮轮航次目录：告诉它你想去哪里、何时出发以及 预算多少，目录就会返回符合条件的航次、票价，以及指向 gangwaze.com 完整结果的 链接。

该桥接程序不维护自己的目录。它会在本地提供上游服务的工具列表，内容与从实时 端点捕获的完全一致，并将每次工具调用转发至上游，原样返回结果。捕获到的全部 功能都只能读取数据——搜索航次、比较候选航次、查看票价历史和降价信息，以及查询客舱、邮轮、邮轮公司、港口、 岸上观光项目和饮料套餐；其中没有预订、 购买或支付工具。

工具

• searchCruises — 搜索即将启航的航次。所有筛选条件 均为可选：destination（顶级区域名称）、 regions、departurePorts、ports、startDate / endDate、nights（"lo:hi" 范围）、cruiselines、 ships、cabin（inside、oceanview、balcony、 suite）、price / pricePerNight（"lo:hi" 范围）、 safety、family、tripShape、shipYear、shipSize、 lineType、vibes 和 departureDays。结果按出发时间从近到远排序，每个航次都包含一个 id。
• compareSailings — 并排比较两到三个航次： 日期、港口、价格和每晚价格、相对于六个月平均价格的价格评估、 邮轮的船龄和大小、是否适合家庭、评分以及 CDC 评分。必填：ids。
• getPriceHistory — 根据某个航次六个月的票价历史，评估其当前票价， 并提供评估结果和降价标记。必填：id。
• getPriceDrops — 当前降价幅度最大的航次。 可选：limit（1-10）。
• getCabinDetail — 按邮轮和房间号查询一个特定客舱：甲板、位置、 类别、已知问题和乘客评论。必填：ship、cabin。
• getShipCabins — 按类型分组显示某艘邮轮的客舱，包括 类别、数量和面积范围。必填：ship。
• getShipProfile — 某艘邮轮的资料：建造和翻新年份、 大小、乘客和船员人数、评分、场所及编辑内容。 必填：ship。
• getCruiseLineProfile — 某家邮轮公司的资料：适合哪些人、 按旅客类型划分的评分、档次和船队规模。 必填：line。
• getDressCode — 某家邮轮公司的着装规范：白天和 晚间规定、正式之夜以及场所规定。 必填：line。
• getPortGuide — 邮轮港口指南：活动、海滩、购物、 码头、安全、wifi 和租车。 必填：port。
• getPortExcursions — 某个港口可预订的岸上观光项目和日间通行证， 包含价格、时长和评分。 必填：port。可选：activity、minPrice、 maxPrice。
• getSailingExcursions — 一次调用即可查询某个航次每个港口的观光项目， 并按行程顺序排列。传入 sailingId，或传入 ship 和 date。可选： activity、minPrice、maxPrice。
• getBestTimeToVisit — 按月显示某个港口、区域或目的地的气温和 降雨量，并列出最温暖和最干燥的月份。必填：place。
• getDrinkPackages — 按邮轮公司查询饮料套餐详情：名称、饮料最高价格、 每日限额和小费。可选：cruiseline（省略则查询所有邮轮公司）。

配置

• GANGWAZE_MCP_URL（可选）— 覆盖上游 端点。默认为 https://gangwaze.com/api/mcp。 （此覆盖钩子是本次重建中自行标注的 还原内容。）
• GANGWAZE_API_KEY（可选）— 设置后，每个 上游请求都会携带 X-Api-Key: <key> 标头 （以获得更高的速率限制）。未设置时，不会发送密钥 标头，访问为匿名。绝不会发送 Authorization 标头。（此转发功能同样是明确标注的还原内容； 原始功能界面是在不带密钥的情况下捕获的。）

转发机制

首次调用工具时，客户端会通过可流式传输的 HTTP 与上游建立会话：发送 JSON-RPC initialize 请求（protocolVersion 2025-03-26，clientInfo name cruisescope），随后发送 notifications/initialized 通知，再发送携带调用方原样参数的 tools/call 请求。 当上游通过 Mcp-Session-Id 标头响应 initialize 时，该值会随会话的后续每个请求一并发送， 并在进程的整个生命周期内复用。响应 可能是纯 JSON，也可能是服务器发送事件； 两种格式都会读取。

成功的上游结果会原样传递， 包括上游设置的任何 isError 标记。 失败情况——JSON-RPC 错误、非 2xx 状态、 无法读取的响应，或无法完成的请求—— 会作为 isError 结果返回，其文本以 cruisescope error: 开头（此呈现方式是本次重建自行添加的标注）。

CLI

每个工具也可作为子命令使用，并接受一个 JSON 参数 字符串（无需参数的工具可省略）：

npx @reneturcios/cruisescope searchCruises '{"destination":"Caribbean","nights":"7:7"}'
npx @reneturcios/cruisescope compareSailings '{"ids":["carnival-breeze:2026-09-21:5","carnival-breeze:2026-09-28:5"]}'
npx @reneturcios/cruisescope getPriceHistory '{"id":"carnival-breeze:2026-09-21:5"}'
npx @reneturcios/cruisescope getPriceDrops '{"limit":5}'
npx @reneturcios/cruisescope getPortGuide '{"port":"Cozumel"}'
npx @reneturcios/cruisescope --version

退出代码：成功时为 0，结果为 isError 时为 1， 用法错误时为 2。

MCP 服务

npx -y @reneturcios/cruisescope mcp

MCP 客户端配置：

{
  "mcpServers": {
    "cruisescope": {
      "command": "npx",
      "args": ["-y", "@reneturcios/cruisescope", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/cruisescope
docker run --rm ghcr.io/cloudcorprecords/cruisescope --version

容器的默认命令是 mcp，因此第一种 形式是 stdio MCP 服务；其他参数会按常规方式传递给 CLI。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全使用桩接的 JSON-RPC 上游运行，不会发起实时网络调用。

许可证

MIT — 详见 LICENSE。