hotelbooking-ai

RollingGo Hotel MCP — ホテル検索・予約

🏠 キーを申請 · 🚀 クイックスタート · 📚 使用例 · 💬 サポート · 🔍 Q&A · 💰RollingGoで収益を得る

これは、AI エージェントが世界中の200万軒以上のホテルを検索、比較、予約できるようにする公式 MCP サーバーです。このサーバーは、AI による旅行のおすすめと実際の予約の間をつなぎます。

• トランスポートプロトコル：streamable-http
• 料金：完全無料、利用制限なし
• 利用方法：このドキュメントに従ったセルフサービス方式です。迅速なプロトタイピングやツール開発に適しています。

RollingGo MCP では、getHotelSearchTags、searchHotels、getHotelDetail、hotelPriceConfirm、searchHotelOrders など、7つのツールを提供する OAuth 2.0 認可コードフローも利用できます。このモードは、エンタープライズ向けの本番アプリケーションとの高度な統合を想定しており、[email protected] へのお問い合わせが必要です。

🌟 RollingGo Hotel MCP が選ばれる理由

従来の AI エージェントは、静的なトレーニングデータセットに基づいてホテルをおすすめすることしかできません。RollingGo Hotel MCP により、LLM エージェントはリアルタイムの取引機能を直接利用できます。

✅ 最新料金と予約可能な在庫 — 遅延なく料金を確認でき、すべての検索結果をすぐに予約できます。

✅ サプライチェーン — エンドツーエンドで完全に API ネイティブです。

✅ グローバルなホテルネットワーク — 200万軒以上の施設が200以上の国・地域を網羅しています。高級チェーンから地域密着型のブティックホテルまで、あらゆる層をカバーする500社以上のサプライヤーと連携しています。

✅ 直接契約 — 11万軒以上のホテルと直接接続し、料金と在庫をリアルタイムで同期しています。

✅ 仕入れ元での価格優位性 — OTAより上流の価格設定により、人気エリアで魅力的な料金を提供します。

✅ エージェント対応 — Cursor、Claude Code、Codex、Windsurf、Copilot など、40以上の主要なエージェントで利用できます。

✅ MCP の呼び出しごとに収益を獲得 — 国ごとのマークアップを設定し、予約成立ごとにコミッションを獲得できます。注文、収益、支払い状況をリアルタイムで確認できます。法人と個人開発者のどちらも、柔軟に出金できます。

🎯 対象ユーザー

• AI エージェントを構築する企業または個人開発者

• MCP クライアントにホテル予約機能を統合したい開発者

• 旅行計画、出張管理、OTA、ライフスタイルサービス向けのエージェントを構築する開発者

• AI エージェントの商取引ワークフローを検証したいプロダクトチーム

• ホテル検索、料金比較、値下がり通知を必要とする個人******

🎯 ユースケース

• 汎用エージェント：あらゆる AI エージェントにネイティブなホテル予約機能を追加できます。ユーザーは自然言語での会話だけで、比較、絞り込み、予約をすべて行えます。
• AI 旅行プランナー：自然言語で作成する旅程に、ホテル検索を直接統合できます。
• 法人向け出張アシスタント：従業員が Slack、Teams、またはカスタムチャットインターフェース内で、出張の検索、比較、予約を行えるようにします。
• 取引デモ：大規模なバックエンド統合を行わずに、AI エージェントによる商取引と決済のフローをエンドツーエンドで検証できます。

🚀 クイックスタート

コーディング不要で、5 分以内にグローバルなホテル検索と予約を AI アシスタントに統合できます。

ステップ 1：開発者 API キーを取得する

1. パートナーセンターにアクセスし、無料キーを登録します。
2. 次の情報が記載されたメールが届きます：B2B パートナーセンターダッシュボードの認証情報（注文の確認、マークアップの設定、収益の追跡に使用します）。

ステップ 2：エージェントに接続する

推奨クライアント：Claude CLI、Codex、Cursor。Kiro、Doubao など、その他の MCP 対応クライアントも同様に設定できます。

Claude CLI

プロジェクトのルートに .mcp.json を作成します：

