AIGoHotel MCP Server

aigohotel-mcp 是一款基于 MCP (Model Context Protocol) 标准构建的高性能酒店搜索与推荐服务。它旨在连接大语言模型（LLM）与海量海内外酒店数据，为 AI 助手、智能旅游规划工具及 IDE 插件（如 Cursor, Windsurf, Antigravity）提供实时、精准、结构化的酒店检索能力。

通过本服务，模型能够理解复杂的自然语言指令，综合地点（城市、POI、具体地址）、时间（入住日期、天数）、偏好（星级、成人数量、设施要求）等多维度参数进行筛选。它不仅返回酒店的基础信息（名称、价格、位置），还提供深度信息（如酒店级及房间级设施信息、直线距离计算、详细描述等），显著提升对话式旅游应用的交互体验与推荐质量。

---

功能特性

• 多维度酒店搜索

  • 支持按城市、景点、机场、火车站、地铁站、具体地址等多种地点类型搜索
  • 支持指定入住日期、入住晚数
  • 支持过滤星级范围（如 0–5 星）
  • 支持限制返回酒店数量（默认前 5 条，最多 10 条）
  • 支持以景点等 POI 为中心的半径范围搜索（米为单位）
  • 支持选择性返回酒店设施及房间设施信息

• 结构化结果

  • 返回包含酒店名称、位置、星级、价格等核心字段的 JSON 结构
  • 方便模型进行进一步排序、筛选、重写描述等操作

---

能力与接口（MCP 工具概览）

1. find-hotels —— 酒店搜索

根据地点、时间和偏好条件搜索酒店，返回符合条件的酒店列表。

输入参数

• place (string, 必填)
  地点名称（支持城市，景点，酒店，交通枢纽，地标和具体地址等）。

• placeType (string, 可选)
  地点的类型（支持以下类型：城市、机场、景点、火车站、地铁站、酒店、具体地址）。

• checkIn (string, 可选)
  入住日期，格式：yyyy-MM-dd，如 2025-10-01。
  未填写时默认日期为次日。

• stayNights (integer, 可选)
  入住天数，未填写时默认 1 天。

• starRatings (array, 可选)
  酒店星级(0.0-5.0, 梯度为 0.5)，默认 3 星以上。

  • 示例：[4.5, 5.0] 表示 4.5–5 星
  • 示例：[0.0, 2.0] 表示 2 星及以下

• adultCount (integer, 可选)
  每间房入住的成人数量，默认两人。

• distanceInMeter (integer, 可选)
  直线距离，单位（米），当地点是一个 POI 位置时生效，生效时默认设定值为 5000。

• size (integer, 可选)
  返回酒店结果数量，默认 5 个酒店，最大不超过 10 个。

• withHotelAmenities (boolean, 可选)
  是否包含酒店设施。

• withRoomAmenities (boolean, 可选)
  是否包含房间设施。

输出数据结构（示意）

find-hotels 返回一个 JSON 数组，数组元素为酒店对象。根据最新接口定义，字段结构如下：

[
  {
    "Currency": "CNY",              // 价格币种，如 CNY、USD 等
    "Price": 708.0,                // 总价或参考价（通常为整个入住时段的价格）
    "OriginalPrice": null,          // 原价（如有折扣时的划线价），无则为 null
    "HotelID": 1223,                // 酒店内部 ID
    "Name": "齐隆中心点酒店",         // 酒店名称
    "Address": "No. 60, Soi 1...",  // 酒店详细地址
    "StarRating": 4,                // 星级 (number)
    "Tags": null,                   // 标签信息（如特色标签数组）
    "HotelAmenities": ["健身房", "室内泳池", "24小时接待", "水疗中心"], // 酒店级别设施列表
    "HotelRoomAmenities": ["空调", "免费 Wi-Fi", "微波炉", "液晶电视"], // 房间级别设施列表
    "Description": "<p>...",        // 酒店详细描述，支持 HTML 格式
    "AreaCode": "TH",               // 国家/地区代码（如 TH 表示泰国）
    "DestinationID": "178236",      // 目的地 ID
    "Location": {                   // 经纬度地理位置对象
      "Latitude": 13.73903,
      "Longitude": 100.543326
    },
    "DistanceInMeters": 666,        // 距离检索中心点的直线距离（单位：米）
    "DetailUrl": "https://...",     // 酒店详情页跳转 URL
    "ImageUrl": "https://..."       // 酒店主图 URL
  }
]

注意：

