RollingGo MCP Server (NPM Version)

RollingGo 酒店 MCP Server（NPM 版本）。

当前版本与 rollinggo-mcp 主仓对齐，提供以下 3 个工具：

当前 npm 包名为 rollinggo-mcp。

• searchHotels：按地点 + 结构化条件搜索酒店候选
• getHotelDetail：查询单个酒店实时房型与价格明细
• getHotelSearchTags：获取酒店搜索标签元数据（AI Cache）

工具参数概览

searchHotels

必填参数：

• originQuery (string)
• place (string)
• placeType (string: 城市/机场/景点/火车站/地铁站/酒店/区县/详细地址)

可选参数：

• checkInParam (object): adultCount, checkInDate, stayNights
• countryCode (string)
• filterOptions (object): distanceInMeter, starRatings
• hotelTags (object): preferredTags, requiredTags, excludedTags, preferredBrands, maxPricePerNight, minRoomSize
• size (number, 默认 5)

getHotelDetail

可选参数（hotelId 和 name 至少提供一个）：

• hotelId (number)
• name (string)
• dateParam (object): checkInDate, checkOutDate
• occupancyParam (object): adultCount, childCount, childAgeDetails, roomCount
• localeParam (object): countryCode, currency

getHotelSearchTags

• 无参数

快速开始

npm install
npm run build

启动方式（NPX）

npx -y rollinggo-mcp

默认通过 stdio 运行（无本地 HTTP 端口）。

MCP 客户端配置（npx + stdio）

{
  "mcpServers": {
    "rollinggo": {
      "command": "npx",
      "args": ["-y", "rollinggo-mcp"],
      "env": {
        "ROLLINGGO_API_KEY": "mcp_your_key"
      }
    }
  }
}

鉴权

NPM 版本（stdio）通过环境变量读取 API Key。

• ROLLINGGO_API_KEY
• ROLLINGGO_SECRET_KEY

相关链接

• API Key 申请：https://mcp.rollinggo.cn/apply
• Model Context Protocol：https://modelcontextprotocol.io/