内容
<img src="assets/icon-64.png" width="72" align="right" alt="GetMyHotels logo" />
# GetMyHotels · MCP 连接器
> 搜索真实酒店，获取实时价格，预订 — 直接在您的 AI 助手内。
**GetMyHotels** 是一个托管的 [模型上下文协议](https://modelcontextprotocol.io) 服务器，连接 Claude、ChatGPT、Cursor 和任何 MCP 兼容客户端到实时酒店库存。搜索实时可用性和价格，比较选项并使用交互式小部件，完成支付优先的结账 — 所有操作都在聊天中进行。
| | |
| --- | --- |
| **连接器网址** | `https://mcp.getmyhotels.com` |
| **传输** | 可流式 HTTP |
| **身份验证** | OAuth 2.1 + 动态客户端注册（访客搜索无需登录） |
| **注册表** | [`com.getmyhotels/getmyhotels`](https://registry.modelcontextprotocol.io/v0/servers?search=getmyhotels) |
| **文档和网站** | <https://www.getmyhotels.com/mcp> |
> 此仓库是连接器的 **公共主页** — 设置指南、工具参考和注册表清单（[`server.json`](./server.json)）。服务器实现本身是专有的，不包含在此。
## 添加连接器
### Claude（claude.ai 或 Claude 桌面版）
设置 → **连接器** → **添加自定义连接器** → 粘贴 `https://mcp.getmyhotels.com` → **连接**。
访客搜索立即生效；已登录的工具会在您第一次使用时触发 OAuth 登录。
### ChatGPT（开发者模式）
设置 → **连接器** → **创建** → 粘贴 `https://mcp.getmyhotels.com`。
### Cursor / 其他 MCP 客户端
添加一个指向 `https://mcp.getmyhotels.com` 的 **远程** MCP 服务器。
## 身份验证
- **无需登录** 即可进行搜索、定价、酒店详情和创建结账链接。
- **OAuth 2.1** 解锁已保存的行程、预订管理、已保存的卡和一键结账。客户端通过 **动态客户端注册** 自动注册 — 无需配置。
## 工具
### 搜索和研究 — 无需登录
| 工具 | 描述 |
| --- | --- |
| `search_hotels` | 搜索目的地的实时可用性和价格；返回按价格排序的列表，每个酒店都有一个 `ref`。 |
| `get_rooms` | 列出一个酒店和日期范围的可预订房间。 |
| `get_hotel_details` | 完整的属性详情：描述、设施、照片、政策、位置。 |
| `get_checkout_quote` | 实时向供应商重新定价特定房间（无需预订，无需收费）。 |
| `search` / `fetch` | 研究风格的搜索和按 ID 获取（酒店和预订参考）。 |
| `get_booking` | 通过管理令牌从确认电子邮件中查找预订。 |
### 结账
| 工具 | 描述 |
| --- | --- |
| `create_checkout` | 为选择的房间创建安全的 getmyhotels.com 结账 URL。**不会扣费** — 客人会在我们的网站上完成付款。 |
### 您的账户 — 需要登录
| 工具 | 描述 |
| --- | --- |
| `list_trips` · `save_trip` · `add_trip_item` | 创建和管理已保存的行程 / 行程安排。 |
| `list_my_bookings` · `get_my_booking` | 查看您的酒店预订。 |
| `request_booking_action_code` | 发送 6 位验证码 — 在取消/修改之前需要。 |
| `cancel_booking` · `modify_booking` | 取消或更改预订（需要 6 位验证码）。 |
| `list_payment_methods` | 列出您的已保存卡。 |
| `create_one_click_checkout` | 创建一个已保存卡预选的结账。 |
## 交互式小部件
三个工具在支持的客户端中返回丰富、交互式的 UI（MCP 应用 / OpenAI 小部件）：
- **`search_hotels`** — 结果网格，包含照片、评分、价格和地图。
- **`get_rooms`** — 酒店详情，包含照片轮播、评论评分、设施和房间。
- **`create_checkout`** — 结账卡，包含价格明细和支付按钮。
## 示例提示
- "在巴塞罗那搜索 9 月 10-12 日的 4 星级酒店，2 名成人，仅可退款。"
- "显示该酒店的房间并给我实时价格。"
- "为最便宜的房间启动结账。"
- "列出我的即将到来的预订。" *(登录您)*
- "取消我在那家酒店的预订。" *(发送验证码，然后确认)*
## 安全性和隐私
- 卡号永远不会通过模型 — 支付发生在 getmyhotels.com 上。
- 取消或修改预订需要一次性验证码发送给预订所有者。
- 访客工具输出会清除内部标识符和个人数据。
## 链接
- **网站：** <https://www.getmyhotels.com>
- **连接器文档：** <https://www.getmyhotels.com/mcp>
- **MCP 注册表：** `com.getmyhotels/getmyhotels` — <https://registry.modelcontextprotocol.io/v0/servers?search=getmyhotels>
## 许可证
[MIT](./LICENSE) © getmyhotels.com