• 实际字段以线上接口返回为准，上述示例基于当前接口样例整理；
• 某些字段（如 Address、StarRating、Tags、Location、DistanceInMeters 等）在部分酒店或数据源下可能为 null，使用时需做好空值处理；
• 随着后端能力演进，字段可能会新增或调整，MCP 客户端侧建议按“有则使用、无则忽略”的方式做兼容。

---

使用示例

以下示例展示了在支持 MCP 的 AI 客户端中，模型如何调用该服务完成酒店搜索（伪示例）：

示例 1：搜索某城市的酒店

用户对话：

帮我查一下 2026 年 1 月 1 日在西雅图住 2 晚，3 星以上的酒店，给我 5 个以内的推荐。

模型调用 find-hotels 的参数示意：

{
  "place": "西雅图",
  "placeType": "城市",
  "checkIn": "2026-01-01",
  "stayNights": 2,
  "starRatings": [3, 5],
  "size": 5
}

---

示例 2：搜索景点附近酒店

用户对话：

2026 年 1 月 1 日在白金汉宫附近住 1 晚，尽量 4 星以上，离景点 5 公里内的酒店。

模型调用参数示意：

{
  "place": "白金汉宫",
  "placeType": "景点",
  "checkIn": "2026-01-01",
  "stayNights": 1,
  "starRatings": [4, 5],
  "distanceInMeter": 5000,
  "size": 5
}

---

部署与运行

前置条件

• 加入AIGoHotel MCP计划，并获取对应的API_KEY填入到服务配置变量中
• 一台可运行 HTTP 服务的环境（本地或服务器）
• 已安装并部署 aigohotel-mcp 后端服务，使其对外暴露 MCP 端点：
  • http://localhost:5288/mcp

实际启动命令、运行环境（Node.js / Python / .NET 等）请参考该服务的后端项目文档。

与 MCP 客户端集成步骤

配置方式取决于你的使用场景，通常分为 本地模式 和 远程/IDE 模式。

模式 A：本地运行

适用于你在本地启动了 aigohotel-mcp 服务进程的情况。

1. 启动后端服务：确保本地服务已运行并监听 http://localhost:5288/mcp。
2. 添加配置：在 mcp.json 中使用传统的 url 字段。

   "mcpServers": {
     "aigohotel-mcp": {
         "url": "http://localhost:5288/mcp", // 本地服务地址
         "type": "http",
         "headers": {
             "X-Secret-Key": "YOUR_API_KEY"
         }
     }
   }
   

   或者使用在线预览地址（适用于支持传统字段的客户端）：

   "mcpServers": {
     "aigohotel-mcp": {
         "url": "https://mcp.aigohotel.com/mcp",
         "type": "http",
         "headers": {
             "X-Secret-Key": "YOUR_API_KEY"
         }
     }
   }
   

模式 B：远程/IDE 模式（Cursor / Windsurf / Antigravity）

适用于直接接入 AIGoHotel 官方云端接口，配置在支持远程 MCP 协议的 IDE 或 客户端中。

1. 获取密钥：从 AIGoHotel 开发者平台 获取你的 API_KEY。

2. 添加配置：此类 IDE 通常要求使用 serverUrl 和 Authorization 标准头。

   "aigohotel-mcp": {
     "serverUrl": "https://mcp.aigohotel.com/mcp",
     "headers": {
       "Authorization": "Bearer YOUR_API_KEY",
       "Content-Type": "application/json"
     }
   }
   

3. 重启 / 刷新 MCP 客户端：使配置生效，检查工具列表中是否出现 aigohotel-mcp。

4. 在对话中触发调用：通过自然语言描述酒店搜索需求，客户端会自动进行工具调用。

---

安全与鉴权

• 鉴权方式

  • 本地/传统模式：通过 X-Secret-Key 请求头携带访问密钥。
  • 远程/IDE 模式：通过标准的 Authorization: Bearer <API_KEY> 请求头进行鉴权。
  • 请妥善保管从 AIGoHotel 开发者平台 获取的密钥，并避免将其硬编码或泄露在公共仓库中。

• 网络访问

  • 字段名称：取决于客户端实现。传统客户端通常使用 url 字段，Cursor/Windsurf 模式通常使用 serverUrl 字段。
  • 传输安全：在公网环境下提供服务时，建议使用支持 TLS 的地址（https://...）。
  • 如果仅在本地开发测试，使用 http://localhost:5288/mcp 即可。

---

适用场景

• 旅游出行助手：根据用户出行计划推荐合适酒店
• 行程规划工具：与航班/景点信息服务组合使用，一键规划出行方案
• 内部运营系统：为客服、销售等人员提供酒店搜索支持接口
• 任何需要「自然语言 + 酒店检索」能力的应用或聊天机器人