Cruise Itinerary

Claude、ChatGPT、その他の MCP クライアント向けクルーズ旅程

クルーズについて AI アシスタントに質問すると、実際のデータに基づいた回答が得られます。ある港に寄港するクルーズはどれか、船の旅程は日ごとにどうなっているか、クルーズ料金は週ごとにどう推移しているか、毎月どれだけの船舶定員が港に到着するか、クルーズ料金全体の傾向はどうなっているかなどを確認できます。

このリポジトリには、以下が含まれています。

• https://cruise-itinerary.com/mcp にある Cruise Itinerary リモート MCP サーバーの接続情報
• サーバーと、データの注意点を Claude に説明する cruise-research スキルを追加する Claude プラグイン
• MCP Registry 公式版に登録されたサーバーのエントリーである server.json

サーバーは Cruise Itinerary（Agile Travel Group, Inc.、Cruiseable として運営）によって運用されています。データは REST API と同じです。API ドキュメント、MCP ドキュメントをご覧ください。

質問できること

• 「2027 年 7 月に Juneau に寄港するクルーズのうち、バルコニー客室の料金が安いものから教えてください。」
• 「そのクルーズの旅程を日ごとに表示してください。」
• 「このクルーズの料金は 9 月以降、上がりましたか、それとも下がりましたか？」
• 「来冬、毎月 Cozumel に到着する船舶定員は何バースですか？」
• 「今月の料金について、Cruise Price Index は何を示していますか？」

ツール

すべてのツールは読み取り専用です（readOnlyHint: true）。各ツールは、対応する REST エンドポイントと同じ JSON を outputSchema を含む structuredContent として返します。

ツール	回答する内容	最低プラン
resolve_entity	表記にかかわらず、港、船、クルーズ会社の名前を他のツールが使用する ID に解決します	Free
cruise_price_index	週ごとの Cruise Price Index：最新 12 週間（Free）、またはクルーズ会社、客室、セグメント別の全期間データ（Business）	Free / Business
search_sailings	船、クルーズ会社、港、出発港、地域、日付、期間、料金で今後のクルーズを検索し、最新の週ごとの料金を表示します	Developer（Free：月 10 回までお試し利用可能）
get_itinerary	クルーズの日付付き日別旅程、またはクルーズの寄港地リストを取得します	Developer（Free：月 10 回までお試し利用可能）
get_price_history	1 つのクルーズについて、週ごとのすべての料金スナップショットを取得します	Business（Free：月 10 回までお試し利用可能）
port_month_capacity	ある港の月ごとの船舶日数、船数、バース数を取得します	Business

メールアドレスだけで登録できる無料アカウント（カード不要）では、月 500 回まで呼び出せます。ツール呼び出しが成功するたびに、API 呼び出し 1 回としてカウントされます。利用中のプランでは利用できないツールを呼び出すと、短いメッセージと料金プランへのリンクが表示されます。また、呼び出しでクルーズまたはクルーズ便が指定されている場合は、Cruiseable にある無料ページへのリンクも表示されます。

セットアップ

Claude（claude.ai、Desktop、モバイル）

コネクターとして追加します。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 にある保護対象リソースのメタデータ、Client ID Metadata Documents と動的クライアント登録に対応する https://cruise-itinerary.com の認可サーバーを利用します。サインインはメールリンクで行います。新しいメールアドレスで無料アカウントを作成できます。各アプリの承認は、どのアプリがアクセスを求めているか、どこに戻るかが表示される同意ページで行います。アクセストークンの有効期間は 1 時間で、更新トークンは使用のたびにローテーションされます。接続しても API キー、メールアドレス、請求情報がアプリと共有されることはなく、アプリは読み取りのみ可能です。

initialize を含め、すべてのリクエストでアカウントが必要です。トークンがない場合、サーバーは保護対象リソースのメタデータを示す WWW-Authenticate ヘッダーとともに 401 を返します。これにより、クライアントはサインインを開始する必要があると判断できます。

データを正しく読み取る

• 運賃は 2026 年 9 月 6 日以降、毎週月曜日に取得されたスナップショットであり、リアルタイムの価格や予約可能な価格ではありません。meta.as_of に読み込み日が記載されています。
• 運賃が欠落（null）している場合、その客室が提供されていなかったか、完売していたことを示します。データからはどちらか判断できません。
• estimated と記された旅程の日程は、港間の距離から算出されているため、1 日ずれる場合があります。exact の日程は、クルーズ会社が公開している旅程に基づいています。
• 港の受け入れ容量は月単位のみで、バース数は乗客数ではなく船の収容能力を表します。
• 北米のクルーズ会社のデータが最も充実しています。TUI Cruises/Marella、AIDA、Saga、Fred. Olsen、Hapag-Lloyd は対象外です。

データとプライバシー

このプラグインには、ユーザーのマシン上で実行されるコードは含まれていません。リモート MCP サーバー https://cruise-itinerary.com/mcp と、指示で構成されるスキルが 1 つ定義されています。アシスタントがツールを呼び出すと、ツール名とその引数（港、船、クルーズ会社の名前、日付、ID）がアクセス トークンとともに cruise-itinerary.com に送信されます。これらは呼び出しへの応答、プランの利用回数の計上、レート制限の適用に使用されます。それ以外の情報は送信されず、他の場所に送信されることもありません。

• プライバシーポリシー： https://cruise-itinerary.com/privacy
• 利用規約： https://cruise-itinerary.com/terms
• サポート： [email protected]

ライセンス

MIT。詳細は LICENSE をご覧ください。API が提供するデータには、このライセンスではなく Cruise Itinerary の利用規約が適用されます。