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 — 2～3件の航路を並べて比較します。日程、港、価格と 1泊あたりの価格、6か月平均に対する価格の評価、船齢とサイズ、 家族向けかどうか、評価、CDC スコアを確認できます。必須：ids。
• getPriceHistory — 1件の航路の現在の運賃を過去6か月の履歴と比較し、 評価と値下がりフラグを返します。必須：id。
• getPriceDrops — 現在の値下がり幅が大きいものを返します。 任意：limit（1～10）。
• getCabinDetail — 船名と客室番号を指定して、特定の客室を検索します。 デッキ、位置、カテゴリー、既知の問題、乗客のコメントを確認できます。 必須：ship、cabin。
• getShipCabins — 船の客室をタイプ別にまとめ、カテゴリー、数、 広さの範囲を返します。必須：ship。
• getShipProfile — 船の情報を返します。建造年と改装年、サイズ、 乗客数と乗組員数、評価、施設、編集記事を確認できます。 必須：ship。
• getCruiseLineProfile — クルーズ会社の情報を返します。どのような乗客に 向いているか、旅行者タイプ別の評価、グレード、保有船数を確認できます。 必須：line。
• getDressCode — クルーズ会社の服装規定を返します。昼間と夜間の規則、 フォーマルナイト、施設ごとの規則を確認できます。 必須：line。
• getPortGuide — クルーズ港のガイドを返します。アクティビティ、ビーチ、 ショッピング、ターミナル、安全性、Wi-Fi、レンタカーを確認できます。 必須：port。
• getPortExcursions — ある港で予約できる寄港地観光とデイパスを、 価格、所要時間、評価とともに返します。 必須：port。任意：activity、minPrice、 maxPrice。
• getSailingExcursions — 1回の呼び出しで、ある航路のすべての寄港地の 寄港地観光を、旅程順に返します。sailingId、または ship と date を指定します。任意： activity、minPrice、maxPrice。
• getBestTimeToVisit — 港、地域、または目的地の月ごとの気温と 降水量に加え、最も暖かい月と最も乾燥した月を返します。 必須：place。
• getDrinkPackages — クルーズ会社ごとのドリンクパッケージの詳細を返します。 パッケージ名、ドリンク1杯あたりの上限額、1日の上限、チップを確認できます。 任意：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 リクエストを送信します。上流サーバーが initialize への応答で Mcp-Session-Id ヘッダーを返した場合、 その値はセッションの以降のすべてのリクエストに付与され、 プロセスが終了するまで再利用されます。応答は 通常の JSON またはサーバー送信イベントとして届く場合があり、 どちらも読み取られます。

成功した上流サーバーの結果は、上流サーバーが設定した isError フラグも含め、そのまま返されます。 失敗（JSON-RPC エラー、2xx 以外のステータス、 読み取り不能な応答、または完了できないリクエスト）は、 テキストが cruisescope error: で始まる isError 結果として返されます（この形式は、この再構築版独自のラベル付き表現です）。

CLI

各ツールはサブコマンドとしても利用でき、JSON 引数文字列を 1 つ受け取ります（引数が不要なツールでは省略します）。

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 を参照してください。