staydata

staydata

staydata 是一个小型本地桥接程序，连接托管的 HasData Airbnb MCP 服务，并以 JSON 返回 Airbnb 数据。 提供地点（或地图边界框）以及 入住日期，它就会搜索该日期和人数条件下 可入住的住宿；提供一个房源的 URL，它就会获取该房源的完整页面：房东、 房间和床位、照片、便利设施、评分和评论 数量。

该桥接程序不保存自己的房源数据。它会在本地提供 上游服务的工具列表，内容与从实时端点捕获的 完全一致，并将每次工具调用转发至上游，原样 返回结果。捕获的接口为只读：它会搜索并读取公开房源页面。 其中没有预订、 消息或支付工具。

工具

• hasdata_airbnb_listing_getAirbnbListings — 搜索 可入住的住宿。必填：checkIn。提供 location， 或提供全部四个边界框坐标 （neLat、neLng、swLat、swLng），即可改为在 地图框内搜索。可选：checkOut、adults、 children、infants、pets 和用于分页的 nextPageToken。返回房源 ID/URL、标题、每晚 和总价、评分、评论数量、坐标 和照片。
• hasdata_airbnb_property_getAirbnbPropertyDetails — 获取一个房源的完整页面。必填： url（有效的 Airbnb 房源 URL）。返回标题、 描述、位置、坐标、评分和 评论数量、房东资料、房间/床位/浴室数量、 照片和便利设施列表。

配置

• HASDATA_AIRBNB_MCP_URL（可选）— 覆盖 上游端点。默认值为 https://mcp.hasdata.com/mcp?apis=airbnb。（此 覆盖钩子是本次重建自行标注的 还原内容。）
• HASDATA_API_KEY（可选）— 设置后，每个 上游请求都会携带 x-api-key: <key> 请求头，使用调用者自己的 HasData API 密钥。未 设置时，不会发送密钥请求头。（请求头 名称和环境变量名称由原始版本的注册记录固定； 从此环境变量转发密钥属于标注的还原内容 —— 原始接口是在不带密钥的情况下捕获的。）

转发机制

首次调用工具时，客户端会与上游建立可流式传输的 HTTP 会话：先发送 JSON-RPC initialize 请求（protocolVersion 2025-03-26， clientInfo 名称为 staydata），然后发送 notifications/initialized 通知，接着发送携带调用者 原样参数的 tools/call 请求。上游以 Mcp-Session-Id 请求头响应 initialize 时，该值会 随会话的每个后续请求一同发送，并在进程 运行期间复用。响应可能是 普通 JSON，也可能是服务器发送事件；两种格式都会读取。

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

CLI

每个工具也可作为子命令使用，接受一个 JSON 参数字符串：

npx @reneturcios/staydata hasdata_airbnb_listing_getAirbnbListings '{"location":"San Francisco","checkIn":"2026-11-10","checkOut":"2026-11-14","adults":2}'
npx @reneturcios/staydata hasdata_airbnb_property_getAirbnbPropertyDetails '{"url":"https://www.airbnb.com/rooms/12345678"}'
npx @reneturcios/staydata --version

退出代码：成功时为 0，结果带有 isError 时为 1，用法错误时为 2。

MCP 服务

npx -y @reneturcios/staydata mcp

MCP 客户端配置：

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

Docker

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

容器的默认命令是 mcp，因此第一种形式是 stdio MCP 服务；其他任何参数都会照常传递给 CLI。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全通过桩接的 JSON-RPC 上游运行，不会进行实时网络调用。

许可证

MIT — 参见 LICENSE。