Hotels MCP Server

这是一个使用Booking.com API允许LLMs搜索酒店和目的地的Model Context Protocol (MCP)服务器。

功能

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

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. 安装依赖项：

   pip install -r requirements.txt
   

3. 配置您的RapidAPI凭证：

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

运行服务器

运行服务器：

python main.py

该服务器默认使用stdio传输以兼容如Cursor等MCP客户端。

使用MCP客户端

Cursor

1. 编辑~/.cursor/mcp.json：

   {
     "hotels": {
       "command": "python",
       "args": [
         "/path/to/hotels_mcp_server/main.py"
       ]
     }
   }
   

2. 重启Cursor

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

   • "查找下周在巴黎的酒店"
   • "东京的最佳评分酒店是什么？"

MCP Inspector

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

npx @modelcontextprotocol/inspector python main.py

这将打开一个交互式UI，您可以：

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

可用工具

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