AIGoHotel MCP Server
API KEY申请地址：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 数组，数组元素为酒店对象。根据最新接口定义，字段结构如下：
[
{
"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": "
...", // 酒店详细描述，支持 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 服务进程的情况。
- 启动后端服务：确保本地服务已运行并监听
http://localhost:5288/mcp。 - 添加配置：在
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 或 客户端中。
- 获取密钥：从 AIGoHotel 开发者平台 获取你的
API_KEY。 - 添加配置：此类 IDE 通常要求使用
serverUrl和Authorization标准头。
"aigohotel-mcp": {
"serverUrl": "https://mcp.aigohotel.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
}
}- 重启 / 刷新 MCP 客户端：使配置生效，检查工具列表中是否出现
aigohotel-mcp。 - 在对话中触发调用：通过自然语言描述酒店搜索需求，客户端会自动进行工具调用。
安全与鉴权
- 鉴权方式
- 本地/传统模式：通过 X-Secret-Key 请求头携带访问密钥。 - 远程/IDE 模式：通过标准的 Authorization: Bearer 请求头进行鉴权。 - 请妥善保管从 AIGoHotel 开发者平台 获取的密钥，并避免将其硬编码或泄露在公共仓库中。
- 网络访问
- 字段名称：取决于客户端实现。传统客户端通常使用 url 字段，Cursor/Windsurf 模式通常使用 serverUrl 字段。 - 传输安全：在公网环境下提供服务时，建议使用支持 TLS 的地址（https://...）。 - 如果仅在本地开发测试，使用 http://localhost:5288/mcp 即可。
适用场景
- 旅游出行助手：根据用户出行计划推荐合适酒店
- 行程规划工具：与航班/景点信息服务组合使用，一键规划出行方案
- 内部运营系统：为客服、销售等人员提供酒店搜索支持接口
- 任何需要「自然语言 + 酒店检索」能力的应用或聊天机器人