Metadata-Version: 2.4
Name: mcp-hotel-smart-recommend
Version: 1.0.0
Summary: 国内酒店智能推荐MCP Server - 专注国内酒店/万豪品牌，精确匹配、低延迟、零配置接入
Author: mako2026
License-Expression: MIT
Requires-Python: >=3.12
Requires-Dist: cryptography>=42.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp[cli]>=1.9.2
Description-Content-Type: text/markdown

# 国内酒店智能推荐 MCP Server

这是一个专注国内酒店的智能推荐MCP服务，基于国内头部旅行平台官方数据，为AI助手、旅行智能体及Cursor/Cherry Studio/Windsurf等IDE提供实时、精准的酒店检索与推荐能力。

区别于全球酒店服务的"大而全"，本服务深耕国内酒店场景：支持按城市、地标、酒店名称精确搜索，内置万豪/喜来登/JW/威斯汀等国际品牌专区，支持按星级、价格区间、距离排序等多维度筛选，返回酒店实时价格、房型、设施及距离信息。数据覆盖国内全部省会及热门旅游城市，酒店名称与地址精确匹配，无"搜不到"或"返回错误地址"的问题。

**MCP URL直连即用，无需额外申请Key或身份认证**，配置即接入，5秒内返回结构化结果。专为对话式旅行应用和AI Agent打造，低延迟响应适配实时交互场景。

## 为什么选择本服务？

| 对比项 | 全球酒店服务 | 本服务（国内酒店智能推荐） |
|--------|------------|------------------------|
| 覆盖范围 | 全球，国内不精 | 专注国内，深耕场景 |
| 搜索精度 | 按酒店名搜索经常出错 | 国内酒店名称精确匹配 |
| 接入方式 | 需申请Key+身份认证 | MCP URL直连，零配置 |
| 响应速度 | 频繁超时 | 低延迟，适配实时对话 |
| 品牌专区 | 无 | 内置万豪/喜来登/JW等品牌专区 |
| 接入门槛 | 需身份证认证 | 配置环境变量即可使用 |

## 安装

```bash
pip install mcp-hotel-smart-recommend
```

或使用 uvx 直接运行：

```bash
uvx mcp-hotel-smart-recommend
```

## 配置

需要设置以下环境变量：

| 变量名 | 说明 | 获取方式 |
|--------|------|---------|
| FLYAI_API_KEY | FlyAI API密钥 | https://flyai.open.fliggy.com 注册获取 |
| FLYAI_SIGN_SECRET | FlyAI签名密钥 | 同上 |

## 使用

### 在 MCP 客户端中配置

```json
{
  "mcpServers": {
    "hotel-smart-recommend": {
      "command": "uvx",
      "args": ["mcp-hotel-smart-recommend"],
      "env": {
        "FLYAI_API_KEY": "你的API密钥",
        "FLYAI_SIGN_SECRET": "你的签名密钥"
      }
    }
  }
}
```

### 工具列表

#### search_hotels - 国内酒店搜索

搜索国内酒店，返回实时价格和可预订链接。支持按城市、星级、价格、附近地标等多维度筛选，酒店名称精确匹配。

参数：
- `dest`（必填）：目的地城市/区域，如"深圳""上海外滩""三亚"
- `max_price`：最高价格/晚，如：500
- `hotel_stars`：星级，如：5（豪华型）、4（高档型）、3（舒适型）
- `checkin`：入住日期 YYYY-MM-DD
- `checkout`：退房日期 YYYY-MM-DD
- `poi`：附近景点/地标，如：外滩、长隆
- `hotel_type`：酒店类型（酒店/民宿/客栈）
- `sort`：排序（rate_desc/price_asc/price_desc/distance_asc）
- `keywords`：搜索关键词，如：万豪、亲子
- `limit`：返回数量，默认10

示例：搜索深圳400元以内的高档型酒店

#### search_marriott_hotels - 万豪集团酒店搜索

搜索万豪集团旗下酒店（万豪/喜来登/JW/威斯汀/丽思卡尔顿/万丽/万枫等），返回实时价格和可预订链接。

参数：
- `dest`（必填）：目的地城市/区域
- `max_price`：最高价格/晚
- `checkin`：入住日期 YYYY-MM-DD
- `checkout`：退房日期 YYYY-MM-DD
- `sort`：排序方式
- `limit`：返回数量，默认10

示例：搜索上海800元以内的万豪酒店

## 适用场景

- **AI编程助手**：在Cursor/Windsurf中直接调用酒店搜索，为旅行规划项目提供数据
- **旅行智能体**：给旅行AI Agent接入酒店能力，实现"查酒店→比价→给链接"闭环
- **对话式旅行应用**：低延迟响应，适配实时对话场景

## 技术特性

- 基于MCP（Model Context Protocol）标准
- 客户端星级硬过滤，确保结果精确
- 价格二次校验，避免超出预算
- 结构化JSON返回，易于Agent解析
- SSE流式响应支持

## License

MIT
