EH

esakrissa/hotels_mcp_server

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

32 stars 9 forks 质量 54 趋势 26

使用 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. 你会需要:

  1. 快速API账户
  2. 订阅 Booking.com API
  3. 获取您的 API 密钥

目前的执行有两个终点:

  • [[T0]: 寻找目的地
  • [[T1]: 找宾馆到目的地

□ 设置和安装

· 先决条件

  • Py 3.11+
  • MCP SDK([T2])
  • httpx([T3])
  • 蟒蛇-多腾活([[T4])
  • 安装
  1. 克隆此存储器:

  2. 安装依赖性:

  3. 配置您的快速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:

  1. A RapidAPI account
  2. Subscribe to the Booking.com API
  3. 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

  1. Clone this repository:

    git clone https://github.com/username/hotels_mcp_server.git
    cd hotels_mcp_server
    
  2. Install dependencies:

    pip install -r requirements.txt
    
  3. Configure your RapidAPI credentials:

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

  1. Edit ~/.cursor/mcp.json:

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

  3. 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

  1. search_destinations: Search for destinations by name

    • Parameter: query - Destination name (e.g., “Paris”, “New York”)
  2. get_hotels: Get hotels for a destination

    • Parameters:
      • destination_id: Destination ID from search_destinations
      • checkin_date: Check-in date (YYYY-MM-DD)
      • checkout_date: Check-out date (YYYY-MM-DD)
      • adults: Number of adults (default: 2)

Code Structure

  • main.py: The entry point for the server
  • hotels_mcp/: The core MCP implementation
    • __init__.py: Package initialization
    • hotels_server.py: MCP server implementation with tool definitions

License

MIT © Esa Krissa 2025

在 GitHub 查看完整 README

安装

npx @modelcontextprotocol/inspector python main.py
新手?先看 mcpskill.org 教程 →