
使用 Booking.com API 的 MCP 酒店搜索服务器
概览
一个模型背景协议(MCP)服务器,允许LLMs使用Booking.com API搜索酒店和目的地. - 按名称搜索目的地 - 获取特定目的地的酒店列表并注明日期 - 富豪酒店信息包括: - 房间详情和类型 - 定价和折扣 - 评分和评分 - 照片 - 登入/登出时间 - 明星评分 这个MCP服务器通过RapidAPI使用Booking.com API. 你会需要: 1. 快速API账户 2. 订阅booking.com API 3. 获取您的 API 密钥 目前的实施使用两个终点: - /api/v1/hotels/searchDestination:搜索目的地 - /api/v1/hotels/searchHotels:为目的地获取酒店 - Python 3.11+ - MCP SDK (pip s安装 mcp) - httpx (pip s安装 httpx) - python-dotenv (pip s安装 python-dotenv) 3. 配置您的 RapidAPI 证书 : - Copy.env.example to.env - 从 Booking.com的 API 上添加您的 RapidAPI 密钥到 .
概述(AI 翻译)
一个模型背景协议(MCP)服务器,允许LLMs使用Booking.com API搜索酒店和目的地.
□ 特性
- 按名称搜索目的地
- 提供具体目的地的旅馆清单,注明日期
- 丰富的旅馆信息,包括:
- 房间细节和类型
- 定价和折扣
- 评级和审查
- 图片
- 报到/离职时间
- 明星收视率
□ API 整合
这个MCP服务器通过RapidAPI使用Booking.com API. 你会需要:
- 快速API账户
- 订阅 Booking.com API
- 获取您的 API 密钥
目前的执行有两个终点:
- [[T0]: 寻找目的地
- [[T1]: 找宾馆到目的地
□ 设置和安装
· 先决条件
- Py 3.11+
- MCP SDK([T2])
- httpx([T3])
- 蟒蛇-多腾活([[T4])
- 安装
-
克隆此存储器:
-
安装依赖性:
-
配置您的快速API 证书 :
- 复制[[T5]至[T6]
- 将您从 Booking.com 上的 API 添加到 [[T7] 文件
QQ 运行服务器
以 :
本页由 AI 翻译,技术细节请以原文为准。
README
Hotels MCP Server
A Model Context Protocol (MCP) server that allows LLMs to search for hotels and destinations using the Booking.com API.
Features
- Search for destinations by name
- Get hotel listings for specific destinations with dates
- Rich hotel information including:
- Room details and types
- Pricing and discounts
- Ratings and reviews
- Photos
- Check-in/check-out times
- Star ratings
API Integration
This MCP server uses the Booking.com API via RapidAPI. You’ll need:
- A RapidAPI account
- Subscribe to the Booking.com API
- Get your API key
The current implementation uses two endpoints:
/api/v1/hotels/searchDestination: Search for destinations/api/v1/hotels/searchHotels: Get hotels for a destination
Setup and Installation
Prerequisites
- Python 3.11+
- MCP SDK (
pip install mcp) - httpx (
pip install httpx) - python-dotenv (
pip install python-dotenv)
Installation
-
Clone this repository:
git clone https://github.com/username/hotels_mcp_server.git cd hotels_mcp_server -
Install dependencies:
pip install -r requirements.txt -
Configure your RapidAPI credentials:
- Copy
.env.exampleto.env - Add your RapidAPI key from Booking.com API on RapidAPI to the
.envfile
- Copy
Running the Server
Run the server with:
python main.py
The server uses stdio transport by default for compatibility with MCP clients like Cursor.
Using with MCP Clients
Cursor
-
Edit
~/.cursor/mcp.json:{ "hotels": { "command": "python", "args": [ "/path/to/hotels_mcp_server/main.py" ] } } -
Restart Cursor
-
Use natural language to search for hotels in Cursor:
- “Find hotels in Paris for next week”
- “What are the best-rated hotels in Tokyo?”
MCP Inspector
Test your server with MCP Inspector:
npx @modelcontextprotocol/inspector python main.py
This opens an interactive UI where you can:
- View available tools
- Send test requests
- See server responses
Available Tools
-
search_destinations: Search for destinations by name- Parameter:
query- Destination name (e.g., “Paris”, “New York”)
- Parameter:
-
get_hotels: Get hotels for a destination- Parameters:
destination_id: Destination ID from search_destinationscheckin_date: Check-in date (YYYY-MM-DD)checkout_date: Check-out date (YYYY-MM-DD)adults: Number of adults (default: 2)
- Parameters:
Code Structure
main.py: The entry point for the serverhotels_mcp/: The core MCP implementation__init__.py: Package initializationhotels_server.py: MCP server implementation with tool definitions
License
MIT © Esa Krissa 2025
安装
npx @modelcontextprotocol/inspector python main.py