RollingGo-Hotel-MCP

Un servicio de búsqueda y reserva de hoteles de alto rendimiento construido sobre el estándar MCP.

Documentación

RollingGo — Búsqueda y Reserva de Hoteles MCP

🏠 Sitio web · 🚀 Inicio rápido · 📚 Ejemplos de uso · 💬 Soporte técnico📚 Tutorial de integración - versión en video (apto para principiantes sin conocimientos de código) 📚 Tutorial de integración - versión documental

Introducción del proyecto

RollingGo Hotel MCP proporciona capacidades de reserva de hoteles para agentes de IA y clientes MCP. Es adecuado para desarrolladores, constructores de agentes, equipos de productos turísticos y escenarios de viajes corporativos que desean integrar capacidades de transacción hotelera en productos de IA. Tanto empresas como individuos pueden conectarse de forma totalmente gratuita, sin límites de llamadas.

🔍 Filtrado inteligente y comparación de precios según tus necesidades, para elegir hoteles sin complicaciones

📋 Consulta en tiempo real tipos de habitación, precios y políticas de cancelación, para no llevarte sorpresas

🛏️ Bloquea tu tipo de habitación favorito con antelación, sin preocuparte por quedarte sin disponibilidad

💳 Di "reservar" y confirma en tiempo real el inventario y el precio para pagar directamente

📑 Consulta el estado de tu pedido en cualquier momento, con total tranquilidad

💴 También puedes configurar un monitoreo de precios automático las 24 horas, con avisos inmediatos cuando bajen los precios

Servicio	Endpoint	Tools disponibles	Autenticación
Hotel MCP	`https://mcp.rollinggo.cn/mcp`	searchHotels, getHotelDetail, getHotelSearchTags	`Authorization: Bearer <YOUR_API_KEY>`
Vuelos MCP	`https://mcp.rollinggo.cn/mcp/flight`	searchAirports, searchFlights	`Authorization: Bearer <YOUR_API_KEY>`

Destacados de MCP

✅ Confirmación de inventario y precio en tiempo real - Conexión directa de inventario + confirmación de precios en tiempo real, información sin demoras, los resultados de búsqueda se pueden reservar directamente
✅ Cadena de suministro madura - Fuente de datos oficial B2B de viajes y hotelería número 3 del mundo, 14 años de experiencia en cadena de suministro de productos turísticos, conexión API directa en todo el proceso
✅ Amplia cobertura hotelera - Más de 2 millones de recursos hoteleros, cubriendo los principales destinos del mundo
✅ Recursos hoteleros de contrato directo - Más de 110,000 hoteles de contrato directo, precios e inventario con respuesta en tiempo real, resultados precisos y reservables
✅ Sistema de suministro diversificado - Integra más de 500 proveedores globales, cubriendo diversas marcas hoteleras para satisfacer las necesidades de reserva de diferentes usuarios
✅ Ventaja de precios diferenciada - Anclado al suministro upstream de OTA, con ventajas significativas en hoteles internacionales y destinos populares como Shanghái, Hong Kong, Japón y Corea
✅ Compatibilidad - Compatible con más de 40 agentes de modelos grandes populares como Cursor, Claude Code, Codex, Windsurf, Copilot, etc. Para plataformas de agentes como ClawHub/Coze/Qclaw, también se ofrece el Rollinggo Skill de reserva de vuelos y hoteles.

Usuarios ideales

Equipos o desarrolladores individuales que desarrollan agentes de IA
Desarrolladores que desean integrar capacidades de reserva hotelera en clientes MCP
Desarrolladores que construyen agentes de planificación de viajes, gestión de viajes corporativos, OTA y servicios de estilo de vida
Equipos de producto que desean validar el ciclo comercial cerrado de agentes de IA
Usuarios individuales con necesidades de búsqueda de hoteles, comparación de precios y alertas de precios

Escenarios de aplicación

