hoteldata

hoteldata

hoteldata 是一个小型本地桥接程序，可连接托管的 HasData Google Hotels MCP 服务，并以 JSON 格式返回 Google Hotels 搜索结果。提供地点或房源名称，以及入住和退房日期后， 它会获取匹配的酒店和度假租赁房源：每处房源的名称、链接、 位置、每晚和总价、酒店等级、住客评分和评论数、图片、 便利设施和附近地点，均与上游返回的内容一致。搜索可按 住客组成（成人，以及附带年龄的儿童）进行设置，也可按 本地化选项（国家/地区、语言和货币）进行设置，还可使用 一系列筛选条件，包括价格范围、排序方式、房源类型、 便利设施、最低评分、品牌、酒店等级、免费取消、特别优惠、 生态认证、带有卧室和浴室最低数量条件的度假租赁模式，以及分页令牌。

该桥接程序不会存储自己的搜索结果。它会在本地提供上游 服务的工具列表，内容与从实时端点捕获的内容完全一致， 并将每次工具调用转发到上游，原样返回结果。捕获到的工具 范围仅包含一项只读搜索：其中没有预订、预约或付款工具。

工具

• hasdata_google_travel_hotels_getGoogleHotels — 搜索一次 Google Hotels 入住行程。必填：q （搜索查询：城市、街区或酒店名称）、checkInDate 和 checkOutDate（均采用 yyyy-MM-dd 格式）。可选： gl（国家/地区）、hl（语言）、currency、adults、 children 和 childrenAges（逗号分隔的年龄，数量须与 儿童人数相符）、sortBy（lowestPrice / highestRating / mostReviewed）、每晚的 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（可选）— 设置后，每个上游请求都会携带 x-api-key: <key> 标头，使用调用方自己的 HasData API 密钥。 未设置时，不会发送密钥标头。（标头名称和环境变量名称 由原始版本的注册记录确定；从此环境变量转发密钥属于自行 标注的还原内容——原始工具范围是在未提供密钥的情况下捕获的。）

转发机制

首次调用工具时，客户端会与上游建立可流式传输的 HTTP 会话： 先发送 JSON-RPC initialize 请求（protocolVersion 2025-03-26， clientInfo name hoteldata），然后发送 notifications/initialized 通知，最后发送携带调用方参数且 未经修改的 tools/call 请求。如果上游在 initialize 响应中 返回 Mcp-Session-Id 标头，该值会随该会话的每个后续请求发送； 会话会在进程的整个生命周期内重复使用。响应可能是普通 JSON， 也可能是服务器发送的事件；两种格式都会读取。

成功的上游结果会原样传递，包括上游设置的任何 isError 标记。 失败情况——JSON-RPC 错误、非 2xx 状态、无法读取响应，或 无法完成的请求——会作为 isError 结果返回，其文本以 hoteldata error: 开头（此呈现方式是本次重建中自行标注的还原内容）。

CLI

此工具也可作为子命令使用，接受一个 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 服务；其他参数则会正常传递给命令行工具。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全通过模拟的 JSON-RPC 上游运行，不会发起实时网络调用。

许可证

MIT — 请参阅 LICENSE。