RollingGo Hotel

中文 | English

Version ModelScope Calls License: MIT Python 3.8+

🏠 官网 · 🚀 快速开始 · 📚 使用示例 · 💬 技术支持📚 接入教程-视频版(0基础0代码可实操) 📚 接入教程-文档版

项目简介

RollingGo Hotel MCP为 AI Agent 和 MCP 客户端提供酒店预订能力，它适合希望在 AI 产品中接入酒店交易能力的开发者、Agent 构建者、旅游产品团队和企业差旅场景，企业和个人均可完全免费一键接入，无调用量限制。

🔍 按需求智能筛选和比价，省心挑酒店

📋 实时查房型、报价和退改规则，明明白白不踩坑

🛏️ 心仪房型提前锁定，不用愁晚订没房

💳 说句“下单”就实时确认库存和价格直接付

📑 订单状态随时能查，全程都省心

💴 还能设置24 小时自动盯价，降价马上提醒

服务	端点	已上线 Tool	认证
酒店 MCP	https://mcp.rollinggo.cn/mcp	searchHotels, getHotelDetail, getHotelSearchTags	Authorization: Bearer <YOUR_API_KEY>
机票 MCP	https://mcp.rollinggo.cn/mcp/flight	searchAirports, searchFlights	Authorization: Bearer <YOUR_API_KEY>

MCP亮点

• ✅ 实时库存价确 - 库存直连+实时价格确认能力，信息零延迟，查询结果均可直接预订
• ✅ 成熟供应链保障 - 全球第三大酒旅B2B官方数据源，14年旅行产品供应链积累，全链路API直连
• ✅ 海量酒店覆盖 - 坐拥200万+酒店资源，覆盖全球主要目的地
• ✅ 直签酒店资源 - 11万+直签酒店直连，价格库存实时响应，确保查询结果准确可订
• ✅ 多元供应体系 - 整合500+全球供应商，涵盖各类酒店品牌，满足不同用户预订需求
• ✅ 差异化价格优势 - 锚定OTA上游供应，海外酒店及上海、香港、日韩等热门目的地价格优势显著
• ✅ 兼容性 - 支持 Cursor、Claude Code、Codex、Windsurf、Copilot 等 40 多种主流大模型代理，针对ClawHub/扣子/Qclaw等Agent 平台，还提供Rollinggo全能订机票酒店Skill。

适合用户

• 正在开发 AI Agent 的团队或个人开发者
• 想在 MCP Client 中接入酒店预订能力的开发者
• 正在构建旅行规划、差旅管理、OTA、生活服务类智能体的开发者
• 希望验证 AI Agent 商业交易闭环的产品团队
• 有酒店查询、酒店比价、盯价提醒需求的个人用户

应用场景

• 通用 AI Agent：让你的大模型 Agent 直接拥有原生酒店预订能力，用户在自然对话中即可完成从需求理解、智能推荐、比价筛选到订单创建的全流程
• AI 旅行助手：根据用户目的地、日期、预算和个性化偏好精准推荐酒店，支持多维度需求匹配
• 行程规划工具：把酒店搜索和预订能力无缝嵌入对话式行程规划流程，实现 "规划即预订" 的一体化体验
• MCP / Agent Demo：快速验证 "AI Agent 直接完成酒店交易" 的产品能力，打造可演示的完整闭环

核心功能

• 支持城市名称、热门景点、交通枢纽、酒店名称、具体地址等 6 种目标地点类型精准搜索
• 提供灵活的星级筛选、入住日期设置、住宿天数配置、价格区间过滤等专业筛选功能
• 基于用户个人偏好提供个性化推荐，生成高性价比、好评热门、人气精选等多维度专业榜单
• 全程自然语言交互，智能完成从地点解析、筛选比价、个性化推荐到订单生成的完整闭环

快速开始

💡 总结来说，你只需要做两件事：申请API Key+ 在AI助手中一键配置，无需编写代码，就能让任何支持MCP的AI助手具备酒店搜索能力，5 分钟内完成第一次 MCP Tool 调用

第一步：获取API密钥

1. 点击申请
2. 填写基本信息，0等待，申领即得。
3. 为什么需要填写信息申请 KEY？酒店价格、库存和订单能力涉及真实交易链路，因此我们需要为每个开发者开通专属的独立KEY。申请 KEY 时仅需填写少量信息，这样做主要是为了减少无效配置成本，保护接口稳定性，避免恶意调用或异常流量，在测试订单、价格查询、库存校验等问题上能及时联系到你。

第二步：接入 Agent 工具

推荐 Claude CLI、Codex、Cursor 三个客户端。其他支持 MCP 的客户端（如 Kiro、豆包等）配置方式类似。

Claude CLI

在项目根目录创建 .mcp.json：

