LLM が Booking.com API を使用してホテルや目的地を検索できるモデルコンテキストプロトコル (MCP) サーバー。

##特徴

• 名前で目的地を検索
• 特定の目的地の日付のリストを取得する
• 豊富なホテル情報を含む:
• 客室の詳細と種類
• 価格と割引
• 評価とレビュー
• 写真
• チェックイン/チェックアウト時間
• 星の評価

API の統合

この MCP サーバーは、 RapidAPI 経由で Booking.com API を使用します。 お問い合わせ

1. RapidAPIアカウント
2. Booking.com API の購読 3。 APIキーを取得する

現在の実装は2つのエンドポイントを使用します。

セットアップとインストール

前提条件

• Python 3.11 +
• MCP SDK([[T2])
• httpx([T3])
• python-dotenv ([pip install python-dotenv))

インストール

1. このリポジトリをクローンする:

2. 依存関係を取付けて下さい:

3。 RapidAPIの資格情報の設定:

• [.env.exampleを.envにコピーする
• RapidAPI から [[[T7] ファイルに 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