{
  "mcpServers": {
    "Rollinggo-Hotel": {
      "url": "https://mcp.rollinggo.ai/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

または、コマンドラインから直接追加します：

claude mcp add \
  --transport http \
  --header "Authorization: Bearer YOUR_API_KEY" \
  Dida-Hotel \
  https://mcp.rollinggo.ai/mcp

Codex

設定ファイルの場所：プロジェクトのルートにある .codex/config.json、またはグローバル設定の ~/.codex/config.json

{
  "mcpServers": {
    "Rollinggo-Hotel": {
      "url": "https://mcp.rollinggo.ai/mcp",
      "type": "streamable-http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor

設定ファイルの場所：プロジェクトのルートにある .cursor/mcp.json、またはグローバル設定の ~/.cursor/mcp.json

{
  "mcpServers": {
    "Rollinggo-Hotel": {
      "url": "https://mcp.rollinggo.ai/mcp",
      "type": "streamable-http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

YOUR_API_KEY を実際の API キーに置き換えてください。

cURL で直接テストする

注：cURL には -H "Accept: application/json, text/event-stream" を含める必要があります。含めない場合、サーバーは 400 エラーを返します。

curl -X POST https://mcp.rollinggo.ai/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "searchHotels",
      "arguments": {
        "originQuery": "Shanghai Bund five-star hotel",
        "place": "Shanghai Bund",
        "placeType": "Attraction",
        "checkInParam": {
          "checkInDate": "2026-06-01",
          "stayNights": 2
        },
        "filterOptions": {
          "starRatings": [5.0]
        },
        "size": 3
      }
    },
    "id": 1
  }'

ステップ 3：最初の MCP 呼び出し

設定が完了したら、AI アシスタントに次のように伝えるだけです：

「あさってから宿泊できる、上海の外灘近くにある五つ星ホテルを探してください。」

AI は自動的に searchHotels ツールを呼び出し、ホテルの一覧を返します。

ホテル検索の例

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "searchHotels",
    "arguments": {
      "originQuery": "Shanghai Bund five-star hotel",
      "place": "Shanghai Bund",
      "placeType": "Attraction",
      "checkInParam": {
        "checkInDate": "2026-06-01",
        "stayNights": 2
      },
      "filterOptions": {
        "starRatings": [5.0]
      },
      "size": 3
    }
  },
  "id": 1
}

ステップ 4：結果とサンプルデータを確認する

ホテル検索結果（実データ）

「上海の外灘にある五つ星ホテル」を検索すると、2 泊の場合、次の結果が返されます：

予想されるレスポンス JSON の例

{
  "message": "Hotel search successful",
  "hotelInformationList": [
    {
      "hotelId": 29529,
      "bookingUrl": "https://rollinggo.ai/pages/hotel/detail/index?...",
      "name": "Fairmont Peace Hotel on the Bund",
      "address": "No. 20 Nanjing East Road",
      "starRating": 5.0,
      "price": {
        "message": "Price query successful. Lowest price: 648, Currency: USD",
        "hasPrice": true,
        "currency": "USD",
        "lowestPrice": 648.0
      },
      "hotelAmenities": ["Bar", "Gym", "Pool", "SPA", "Parking", "WIFI"],
      "tags": ["SPA Service", "Resort Hotel", "Sports-Friendly Hotel"]
    }
  ]
}

🔧 利用可能なツール

公式ドキュメント｜RollingGo MCP ツール

サーバーは、検索から予約までの一連の流れに対応する 3 つのコアツールを登録します：

1) searchHotels

場所、日付、価格、星評価、タグでホテルを検索します。

• 入力パラメーター：
  • originQuery (string、必須)：ユーザーからの自然文によるリクエスト（例：「東京で200ドル未満のブティックホテルを探してください」）。
  • place (string、必須)：目的地、観光スポット、空港の具体的な名称。
  • placeType (string、必須)：場所の種類（city、airport、point_of_interest、hotel など）。対応している値：city、airport、point_of_interest、train_station、subway_station、hotel、district/county、detailed address。
  • countryCode (string、任意)：ISO 3166-1 alpha-2 国コード（例：CN、US）。
  • size (number、任意、デフォルト：5)：返すホテルの数（最大 20）。
  • checkInParam (object、任意)：チェックイン関連のパラメーター。
  • filterOptions (object、任意)：フィルターパラメーター。
  • hotelTags (object、任意)：タグ／ブランド／予算のフィルター。

{
  "message": "Hotel search succeeded",
  "hotelInformationList": [
    {
      "hotelId": 43615,
      "bookingUrl": "https://rollinggo.ai/pages/hotel/detail/index?...",
      "name": "Sunworld Dynasty Hotel Beijing",
      "brand": null,
      "address": "50 Wangfujing Street",
      "destinationId": "6140156",
      "latitude": 39.917748,
      "longitude": 116.412249,
      "distanceInMeters": 205,
      "starRating": 5.0,
      "price": {
        "message": "Price found, lowest: 626.0, currency: CNY",
        "hasPrice": true,
        "currency": "CNY",
        "lowestPrice": 626.0
      },
      "areaCode": "CN",
      "description": "...",
      "imageUrl": "https://image-cdn.RollingGo.com/...",
      "hotelAmenities": ["24h Front Desk", "WiFi"],
      "score": 1.0,
      "tags": ["Near Shopping Mall", "Free WiFi"]
    }
  ]
}

2) getHotelDetail

選択したホテルの客室タイプ、変動料金、在庫状況、キャンセルポリシーをリアルタイムで取得します。

• 入力パラメーター：
  • hotelId (number、任意)：ホテル ID。name とは相互排他的です。両方が指定された場合は、hotelId が優先されます。
  • name (string、任意)：ホテル名（あいまい検索）。
  • dateParam (object、任意)：チェックイン／チェックアウトの日付パラメーター。
  • occupancyParam (object、任意)：宿泊人数と客室数のパラメーター。
  • localeParam (object、任意)：国と通貨のパラメーター。

{
  "success": true,
  "errorMessage": null,
  "hotelId": 43615,
  "bookingUrl": "https://rollinggo.ai/pages/hotel/detail/index?...",
  "name": "Sunworld Dynasty Hotel Beijing",
  "checkIn": "2026-03-05",
  "checkOut": "2026-03-06",
  "roomRatePlans": [
    {
      "roomTypeId": 4984714,
      "roomName": "Superior Room",
      "roomNameCn": "高级客房",
      "ratePlanId": "7012072001634754626",
      "ratePlanName": "Superior Room King Bed, 1 King Bed",
      "bedType": 73,
      "bedTypeDescription": "Unknown",
      "currency": "CNY",
      "totalPrice": 0,
      "totalSalesRate": null,
      "inventoryCount": null,
      "isOnRequest": null,
      "recommendIndex": null,
      "cancellationPolicies": [
        {
          "fromDate": "2026-03-02T10:00:00+08:00",
          "toDate": null,
          "amount": 634,
          "percent": null,
          "type": null,
          "description": null
        }
      ],
      "includedFees": null,
      "excludedFees": null,
      "metadata": null
    }
  ]
}

3) getHotelSearchTags

検索フィルターの絞り込みに使用できるすべてのタグ名（例：「無料 Wi-Fi」「ジム」「子ども向け」）を含むメタデータを取得します。ローカルキャッシュやクライアント側のインテントマッピングに適しています。

{
  "tags": [
    {
      "name": "Free WiFi",
      "category": "Core Amenities",
      "description": "Provides free WiFi"
    }
  ],
  "usageGuide": {
    "tagUsage": "Place tag names into hotelTags.preferredTags (preference), requiredTags (hard requirement), or excludedTags (exclusion)",
    "exampleRequest": "{...}"
  }
}

📚 使用例

{
  "originQuery": "Find 4-star+ hotels in Beijing for 2 nights",
  "place": "Beijing",
  "placeType": "city",
  "checkInParam": {
    "checkInDate": "2026-03-01",
    "stayNights": 2
  },
  "filterOptions": {
    "starRatings": [4.0, 5.0]
  },
  "size": 5
}

{
  "originQuery": "Find quality hotels in Beijing with free WiFi, budget under 1000 per night",
  "place": "Beijing",
  "placeType": "city",
  "hotelTags": {
    "requiredTags": ["Free WiFi"],
    "maxPricePerNight": 1000
  },
  "size": 5
}

{
  "hotelId": 43615,
  "dateParam": {
    "checkInDate": "2026-03-05",
    "checkOutDate": "2026-03-06"
  },
  "occupancyParam": {
    "adultCount": 2,
    "roomCount": 1
  },
  "localeParam": {
    "currency": "CNY",
    "countryCode": "CN"
  }
}

💬 Q&A

🔍トラブルシューティングガイド

-H "Accept: application/json, text/event-stream"

💬 サポート

• 📧 メール：[email protected]
• 🐛 Issue：GitHub Issues から不具合や機能リクエストを送信してください。
• 💬 Discord コミュニティ：Discord サーバーに参加するか、以下の QR コードをスキャンして、ほかの開発者とつながり、インテグレーションについて話し合い、RollingGo チームからリアルタイムのサポートを受けてください。

🌟 RollingGo Hotel MCP（OAuth）v2.3 メジャーアップデート

v2.3 では注文照会の構造を最適化し、注文詳細フィールドを複数追加しました。これにより、エージェントがチェックイン、支払い、キャンセルのシナリオに適切に対応できるようになります。注：このアップデートは OAuth 連携版のみが対象で、ここに記載されている API Key 版には適用されません。OAuth 版の利用には、[email protected] へのお問い合わせによるビジネス導入が必要です。

付録

🔣 ローカル環境にデプロイする場合

方法 A：uv で実行（推奨 — 設定不要）

uv がインストールされている場合は、次のコマンドを実行するとすぐにサーバーを起動できます。

uv run --with-requirements requirements.txt server.py

方法 B：標準的な Python セットアップ

# Clone the repository
git clone https://github.com/DIDA-AI/dida_hotel_mcp_global.git
cd dida_hotel_mcp_global

# Setup virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies and run
pip install -r requirements.txt
python server.py

ローカルサーバーは http://localhost:8000/mcp で実行され、リクエストはセキュアな RollingGo グローバル API ノードに自動転送されます。

🔑 セキュリティとヘッダー

• ローカルサーバーはリクエストをセキュアな DIDA グローバル API に転送します。
• API キーは必ずヘッダーに指定してください。キーは mcp_ で始まる必要があります。
• 必須ヘッダー：Authorization: Bearer mcp_your_key_here

📜 ライセンス

このプロジェクトは MIT ライセンスのもとでライセンスされています。詳細については LICENSE ファイルをご覧ください。

RollingGo チームが ❤️ を込めて作成