{
  "mcpServers": {
    "RollingGo-Hotel": {
      "url": "https://mcp.rollinggo.cn/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    },
    "RollingGo-Flight": {
      "url": "https://mcp.rollinggo.cn/mcp/flight",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

也可以通过命令行直接添加：

claude mcp add \
  --transport http \
  --header "Authorization: Bearer YOUR_API_KEY" \
  RollingGo-Hotel \
  https://mcp.rollinggo.cn/mcp

claude mcp add \
  --transport http \
  --header "Authorization: Bearer YOUR_API_KEY" \
  RollingGo-Flight \
  https://mcp.rollinggo.cn/mcp/flight

Codex

配置文件位置：项目根目录 .codex/config.json 或全局 ~/.codex/config.json

{
  "mcpServers": {
    "RollingGo-Hotel": {
      "url": "https://mcp.rollinggo.cn/mcp",
      "type": "streamable-http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    },
    "RollingGo-Flight": {
      "url": "https://mcp.rollinggo.cn/mcp/flight",
      "type": "streamable-http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor

配置文件位置：项目根目录 .cursor/mcp.json 或全局 ~/.cursor/mcp.json

{
  "mcpServers": {
    "RollingGo-Hotel": {
      "url": "https://mcp.rollinggo.cn/mcp",
      "type": "streamable-http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    },
    "RollingGo-Flight": {
      "url": "https://mcp.rollinggo.cn/mcp/flight",
      "type": "streamable-http",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

将 YOUR_API_KEY 替换为你收到的实际 API Key。酒店和机票使用相同的认证方式，区别仅在于 URL（/mcp vs /mcp/flight）。

cURL 直接测试

注意：cURL 必须带 -H "Accept: application/json, text/event-stream" 头，否则服务端返回 400。

curl -X POST https://mcp.rollinggo.cn/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "searchHotels",
      "arguments": {
        "originQuery": "上海外滩五星酒店",
        "place": "上海外滩",
        "placeType": "景点",
        "checkInParam": {
          "checkInDate": "2026-06-01",
          "stayNights": 2
        },
        "filterOptions": {
          "starRatings": [5.0]
        },
        "size": 3
      }
    },
    "id": 1
  }'

---

第三步：第一次 MCP 调用

配置完成后，对你的 AI 助手说：

"帮我搜一下上海外滩附近后天入住的五星酒店"

AI 会自动调用 searchHotels Tool，返回酒店列表。

酒店搜索示例

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "searchHotels",
    "arguments": {
      "originQuery": "上海外滩五星酒店",
      "place": "上海外滩",
      "placeType": "景点",
      "checkInParam": {
        "checkInDate": "2026-06-01",
        "stayNights": 2
      },
      "filterOptions": {
        "starRatings": [5.0]
      },
      "size": 3
    }
  },
  "id": 1
}

使用示例

示例1：酒店盯价提醒

"帮我监控杭州西溪湿地附近这家酒店"

示例2：城市酒店搜索

"帮我看看未来三天内，杭州有哪些4星以上的酒店推荐？"

示例2：景点周边搜索

"2026年七夕节，想在香港迪士尼附近找个性价比高的酒店"

✨ 功能特性

功能	说明
🏙️ 多地点搜索	支持城市、景点、机场、火车站、地铁站等
📅 日期筛选	指定入住日期和住宿天数
⭐ 星级过滤	支持0-5星筛选，精确到0.5星梯度
📍 距离搜索	以景点为中心，限定半径范围（米）
🛏️ 设施详情	可选返回酒店设施、房间设施信息
🌐 多语言	支持中文、英文等语言环境

配置参数说明

常用核心参数

参数	必填	说明	示例
place	✅	搜索地点	杭州、迪士尼
placeType	✅	地点类型	城市、景点、机场、地铁站、区/县...
originQuery	✅	你的原始需求描述	帮我找酒店
checkIn	❌	入住日期(yyyy-MM-dd)	2026-05-01
stayNights	❌	住宿天数	2
starRatings	❌	星级范围	[4, 5] 表示4-5星
size	❌	返回数量(默认10)，最大20	5

注意：

• 实际字段以接口数据返回为准，上述示例仅展示部分字段。
• 随着后端能力演进，字段可能会新增或调整，MCP 客户端侧建议按"有则使用、无则忽略"的方式做兼容。

❓ 常见问题

Q: 支持哪些AI助手/IDE？

A: 目前支持以下平台：

• Cursor
• Windsurf
• Antigravity
• Claude Desktop
• Cherry studio等其他支持MCP协议的客户端

Q: 搜索结果包含哪些信息？

A: 默认返回酒店名称、星级、价格、地址、预订链接，酒店图片、酒店设施等。(具体可参考实际返回数据)

Q: 有调用次数限制吗？

A: 目前阶段免费使用。

🔒 安全与鉴权

认证方式

环境	认证方式	Header
远程(云端)	Bearer Token	\Authorization: Bearer YOUR_API_KEY\
本地服务	Secret Key	\X-Secret-Key: YOUR_API_KEY\

安全建议

• API Key请妥善保管，不要硬编码在代码中
• 生产环境建议使用环境变量管理
• 公网访问请使用HTTPS协议

🤝技术支持

感谢每一位开发者的交流、分享与反馈，让RollingGO的迭代更高效。

加入微信群，核心开发团队会全程在线，协助搞定环境配置、接口调试，一起跑通第一个成功的酒店预订调用，零障碍快速上线。

你可以在群内获得：

• ✅ 接入配置指导
• ✅ API / MCP 调用问题排查
• ✅ 酒店搜索、价格、预订流程说明
• ✅ 适合你业务场景的集成建议

邮箱：[email protected]

Made with ❤️ by RollingGo Team