hoteldata

hoteldata

hoteldata は、JSON 形式で Google Hotels の検索結果を返す、ホスト型の HasData Google Hotels MCP サーバーへの小規模なローカルブリッジです。場所または宿泊施設名に加えてチェックイン日とチェックアウト日を指定すると、一致するホテルとバケーションレンタルを取得します。返されるのは、上流から返された各宿泊施設の名前、リンク、所在地、1 泊あたりの料金と合計料金、ホテルクラス、宿泊者評価とレビュー件数、画像、アメニティ、近隣の場所です。宿泊者の構成（大人、人数と年齢を指定した子ども）やローカライズ（国、言語、通貨）を指定でき、価格帯、並べ替え順、宿泊施設の種類、アメニティ、最低評価、ブランド、ホテルクラス、キャンセル無料、特別オファー、エコ認証、寝室数と浴室数の最低条件を指定するバケーションレンタルモード、ページングトークンなど、幅広いフィルターで検索を調整できます。

このブリッジは検索結果を独自に保存しません。ライブエンドポイントから取得した上流サーバーのツール一覧をそのままローカルで提供し、各ツール呼び出しを上流に転送して、結果を変更せずに返します。取得した機能は読み取り専用の検索機能のみです。予約、宿泊予約、支払いのツールは含まれていません。

ツール

• hasdata_google_travel_hotels_getGoogleHotels — 1 回の滞在について Google Hotels を検索します。必須項目：q （検索クエリ。都市、近隣地域、またはホテル名）、checkInDate と checkOutDate（どちらも yyyy-MM-dd 形式）。任意項目：gl（国）、 hl（言語）、currency、adults、children と childrenAges （子どもの人数と一致する、カンマ区切りの年齢）、sortBy （lowestPrice ／ highestRating ／ mostReviewed）、1 泊あたりの minPrice と maxPrice、propertyType__（ホテルとレンタルの宿泊施設の種類）、 amenity__（ホテルとレンタルのアメニティ）、rating（宿泊者の最低評価）、 brands、hotelClass、freeCancellation、specialOffers、ecoCertified、 vacationRentals、bedrooms、bathrooms、nextPageToken（ページング）、 propertyToken（特定の宿泊施設の詳細）。 宿泊施設ごとの料金、価格比較、評価、レビュー、アメニティ、お得情報、ページネーショントークンを返します。

設定

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

転送の仕組み

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

上流からの成功結果は、上流が設定した isError フラグも含め、内容をそのまま通過させます。 JSON-RPC エラー、2xx 以外のステータス、読み取れない応答、完了できないリクエストなどの 失敗は、テキストが hoteldata error: で始まる isError 結果として返されます （このエラー表示は、この再構築で独自にラベル付けしたものです）。

CLI

このツールは、1 つの JSON 引数文字列を受け取るサブコマンドとしても利用できます。

npx @reneturcios/hoteldata hasdata_google_travel_hotels_getGoogleHotels '{"q":"San Francisco","checkInDate":"2026-11-10","checkOutDate":"2026-11-12","adults":2,"sortBy":"lowestPrice"}'
npx @reneturcios/hoteldata --version

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

MCP サーバー

npx -y @reneturcios/hoteldata mcp

MCP クライアントの設定：

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

Docker

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

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

開発

npm install
npm run build
npm test
npm run dev

テストスイートはすべて、スタブ化された JSON-RPC アップストリームに対して実行されます。実際のネットワーク呼び出しはありません。

ライセンス

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