# @curless/hotel-storefront 中文文档

规范地址：https://npmcn.com/package/%40curless/hotel-storefront/

版本：0\.65\.0
npm 元数据更新时间：2026-11-11T04:59:11.930Z
中文译文更新时间：2026-11-11T04:59:03.719Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40curless/hotel-storefront
原文对照：https://npmcn.com/package/%40curless/hotel-storefront/?lang=original
项目主页：https://mcp.curless.ai/doc/sdks/
源码仓库：https://gitlab.com/curless-group1/agentbank

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：5.8 MB，330 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：5 个
- 首次发布：2026-09-18T03:26:31.143Z
- 最新版本发布：2026-11-11T04:59:11.681Z
- 近 30 天下载量：13541（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：189（近 12 个月 189 个）

## 中文简介

一个酒店预订的MCP连接器,由配置文件驱动. Brand),工具名,词汇以及房间从何而来在一个酒店Config(英语:Hotel Config (film))的活地中,所以第二个酒店组是一个JSON文件而不是叉.

## 安装

```sh
npm install @curless/hotel-storefront
```

也可以使用：`pnpm add @curless/hotel-storefront`、`yarn add @curless/hotel-storefront`、`bun add @curless/hotel-storefront`

## README

# @ curless/ hotel- storefront

一个酒店预订的MCP连接器,由一个配置文件驱动. 品牌,工具名称, 词汇和房间来自哪里 `HotelConfig`,所以第二个 酒店集团是一个JSON文件,而不是叉子.

```bash
npx @curless/hotel-storefront ./config.json   # the config lives in the brand's own repo
```

它答对 `POST /mcp` (可流式HTTP),作为自己的卡 `ui://` 资源,并出版 `/docs`, (中文(简体) ), `/privacy`, (中文(简体) ), `/terms` 财务报告和审定财务报表 `/healthz`。 。 。 .

## 日期为一等类型

与购物连接器的一个结构差异: **一个房间没有价格 直到有人给夜晚起名.** 任何能带价的东西都要 `Stay`旅馆的简况及其设施 故意与可以分开的部分分离. 一个接线人猜"这个" 周末"订错人 晚上,他们发现 在前台.

## 工具

21 从品牌的前缀取名 其中2张是卡片的自有并保存 从模型。 一个不能做某事的后端在它的 `capabilities`这些工具根本没有被列出.. 十四(无忠诚,加入,就地修改或政策文本).

|  |  |
| --- | --- |
| `list_<brand>_hotels` | 该团体的目的地, 或按城市或免费文本的酒店, 带有过滤器, 某种和夜天花板 `checkIn`编号 :`checkOut` 每个价格的夜晚。 一个城市通常有好几个, 他们都回来 |
| `look_up_<brand>_hotels` | 多达六所旅馆被读作正文,无所取用: |
| `get_<brand>_hotel` | 一家旅馆,有日期, 房间价格是那些夜晚和抵达日 |
| `compare_<brand>_hotels` | 2到4并列 - 模型的判断,服务器的数字(不用价格) |
| `show_<brand>_itinerary` | 每天,每件物品都标在旅行中或只标在计划中 |
| `list_<brand>_extras` | 转移、餐饮、体验、温泉、家庭 -- -- 停留或预订 |
| `add_to_<brand>_trip` • 妇女 `view_` • 妇女 `clear_` | 旅行: 房间之夜加加价 |
| `request_<brand>_booking` | 示威活动(demo)或旅馆预订费(团体自己的API);每次停留确认代码 |
| `pick_<brand>_room` • 妇女 `book_picked_<brand>_room` | 该卡自己的,只应用: 保留一个费率, 预订一个房间。 选手在旅行旁有一个插槽 - 第二选手取代了第一名, 也没有触及旅行 |
| `list_my_<brand>_bookings` | 这段对话的预订, 或者一个从它的代码 和它制作的电子邮件 |
| `preview_<brand>_cancellation` • 妇女 `cancel_<brand>_booking` | 手续费和规则,在取消之前 |
| `preview_<brand>_booking_change` • 妇女 `change_<brand>_booking` | 新的夜晚、房间或附加:先是差别,再是变化 |
| `get_<brand>_hotel_policies` | 财产本身的出版内容 |
| `sign_in_<brand>_member` • 妇女 `sign_out_` | 一个会员号码和上面的姓 一个会员率,从来没有办法进入任何人的预订 |
| `forget_<brand>_preferences` | 删除被请求记住的成员对房间的偏好 |