Agente de IA general: Dale a tu agente de modelos grandes la capacidad nativa de reserva hotelera; los usuarios pueden completar todo el proceso desde la comprensión de necesidades, recomendación inteligente, filtrado y comparación hasta la creación de pedidos en conversación natural
Asistente de viajes con IA: Recomienda hoteles con precisión según destino, fechas, presupuesto y preferencias personalizadas, con soporte para coincidencia multidimensional de necesidades
Herramienta de planificación de itinerarios: Integra la búsqueda y reserva de hoteles en el flujo conversacional de planificación de itinerarios, logrando una experiencia integrada de "planificar y reservar"
Demo de MCP / Agente: Valida rápidamente la capacidad del producto de "agente de IA que completa transacciones hoteleras directamente", creando un ciclo cerrado completo y demostrable

Funciones principales

Búsqueda precisa en 6 tipos de ubicaciones objetivo: nombre de ciudad, atracciones populares, centros de transporte, nombre de hotel, dirección específica
Filtros profesionales flexibles: filtro por estrellas, configuración de fecha de entrada, duración de estadía, filtro por rango de precios
Recomendaciones personalizadas basadas en preferencias del usuario, generando listas profesionales multidimensionales como alta relación calidad-precio, populares con buenas reseñas, selecciones destacadas
Interacción completa en lenguaje natural, completando inteligentemente el ciclo desde análisis de ubicación, filtrado y comparación, recomendación personalizada hasta generación de pedidos

Inicio rápido

💡 En resumen, solo necesitas hacer dos cosas: solicitar una API Key + configurarla en el asistente de IA con un clic. Sin necesidad de escribir código, cualquier asistente de IA compatible con MCP puede tener capacidades de búsqueda hotelera. Completa tu primera llamada a Tool MCP en 5 minutos.

Paso 1: Obtener la clave API

Haz clic para solicitar
Completa la información básica, sin esperas, la obtienes al instante.
¿Por qué es necesario completar información para solicitar la KEY? Los precios de hoteles, inventario y capacidades de pedido involucran transacciones reales, por lo que necesitamos habilitar una KEY independiente y exclusiva para cada desarrollador. Solo se requiere información mínima al solicitar la KEY, principalmente para reducir costos de configuración ineficiente, proteger la estabilidad de la interfaz, evitar llamadas maliciosas o tráfico anómalo, y poder contactarte oportunamente en temas como pedidos de prueba, consultas de precios y verificación de inventario.

Paso 2: Integrar la herramienta de agente

Se recomiendan los clientes Claude CLI, Codex y Cursor. Otros clientes compatibles con MCP (como Kiro, Doubao, etc.) tienen configuraciones similares.

Claude CLI

Crea .mcp.json en el directorio raíz del proyecto:

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

También puedes agregarlo directamente desde la línea de comandos:

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

Ubicación del archivo de configuración: .codex/config.json en el directorio raíz del proyecto o ~/.codex/config.json global

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

Ubicación del archivo de configuración: .cursor/mcp.json en el directorio raíz del proyecto o ~/.cursor/mcp.json global

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

Reemplaza YOUR_API_KEY con la API Key real que recibiste. Los hoteles y vuelos usan el mismo método de autenticación; la única diferencia es la URL (/mcp vs /mcp/flight).

Prueba directa con cURL

Nota: cURL debe incluir el encabezado -H "Accept: application/json, text/event-stream", de lo contrario el servidor devuelve 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
  }'

Paso 3: Primera llamada MCP

Después de la configuración, dile a tu asistente de IA:

"Ayúdame a buscar hoteles de 5 estrellas cerca del Bund en Shanghái para pasado mañana"

La IA llamará automáticamente a la Tool searchHotels y devolverá la lista de hoteles.

Ejemplo de búsqueda de hoteles

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

Ejemplos de uso

Ejemplo 1: Alerta de precios de hotel

"Ayúdame a monitorear este hotel cerca del Humedal Xixi en Hangzhou"

Ejemplo 2: Búsqueda de hoteles por ciudad

