Hotels MCP 服务器

一个模型上下文协议（MCP）服务器，允许大型语言模型（LLMs）通过 Booking.com API 搜索酒店和目的地。

功能

• 按名称搜索目的地
• 获取特定目的地的酒店列表（包括日期）
• 丰富的酒店信息，包括：
  • 房间详情和类型
  • 价格和折扣
  • 评分和评论
  • 照片
  • 入住/退房时间
  • 星级评定

API 集成

此 MCP 服务器通过 RapidAPI 使用 Booking.com API。您需要：

1. 一个 RapidAPI 账户
2. 订阅 Booking.com API
3. 获取您的 API 密钥

当前实现使用了两个端点：

• /api/v1/hotels/searchDestination: 搜索目的地
• /api/v1/hotels/searchHotels: 获取目的地的酒店

设置与安装

前提条件

• Python 3.11+
• MCP SDK (pip install mcp)
• httpx (pip install httpx)
• python-dotenv (pip install python-dotenv)

安装

1. 克隆此仓库：

   git clone https://github.com/username/hotels_mcp_server.git
   cd hotels_mcp_server

2. 安装依赖项：
   bash
   pip install -r requirements.txt

3. 配置您的 RapidAPI 凭证：

   • 将 .env.example 复制为 .env
   • 将从 RapidAPI 上的 Booking.com API 获取的 RapidAPI 密钥添加到 .env 文件中

运行服务器

运行服务器：

bash
python main.py

默认情况下，服务器使用 stdio 传输以兼容像 Cursor 这样的 MCP 客户端。

与 MCP 客户端一起使用

Cursor

1. 编辑 ~/.cursor/mcp.json：
   json
   {
   "hotels": {
   "command": "python",
   "args": [
   "/path/to/hotels_mcp_server/main.py"
   ]
   }
   }

2. 重启 Cursor

3. 使用自然语言在 Cursor 中搜索酒店：

   • "查找下周巴黎的酒店"
   • "东京最好的酒店有哪些？"

MCP Inspector

使用 MCP Inspector 测试您的服务器：

bash
npx @modelcontextprotocol/inspector python main.py

这将打开一个交互式用户界面，在其中您可以：

• 查看可用工具
• 发送测试请求
• 查看服务器响应

可用工具

1. search_destinations: 按名称搜索目的地

   • 参数：query - 目的地名称（例如，“巴黎”，“纽约”）

2. get_hotels: 获取目的地的酒店

   • 参数：
     • destination_id: 来自 search_destinations 的目的地 ID
     • checkin_date: 入住日期 (YYYY-MM-DD)
     • checkout_date: 退房日期 (YYYY-MM-DD)
     • adults: 成人数（默认值：2）

代码结构

• main.py: 服务器的入口点
• hotels_mcp/: 核心 MCP 实现
  • __init__.py: 包初始化
  • hotels_server.py: 包含工具定义的 MCP 服务器实现

许可证

MIT © Esa Krissa 2025