工具描述说工具能做什么,没有其他东西; 如何行为生活 服务器的 `instructions`,这是两个助理目录的列表 需要证明.

## 三个规则 代码执行

-   **没有日期,没有线条.** `add_to_*_trip` 问而不是猜测.
-   **预览,然后取消.** `cancel_*_booking` 返回收费及其规则 取消任何内容,直到再次调用 `confirmed`。 。 。 .
-   **扣留不付,预订不付.** 预订不需要钱 取出无相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相.

## 房间从哪里来

一切经过一个 `HotelBackend` 界面,有两个:

-   **`data.source: "demo"`** 阅读 JSON 文件并定价(`DemoHotels`) (中文(简体) ). 每个有价的答案都带着 `demo: true` 并用语言说: 被发明的可订速率是预定连接器的失败 不能这样.
-   **`data.source: "api"`, (中文(简体) ), `data.api.provider: "huazhu"`** 书籍真实 通过Huazhu的经销商OpenAPI: 将酒店列表保存在磁盘上 时事 价格 规则和房间 要求现场直播, `prebook` 之前 订房 旅馆每次订房一次 答案被丢失, 然后是八分钟的一致性查询 华藏的规矩要求. 全权证书来自环境 (单位:千美元)`HUAZHU_CLIENT_ID`, (中文(简体) ), `HUAZHU_CLIENT_SECRET`, (中文(简体) ), `HUAZHU_DISTRIBUTOR_ID`从不 这个配置.
-   **`data.api.sandbox: true`** 同一连接器对接一个 SIMULLTED Huazhu, 在一个账户之前进行测试: `node dist/huazhu/sandbox.js` 向经销商API提供文件描述的,9个 发明了名为QQ/\[Sandbox\]的旅馆,没有照片,并保留其 订入 `SANDBOX_STATE_FILE`旗帜让每个答案都说 `demo`,则 指令和法律页面都说这是一个测试环境 什么都没有 声称去瓦兹胡的订货 - 没有它,阿皮源被认为是真实的.

一个后端说它不能通过什么 `capabilities` - 华祖没有忠诚 登录、 不添加和在位日期变化 —— 工具、 服务器 指示,卡片和合法页面不提供 有东西总是说不.

```bash
# The first call against a real environment, read-only - it never books:
HUAZHU_CLIENT_ID=… HUAZHU_CLIENT_SECRET=… HUAZHU_DISTRIBUTOR_ID=… \
  npx @curless/hotel-storefront --check ./config.json
```

## 付款

不在本版本中,通过设计:弧以预订请求而结束. 缝合是 `config.payment.mode`。 。 。 .

麻省理工学院的一部分 [代理银行](https://mcp.curless.ai/doc/sdks/)

## 常见问题

### @curless/hotel-storefront 是什么？

一个酒店预订的MCP连接器,由配置文件驱动\. Brand\),工具名,词汇以及房间从何而来在一个酒店Config\(英语:Hotel Config \(film\)\)的活地中,所以第二个酒店组是一个JSON文件而不是叉\.

### 如何安装 @curless/hotel-storefront？

在项目目录运行 npm install @curless/hotel-storefront，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 curless-hotel-storefront，可以用 npx curless-hotel-storefront 直接运行。

### @curless/hotel-storefront 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @curless/hotel-storefront 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @curless/hotel-storefront 可以商用吗？

@curless/hotel-storefront 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @curless/hotel-storefront 的下载量有多少？

根据 npm 官方下载统计，@curless/hotel-storefront 在 2026/10/11 – 2026/11/09 这 30 天内被下载 13,541 次，日均约 451 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @curless/hotel-storefront 还在维护吗？

最新版本 0\.65\.0 发布于 2026/11/11（今天）；至今共发布 189 个版本，其中过去 12 个月发布了 189 个；首次发布于 2026/09/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