"¿Puedes recomendarme hoteles de 4 estrellas o más en Hangzhou para los próximos tres días?"

showcase1 showcase2

Ejemplo 2: Búsqueda cerca de atracciones

"Para el Día de San Valentín de 2026, quiero encontrar un hotel con buena relación calidad-precio cerca de Disneyland Hong Kong"

✨ Características

Función	Descripción
🏙️ Búsqueda multi-ubicación	Admite ciudades, atracciones, aeropuertos, estaciones de tren, estaciones de metro, etc.
📅 Filtro por fechas	Especifica fecha de entrada y duración de estadía
⭐ Filtro por estrellas	Admite filtrado de 0-5 estrellas, con precisión de 0.5 estrellas
📍 Búsqueda por distancia	Centrada en la atracción, con radio limitado (metros)
🛏️ Detalles de instalaciones	Opcional: devuelve información de instalaciones del hotel y de la habitación
🌐 Multilingüe	Admite entornos en chino, inglés y otros idiomas

Descripción de parámetros de configuración

Parámetros principales comunes

Parámetro	Obligatorio	Descripción	Ejemplo
place	✅	Ubicación de búsqueda	Hangzhou, Disney
placeType	✅	Tipo de ubicación	Ciudad, atracción, aeropuerto, estación de metro, distrito/condado...
originQuery	✅	Tu descripción original de la necesidad	Ayúdame a encontrar un hotel
checkIn	❌	Fecha de entrada (yyyy-MM-dd)	2026-05-01
stayNights	❌	Noches de estadía	2
starRatings	❌	Rango de estrellas	[4, 5] significa 4-5 estrellas
size	❌	Cantidad de resultados (por defecto 10), máximo 20	5

Nota:

Los campos reales dependen de los datos devueltos por la interfaz; los ejemplos anteriores solo muestran algunos campos.

A medida que evolucionan las capacidades del backend, los campos pueden agregarse o ajustarse. Se recomienda que los clientes MCP manejen la compatibilidad con el enfoque "usar si existe, ignorar si no".

❓ Preguntas frecuentes

P: ¿Qué asistentes/IDEs de IA son compatibles?

R: Actualmente se admiten las siguientes plataformas:

Cursor
Windsurf
Antigravity
Claude Desktop
Cherry studio y otros clientes compatibles con el protocolo MCP

P: ¿Qué información incluyen los resultados de búsqueda?

R: Por defecto se devuelven nombre del hotel, estrellas, precio, dirección, enlace de reserva, imágenes del hotel, instalaciones, etc. (Consulta los datos reales devueltos para más detalles).

P: ¿Hay límite de llamadas?

R: Actualmente es de uso gratuito.

🔒 Seguridad y autenticación

Método de autenticación

Entorno	Autenticación	Header
Remoto (nube)	Bearer Token	\Authorization: Bearer YOUR_API_KEY\
Servicio local	Secret Key	\X-Secret-Key: YOUR_API_KEY\

Recomendaciones de seguridad

Guarda tu API Key de forma segura, no la codifiques directamente en el código
En producción, se recomienda usar variables de entorno
Para acceso público, usa el protocolo HTTPS

🤝 Soporte técnico

Agradecemos el intercambio, la retroalimentación y las contribuciones de cada desarrollador, que hacen que la iteración de RollingGO sea más eficiente.

Únete al grupo de WeChat; el equipo de desarrollo principal estará disponible en línea en todo momento para ayudarte con la configuración del entorno, la depuración de interfaces y completar juntos la primera llamada exitosa de reserva hotelera, para que puedas lanzar sin obstáculos.

Support WeChat

En el grupo puedes obtener:

✅ Guía de configuración de integración
✅ Solución de problemas de llamadas API / MCP
✅ Explicación del proceso de búsqueda, precios y reserva de hoteles
✅ Recomendaciones de integración adecuadas para tu escenario de negocio

Correo electrónico: york.lu@dida.com

Hecho con ❤️ por el equipo de RollingGo