{
  "markdown": "# 道旅酒店MCP |  Hotel Search & Booking MCP\n\n[![Version](https://img.shields.io/badge/Version-1.0.0-blue.svg)](https://github.com/DIDA-AI/DIDA-Hotel-MCP-CN/releases)\n[![ModelScope](https://img.shields.io/badge/ModelScope-Rank%237-brightgreen.svg)](https://modelscope.cn/)\n[![Calls](https://img.shields.io/badge/Calls-847.3k-orange.svg)](https://github.com/DIDA-AI/DIDA-Hotel-MCP-CN)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)\n\n🏠 [官网](https://rollinggo.store/)🚀[ 快速开始](#快速开始)📚[ 使用示例](#使用示例)💬[ 技术支持](#技术支持)📚 [接入视频(0基础0代码可实操)](https://www.xiaohongshu.com/discovery/item/6a22affe0000000017029504?app_platform=ios&app_version=9.33.4&share_from_user_hidden=true&xsec_source=app_share&type=video&xsec_token=CBwWFsJ1iLP0QLjYWHV4RatLComUk4vekr3adma28ssMU=&author_share=1&xhsshare=CopyLink&shareRedId=NzxGN0RLSTo-O0pGTEwzOTszTkBGSUlM&apptime=1782376771&share_id=09ec1dc114174939916826fc8471d07a&code=051iMqFa1D1hXL08HNGa1Eq5Jb3iMqF7&state=wx_oauth)\n📚 [接入文档](https://rollinggo.store/docs/mcp-docs/quick-start) · 💰[开发者变现](https://rollinggo.store/docs/partnerdoc/partner1) \n\n\n\n## 项目简介\n**道旅酒店MCP**为 AI Agent 和 MCP 客户端提供酒店预订能力，它适合希望在 AI 产品中接入酒店交易能力的开发者、Agent 构建者、旅游产品团队和企业差旅场景，企业和个人均可完全免费一键接入，无调用量限制。\n\n🔍 按需求**智能筛选和比价**，省心挑酒店\n\n📋 实时查**房型、报价和退改规则**，明明白白不踩坑\n\n🛏️ 心仪房型提前**锁定**，不用愁晚订没房\n\n💳 说句“下单”就实时确认库存和价格**直接付**\n\n📑 订单状态随时能查，全程都省心\n\n💴 还能设置24 小时自动**盯价**，降价马上**提醒**\n\n\n\n| 服务 | 端点 | 已上线 Tool | 认证 |\n|------|------|------------|------|\n| 酒店 MCP | `https://mcp.rollinggo.cn/mcp` | searchHotels, getHotelDetail, getHotelSearchTags | `Authorization: Bearer <YOUR_API_KEY>` |\n\n- **传输协议**：`streamable-http`\n- **价格**：完全免费，无调用量限制\n- **接入方式**：参考本文档可自助完成，适合需要短时间完成快速原型验证和工具开发\n\n道旅MCP还提供OAuth 2.0 授权码模式，提供7个工具，包括：getHotelSearchTags, searchHotels, getHotelDetail, hotelPriceConfirm, searchHotelOrders等。该模式适合企业级生产应用深度集成，需商务对接contact@rollinggo.ai。\n> 如果你是国际用户，或者你的目标用户为中国以外的国际化国家，请参考 [Dida-Hotel-MCP-Global](https://github.com/DIDA-AI/Dida-Hotel-MCP-Global)。该版本支持信用卡支付，适合非中国大陆地区的业务场景。\n\n\n\n## MCP亮点\n- ✅ **实时库存价确** - 库存直连+实时价格确认能力，信息零延迟，查询结果均可直接预订\n- ✅ **成熟供应链保障** - 全球第三大酒旅B2B官方数据源，14年旅行产品供应链积累，全链路API直连\n- ✅ **海量酒店覆盖** - 坐拥200万+酒店资源，覆盖全球主要目的地\n- ✅ **直签酒店资源** - 11万+直签酒店直连，价格库存实时响应，确保查询结果准确可订\n- ✅ **多元供应体系** - 整合500+全球供应商，涵盖各类酒店品牌，满足不同用户预订需求\n- ✅ **差异化价格优势** - 锚定OTA上游供应，海外酒店及上海、香港、日韩等热门目的地价格优势显著\n- ✅ **兼容性** - 支持 Cursor、Claude Code、Codex、Windsurf、Copilot 等 40 多种主流大模型代理，针对ClawHub/扣子/Qclaw等Agent 平台，还提供[全能订酒店Skill](https://rollinggo.store/solutions/skills)\n- ✅ **开发者返佣** - 接入即可按国家设置加价比例，当用户通过你的工具完成预订，对应金额将作为返佣，订单、收益、提现状态实时可查，灵活提现\n  \n## 适合用户\n- 正在开发 AI Agent 的团队或个人开发者\n- 想在 MCP Client 中接入酒店预订能力的开发者\n- 正在构建旅行规划、差旅管理、OTA、生活服务类智能体的开发者\n- 希望验证 AI Agent 商业交易闭环的产品团队\n- 有酒店查询、酒店比价、盯价提醒接入需求的用户\n\n## 应用场景\n- **通用Agent**：让Agent 直接拥有原生酒店预订能力，用户在自然对话中即可完成从比价筛选到订单创建的全流程\n- **AI旅行助手**：根据用户目的地、日期、预算和个性化偏好精准推荐酒店，支持多维度需求匹配\n- **MCP / Agent Demo**：快速验证 \"AI Agent 直接完成酒店交易\" 的产品能力，打造可演示的完整闭环\n\n## 核心功能\n- 支持**城市名称、热门景点、交通枢纽、酒店名称、具体地址**等 6 种目标地点类型精准搜索\n- 提供灵活的**星级筛选、入住日期设置、住宿天数配置、价格区间过滤**等专业筛选功能\n- 基于用户个人偏好提供**个性化推荐，生成高性价比、好评热门、人气精选**等多维度专业榜单\n- 全程自然语言交互，智能完成从**地点解析、筛选比价、个性化推荐到订单生成**的完整闭环\n\n\n\n## 快速开始\n> 💡 总结来说，你只需要做两件事：申请API Key+ 在AI助手中一键配置，无需编写代码，就能让任何支持MCP的AI助手具备酒店搜索能力，5 分钟内完成第一次 MCP Tool 调用\n\n### 第一步：获取API密钥\n\n1. [点击申请](https://travelportal-partner-center.dida.com/register?lang=zh)\n2. 填写基本信息，0等待，申领即得。\n3. 为什么需要填写信息申请 KEY？酒店价格、库存和订单能力涉及真实交易链路，因此我们需要为每个开发者开通专属的独立KEY。申请 KEY 时仅需填写少量信息，这样做主要是为了减少无效配置成本，保护接口稳定性，避免恶意调用或异常流量，在测试订单、价格查询、库存校验等问题上能及时联系到你。\n\n### 第二步：接入 Agent 工具\n\n> 推荐 Claude CLI、Codex、Cursor 三个客户端。其他支持 MCP 的客户端（如 Kiro、豆包等）配置方式类似。\n\n### Claude CLI\n\n在项目根目录创建 `.mcp.json`：\n\n```json\n{\n  \"mcpServers\": {\n    \"DIDA-Hotel\": {\n      \"url\": \"https://mcp.rollinggo.cn/mcp\",\n      \"type\": \"http\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n也可以通过命令行直接添加：\n\n```bash\nclaude mcp add \\\n  --transport http \\\n  --header \"Authorization: Bearer YOUR_API_KEY\" \\\n  DIDA-Hotel \\\n  https://mcp.rollinggo.cn/mcp\n\n```\n\n### Codex\n\n配置文件位置：项目根目录 `.codex/config.json` 或全局 `~/.codex/config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"DIDA-Hotel\": {\n      \"url\": \"https://mcp.rollinggo.cn/mcp\",\n      \"type\": \"streamable-http\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\n配置文件位置：项目根目录 `.cursor/mcp.json` 或全局 `~/.cursor/mcp.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"DIDA-Hotel\": {\n      \"url\": \"https://mcp.rollinggo.cn/mcp\",\n      \"type\": \"streamable-http\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n> 将 `YOUR_API_KEY` 替换为你收到的实际 API Key。酒店和机票使用相同的认证方式，区别仅在于 URL（`/mcp` vs `/mcp/flight`）。\n\n### cURL 直接测试\n\n> **注意**：cURL 必须带 `-H \"Accept: application/json, text/event-stream\"` 头，否则服务端返回 400。\n\n```bash\ncurl -X POST https://mcp.rollinggo.cn/mcp \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Accept: application/json, text/event-stream\" \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -d '{\n    \"jsonrpc\": \"2.0\",\n    \"method\": \"tools/call\",\n    \"params\": {\n      \"name\": \"searchHotels\",\n      \"arguments\": {\n        \"originQuery\": \"上海外滩五星酒店\",\n        \"place\": \"上海外滩\",\n        \"placeType\": \"景点\",\n        \"checkInParam\": {\n          \"checkInDate\": \"2026-06-01\",\n          \"stayNights\": 2\n        },\n        \"filterOptions\": {\n          \"starRatings\": [5.0]\n        },\n        \"size\": 3\n      }\n    },\n    \"id\": 1\n  }'\n```\n\n---\n\n## 第三步：第一次 MCP 调用\n\n配置完成后，对你的 AI 助手说：\n\n> \"帮我搜一下上海外滩附近后天入住的五星酒店\"\n\nAI 会自动调用 `searchHotels` Tool，返回酒店列表。\n\n### 酒店搜索示例\n\n```json\n{\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"tools/call\",\n  \"params\": {\n    \"name\": \"searchHotels\",\n    \"arguments\": {\n      \"originQuery\": \"上海外滩五星酒店\",\n      \"place\": \"上海外滩\",\n      \"placeType\": \"景点\",\n      \"checkInParam\": {\n        \"checkInDate\": \"2026-06-01\",\n        \"stayNights\": 2\n      },\n      \"filterOptions\": {\n        \"starRatings\": [5.0]\n      },\n      \"size\": 3\n    }\n  },\n  \"id\": 1\n}\n```\n\n\n## 使用示例\n### 示例1：酒店盯价提醒\n> \"帮我监控杭州西溪湿地附近这家酒店\"\n\n### 示例2：城市酒店搜索\n> \"帮我看看未来三天内，杭州有哪些4星以上的酒店推荐？\"\n\n![showcase1](https://raw.githubusercontent.com/young63/dida-picbed/main/showcase1.png)\n![showcase2](https://raw.githubusercontent.com/young63/dida-picbed/main/showcase2.png)\n\n\n\n### 示例2：景点周边搜索\n> \"2026年七夕节，想在香港迪士尼附近找个性价比高的酒店\"\n\n![showcase3](https://raw.githubusercontent.com/young63/dida-picbed/main/showcase3.png )\n![showcase5](https://raw.githubusercontent.com/young63/dida-picbed/main/showcase5.png)\n---\n\n\n## ✨ 功能特性\n\n| 功能 | 说明 |\n|------|------|\n| 🏙️ **多地点搜索** | 支持城市、景点、机场、火车站、地铁站等 |\n| 📅 **日期筛选** | 指定入住日期和住宿天数 |\n| ⭐ **星级过滤** | 支持0-5星筛选，精确到0.5星梯度 |\n| 📍 **距离搜索** | 以景点为中心，限定半径范围（米） |\n| 🛏️ **设施详情** | 可选返回酒店设施、房间设施信息 |\n| 🌐 **多语言** | 支持中文、英文等语言环境 |\n\n\n### 配置参数说明\n\n#### 常用核心参数\n\n| 参数 | 必填 | 说明 | 示例 |\n|------|------|------|------|\n| place | ✅ | 搜索地点 | 杭州、迪士尼 |\n| placeType | ✅ | 地点类型 | 城市、景点、机场、地铁站、区/县... |\n| originQuery | ✅ | 你的原始需求描述 | 帮我找酒店 |\n| checkIn | ❌ | 入住日期(yyyy-MM-dd) | 2026-05-01 |\n| stayNights | ❌ | 住宿天数 | 2 |\n| starRatings | ❌ | 星级范围 | [4, 5] 表示4-5星 |\n| size | ❌ | 返回数量(默认10)，最大20 | 5 |\n\n> 注意：\n> - 实际字段以接口数据返回为准，上述示例仅展示部分字段。\n> -   随着后端能力演进，字段可能会新增或调整，MCP 客户端侧建议按\"有则使用、无则忽略\"的方式做兼容。\n\n\n## ❓ 常见问题\n### Q: 支持哪些AI助手/IDE？\n\n**A:** 目前支持以下平台：\n- Cursor\n- Windsurf\n- Antigravity\n- Claude Desktop\n- Cherry studio等其他支持MCP协议的客户端\n\n### Q: 搜索结果包含哪些信息？\n\n**A:** 默认返回酒店名称、星级、价格、地址、预订链接，酒店图片、酒店设施等。(具体可参考实际返回数据)\n### Q: 有调用次数限制吗？\n\n**A:** 目前阶段免费使用。\n\n\n## 🔒 安全与鉴权\n\n### 认证方式\n\n| 环境 | 认证方式 | Header |\n|------|----------|--------|\n| 远程(云端) | Bearer Token | \\Authorization: Bearer YOUR_API_KEY\\ |\n| 本地服务 | Secret Key | \\X-Secret-Key: YOUR_API_KEY\\ |\n\n### 安全建议\n\n- API Key请妥善保管，不要硬编码在代码中\n- 生产环境建议使用环境变量管理\n- 公网访问请使用HTTPS协议\n\n\n\n## 🤝技术支持\n感谢每一位开发者的交流、分享与反馈，让DIDA的迭代更高效。\n\n加入微信群，核心开发团队会全程在线，协助搞定环境配置、接口调试，一起跑通第一个成功的酒店预订调用，零障碍快速上线。\n\n![Support WeChat](support-wehcat%20group.png)\n\n你可以在群内获得：\n- ✅ 接入配置指导\n- ✅ API / MCP 调用问题排查\n- ✅ 酒店搜索、价格、预订流程说明\n- ✅ 适合你业务场景的集成建议\n\n邮箱：[york.lu@dida.com](mailto:york.lu@dida.com)\n\n## ⚠ 附录：道旅Hotel MCP (OAuth) v2.3 更新说明\n\nv2.3 优化了订单查询结构，新增多个订单详情字段，帮助 Agent 更好地处理入住、支付和取消场景。注：此更新仅适用于 OAuth 接入版本，非本文档所述的 API Key 版本。OAuth 版本需商务对接。\n\n### What changed\n\n#### Unchanged tools (4)\n\n- `getHotelSearchTags` — 获取所有可用酒店筛选标签\n- `searchHotels` — 按条件搜索全球酒店列表\n- `getHotelDetail` — 获取指定酒店的可用房型及价格\n- `hotelPriceConfirm` — 锁定选中房型的实时最终零售价\n\n#### Modified tools (2)\n\n- `createHotelBookingWithPaymentURL` — 移除 `alipayUrlScene` 参数；`bookingResult.paymentUrl` 统一为通用收银台\n- `searchHotelOrders` — 输出精简为 9 个核心字段（`orderNo`、`hotelName`、`roomName`、`orderStatus`、`totalPrice` 等），仅用于列表展示；完整详情移至独立接口查询\n\n#### New tools (1)\n\n- `getHotelOrderDetail` — 按 `orderNo` 查询完整订单详情，包含 `hotelConfirmationNo`、入住人名单、床型、联系电话、经纬度、支付/取消截止时间、政策标识等\n\n#### New fields\n\n- `hotelConfirmationNo` — 酒店侧真实确认号，供前台查询入住\n- `stayInfo.bedTypeStr` — 床型中文描述（如 `\"1张特大床 (1.8m)\"`）\n- `stayInfo.guestNames` — 入住人拼音/英文姓名列表，用于入住核验\n- `priceInfo.paymentDeadline` — 支付截止时间（`YYYY-MM-DD HH:mm:ss`），用于倒计时提醒\n- `policyInfo.freeCancelDeadline` — 免费取消截止时间，用于判断退款窗口\n- `policyInfo.isCancelable` — 当前时刻是否仍可免费取消\n\n\n#### **工具总数**： 7 个（V2.2 为 6 个）—— 新增 1 个，变更 2 个，未变更 4 个。\n---\n**Made with ❤️ by DIDA Team**\n</div>\n",
  "bytes": 9068,
  "sha": "b0dd3e013deef1a9e7d9fe770a595b28e5e8043fabaa3d9bfe9b0cbec6e88d5b",
  "repo_slug": "dida-ai/dida-hotel-mcp-cn",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_dida_ai_hotelbooking_ae91a9cd/readme"
}