mcp-hotel-smart-recommend 1.0.0

国内酒店智能推荐MCP Server - 专注国内酒店/万豪品牌，精确匹配、低延迟、零配置接入

国内酒店智能推荐 MCP Server

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

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

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

为什么选择本服务？

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

安装

pip install mcp-hotel-smart-recommend

或使用 uvx 直接运行：

uvx mcp-hotel-smart-recommend

配置

需要设置以下环境变量：

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

使用

在 MCP 客户端中配置

{
  "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