### [AIGoHotel(酒店预订）](https://s.ddm.chat/link/700)

**Published:** 2026-07-23T02:00:23

**Author:** 颠倒梦

**Excerpt:** 这是一个功能强大的全球酒店智能推荐及预订工具，为用户提供覆盖海内外范围的全球酒店信息服务，满足用户各类酒店需求…

# AIGoHotel MCP Server

API KEY申请地址：[https://mcp.agentichotel.cn/apply](https://mcp.agentichotel.cn/apply)

`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 数组**，数组元素为酒店对象。根据最新接口定义，字段结构如下：

```jsonc
[
  {
    "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` 的参数示意：**

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

* * *

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

**用户对话：**

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

**模型调用参数示意：**

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

* * *

## 部署与运行

### 前置条件

-   [加入AIGoHotel MCP计划](https://mcp.agentichotel.cn/apply)，并获取对应的`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` 字段。
    
    ```JSON
    "mcpServers": {
      "aigohotel-mcp": {
          "url": "http://localhost:5288/mcp", // 本地服务地址
          "type": "http",
          "headers": {
              "X-Secret-Key": "YOUR_API_KEY"
          }
      }
    }
    ```
    
    _或者使用在线预览地址（适用于支持传统字段的客户端）：_
    
    ```JSON
    "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 开发者平台](https://mcp.agentichotel.cn/apply) 获取你的 `API_KEY`。
    
2.  **添加配置**：此类 IDE 通常要求使用 `serverUrl` 和 `Authorization` 标准头。
    
    ```JSON
    "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 开发者平台](https://mcp.agentichotel.cn/apply) 获取的密钥，并避免将其硬编码或泄露在公共仓库中。
-   **网络访问**
    
    -   **字段名称**：取决于客户端实现。传统客户端通常使用 `url` 字段，Cursor/Windsurf 模式通常使用 `serverUrl` 字段。
    -   **传输安全**：在公网环境下提供服务时，建议使用支持 TLS 的地址（`https://...`）。
    -   如果仅在本地开发测试，使用 `http://localhost:5288/mcp` 即可。

* * *

## 适用场景

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



---