A Model Context Protocol (MCP) 서버는 Booking.com API를 사용하여 호텔 및 목적지를 검색 할 수 있습니다.

특징

• 대상 검색
• 날짜를 가진 특정 목적지를 위한 호텔 목록을 얻으십시오
• Rich 호텔 정보 :
• 객실 상세 및 유형
• 가격 및 할인
• 등급 및 리뷰
• 사진
• 체크인/체크아웃 시간
• 별 등급

API 통합

이 MCP 서버는 RapidAPI를 통해 Booking.com API를 사용합니다. 당신은 필요로 할 것입니다:

1. RapidAPI 계정
2. Booking.com API에 가입
3. API 키 받기

현재 구현은 두 개의 엔드포인트를 사용합니다.

• /api/v1/hotels/searchDestination: 자주 묻는 질문
• /api/v1/hotels/searchHotels: 대상 호텔 찾기

설치 및 설치

# 필수품

• 파이썬 3.11+
• MCP SDK (pip install mcp)
• httpx (pip install httpx)
• python-dotenv (pip install python-dotenv)

설치

1. Clone 이 저장소:

2. 의존성 설치:

3. RapidAPI 자격 증명 구성:

• 복사 .env.example .env]
• RapidAPI에서 .env] 파일에 Booking.com API에서 RapidAPI 키 추가

서버 실행

서버 실행:

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:

   • Copy .env.example to .env
   • Add your RapidAPI key from Booking.com API on RapidAPI to the .env file

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