bookdata

bookdata

bookdataは、ホスト型のHasData Booking MCP サーバーへの小規模なローカルブリッジで、Booking.comのデータを JSONとして返します。目的地のキーワード、チェックイン日と チェックアウト日、および宿泊人数（部屋数、大人、子ども）を指定すると、その場所で利用可能な宿泊施設を検索します。同じ日程で 1件の施設のBooking.com URLを指定すると、その施設の詳細情報（名称と 住所、ポリシー、料金、評価とレビュー、写真、 およびその期間に利用できる客室スイート）を取得します。

このブリッジは宿泊施設データを保持しません。上流サーバーのツール一覧を、 ライブエンドポイントから取得したとおりにローカルで提供し、各ツール呼び出しを上流に転送して、 結果を変更せずに返します。取得した機能は読み取り専用です。Booking.comの公開リスティングページを検索して読み取ります。 ベンダー名にかかわらず、予約、予約管理、 メッセージ送信、または支払いのツールは含まれていません。

ツール

• hasdata_booking_search_getBookingSearchResults — 目的地を指定して宿泊施設を検索します。必須項目： keyword、checkInDate、checkOutDate、rooms、 adults、children。任意のフィルターには childrenAges、sort、料金範囲、ベッドルーム数とバスルーム数、 施設タイプ、星評価、レビュー評価、 設備とアクセシビリティ機能、ベッドと 予約の設定、language、currency、および page（1ページあたり25件）が含まれます。各ホテルの ID、タイトルとURL、所在地、ポリシー、料金、評価、 レビュー概要、およびメイン写真を返します。
• hasdata_booking_place_getBookingPlaceDetails — 1件の施設の詳細情報を取得します。必須項目：url （Booking.comの施設URL）、checkInDate、 checkOutDate、rooms、adults、children。 任意項目：childrenAges、language、currency。 施設の名称、住所と座標、ポリシー、料金、評価とレビュー概要、写真、 および利用可能な客室スイートを返します。

設定

• HASDATA_BOOKING_MCP_URL（任意）— 上流エンドポイントを 上書きします。デフォルトは https://mcp.hasdata.com/mcp?apis=bookingです。（この 上書き用フックは、この再構築独自の明示的な再現部分です。）
• HASDATA_API_KEY（任意）— 設定すると、上流へのすべての リクエストに、呼び出し元自身のHasData APIキーを使った x-api-key: <key>ヘッダーが付与されます。未設定の場合、 キーヘッダーは送信されません。（ヘッダー名と環境変数名は、元のレジストリレコードで固定されています。この環境変数からキーを 転送する動作は明示的な再現部分です。元の機能はキーなしで取得されています。）

転送の仕組み

最初のツール呼び出し時に、クライアントは上流とのストリーム可能な HTTPセッションを開きます。まずJSON-RPCの initializeリクエスト（protocolVersion 2025-03-26、 clientInfo name bookdata）を送り、次に notifications/initialized通知を送り、その後、呼び出し元の引数を変更せずに含めた tools/callリクエストを送ります。上流からのinitializeの応答に Mcp-Session-Idヘッダーが含まれている場合、その値は セッションの後続リクエストすべてに引き継がれ、プロセスの実行中はセッションが再利用されます。 応答は通常のJSON形式、またはサーバー送信イベント形式で届くことがあります。どちらも読み取ります。

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

CLI

各ツールは、JSON引数文字列を受け取るサブコマンドとしても実行できます。

npx @reneturcios/bookdata hasdata_booking_search_getBookingSearchResults '{"keyword":"Paris","checkInDate":"2026-11-10","checkOutDate":"2026-11-14","rooms":1,"adults":2,"children":0}'
npx @reneturcios/bookdata hasdata_booking_place_getBookingPlaceDetails '{"url":"https://www.booking.com/hotel/fr/example.html","checkInDate":"2026-11-10","checkOutDate":"2026-11-14","rooms":1,"adults":2,"children":0}'
npx @reneturcios/bookdata --version

終了コード：成功時は0、isErrorの結果の場合は1、 使用方法に誤りがある場合は2です。

MCP サーバー

npx -y @reneturcios/bookdata mcp

MCP クライアントの設定：

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

Docker

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

コンテナーのデフォルトコマンドはmcpなので、最初の形式はstdio MCP サーバーとして動作し、それ以外の引数は通常どおりCLIに渡されます。

開発

npm install
npm run build
npm test
npm run dev

テストスイートはすべて、スタブ化した JSON-RPC上流サーバーに対して実行されます。ライブネットワークへの呼び出しはありません。

ライセンス

MIT — LICENSEを参照してください。