Skip to main content
Glama
deenesjakoruzh
Skyline-9

travel_mcp

by Skyline-9
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

Комплексный MCP-сервер для путешествий и гостеприимства (hotel_search)

Единый FastMCP-сервер, предоставляющий параллельный поиск отелей, гурманских ресторанов и кафе (Tabelog Japan), мультимодальный транспорт и маршруты, а также проверенные отзывы путешественников и посетителей на глобальных и региональных платформах.

Ключевые возможности

🏨 Размещение и отели

  • 🔄 Параллельный поиск по нескольким провайдерам: Одновременный запрос к Agoda, Booking.com и Hotels.com с помощью search_hotels(..., provider="all").

  • 🔑 Бесшумная аутентификация Chrome: Автоматическая загрузка пользовательских сессий для Agoda (уровень VIP), Booking.com (уровень Genius) и Hotels.com (вознаграждения OneKey).

  • ⚖️ Сравнение цен между платформами: Параллельное сравнение актуальных тарифов на всех трёх платформах с помощью compare_hotel_prices(...) для поиска самого дешёвого провайдера.

  • 🛏️ Сетка номеров и тарифные пакеты: Просмотр конфигураций кроватей, размеров номеров, включённых завтраков, условий отмены и тарифов.

🍽️ Рестораны, кафе и заведения (Tabelog Japan)

  • 🍣 Гурманский поиск и рейтинги: Поиск ресторанов с байесовскими кривыми оценок (>=3.50 — топ-3%, >=4.00 — легендарный/уровень Michelin) через search_restaurants(...) / search_tabelog(...).

  • 🏆 Акцент на лауреатов премий: Фильтрация и выделение победителей The Tabelog Award (золото, серебро, бронза) и Tabelog 100 Famous Stores (Hyakumeiten).

  • 🍱 Бюджет и удобства: Отдельные бюджеты на обед и ужин, многоязычные меню, отдельные кабинеты и доступность для людей с ограниченными возможностями.

  • 📅 Живой календарь свободных мест: Проверка доступных дат бронирования через check_restaurant_reservation(...).

🧭 Мультимодальный транспорт и навигация

  • 🚶🚇🚕 Маршруты и стоимость: Расчёт пешеходных маршрутов, общественного транспорта (названия линий метро/автобусов и пересадки) и стоимости такси через get_transit_and_directions(...).

⭐ Проверенные отзывы о местах

  • 💬 Кросс-платформенные отзывы: Получение оценок, распределения звёзд и отзывов путешественников из Google Reviews, Kakao Maps и Tabelog через get_place_reviews(...).

Related MCP server: MCP Travel Concierge Server

Структура проекта

hotels-mcp/
├── pyproject.toml        # PEP 517/518 build config, dependencies & CLI entrypoints
├── README.md             # Documentation & usage guide
├── AGENTS.md             # Agent guidelines & GitNexus code intelligence
├── CLAUDE.md             # Claude developer instructions
├── tests/
│   ├── __init__.py
│   └── test_server.py    # 17 live multi-provider integration test suites
└── src/
    └── travel_mcp/
        ├── __init__.py   # Package root
        ├── __main__.py   # CLI entrypoint (`python -m travel_mcp`)
        ├── server.py     # FastMCP server instance, tools, prompts & resources
        ├── models.py     # Normalized Pydantic DTOs for travel, dining, and transit
        └── providers/
            ├── __init__.py         # Unified provider factory & registry
            ├── accommodations/     # Hotel accommodation providers
            │   ├── __init__.py
            │   ├── base.py         # HotelProvider ABC & session loader
            │   ├── agoda.py        # Agoda accommodation provider
            │   ├── booking.py      # Booking.com accommodation provider
            │   └── hotels_com.py   # Hotels.com accommodation provider
            ├── dining/             # Restaurant & cafe providers
            │   ├── __init__.py     # Dining provider factory
            │   ├── base.py         # DiningProvider ABC
            │   └── tabelog.py      # Tabelog client & vacancy parser
            ├── routes/             # Multi-modal routing providers
            │   ├── __init__.py     # Route provider factory
            │   ├── base.py         # RouteProvider ABC
            │   └── kakao.py        # Kakao Maps routing provider
            └── reviews/            # Unified place review providers
                ├── __init__.py     # Review provider registry
                ├── base.py         # ReviewProvider ABC
                ├── agoda.py        # Agoda reviews provider
                ├── google.py       # Google Reviews provider
                ├── kakao.py        # Kakao Place reviews provider
                └── tabelog.py      # Tabelog reviews provider

Установка и настройка

cd /Users/richardluo/Developer/hotels-mcp
uv sync

Запуск тестов:

uv run python tests/test_server.py

Запуск сервера:

uv run travel-mcp
# or
uv run python -m travel_mcp

Конфигурация Antigravity / MCP

Добавьте в ~/.gemini/config/mcp_config.json или в .agents/mcp_config.json вашего рабочего пространства:

{
  "mcpServers": {
    "travel_mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/richardluo/Developer/hotels-mcp",
        "run",
        "python",
        "-m",
        "travel_mcp"
      ],
      "env": {
        "PYTHONUNBUFFERED": "1"
      }
    }
  }
}

Доступные инструменты

🍽️ Рестораны, кафе и заведения

Инструмент

Параметры

Описание

search_restaurants

query, prefecture=None, area=None, genre=None, sort_by='rating', meal_type='all', provider='tabelog', page=1, limit=10

Поиск ресторанов с высоким рейтингом по всей Японии на Tabelog (tabelog.com). Включает байесовские оценки (3.5+ — топ-3%, 4.0+ — легендарные), лауреатов премий (золото/серебро/бронза), Hyakumeiten (100 знаменитых заведений), бюджеты на обед/ужин и статус бронирования.

get_restaurant_details

restaurant_id_or_url, provider='tabelog'

Получение полного профиля ресторана, истории наград, точного адреса, GPS-координат, телефона, бюджета, удобств и фотографий блюд в высоком разрешении.

suggest_dining

query, provider='tabelog', limit=5

Автодополнение поисковых запросов для ресторанов, станций, районов и кулинарных жанров.

check_restaurant_reservation

restaurant_id, provider='tabelog'

Проверка актуального онлайн-календаря бронирования и доступных дат для ресторана.

search_tabelog

(как у search_restaurants)

Прямой ярлык для поиска ресторанов Tabelog.

get_tabelog_restaurant_details

(как у get_restaurant_details)

Прямой ярлык для профиля ресторана Tabelog.

suggest_tabelog

(как у suggest_dining)

Прямой ярлык для автодополнения Tabelog.

check_tabelog_reservation

(как у check_restaurant_reservation)

Прямой ярлык для календаря свободных мест Tabelog.

🧭 Мультимодальный транспорт и маршруты

Инструмент

Параметры

Описание

get_transit_and_directions

origin, destination, travel_mode='all', country='KR', provider=None

Расчёт пешеходных шагов, общественного транспорта (линии метро/автобусов, пересадки, стоимость) и стоимости такси между любыми двумя точками (отели, рестораны, кафе, станции, аэропорты).

get_hotel_distance_and_transit

origin, destination, travel_mode='all', country='KR', provider=None

Псевдоним для get_transit_and_directions.

⭐ Отзывы о местах и заведениях

Инструмент

Параметры

Описание

get_place_reviews

place_or_hotel, provider='kakao', page=1, page_size=10

Получение проверенных отзывов пользователей, распределения звёзд и отзывов рецензентов из Kakao Maps, Google Reviews (provider='google') или Tabelog (provider='tabelog').

🏨 Размещение и отели

Инструмент

Параметры

Описание

search_hotels

query, check_in, check_out, adults=2, children=0, rooms=1, min_price=None, max_price=None, provider='all', logged_in=True, limit=10

Параллельный поиск по Agoda, Booking.com и/или Hotels.com с фильтрами по датам, количеству гостей и цене.

compare_hotel_prices

hotel_name, check_in, check_out, adults=2, rooms=1

Трёхсторонняя параллельная проверка цен на Agoda, Booking.com и Hotels.com для поиска самого дешёвого тарифа.

suggest_locations

query, provider='all', limit=5

Автодополнение городов назначения, районов, достопримечательностей и объектов размещения на Agoda, Booking.com и Hotels.com.

get_property_details

hotel_id, provider='agoda', check_in=None, check_out=None, adults=2, children=0, rooms=1, logged_in=True

Получение обзора объекта, адреса, удобств и условий.

get_room_grid

hotel_id, provider='agoda', check_in="", check_out="", adults=2, children=0, rooms=1, logged_in=True

Просмотр типов номеров, конфигураций кроватей, включённых завтраков, условий отмены и тарифов.

get_hotel_reviews

hotel_id, provider='agoda', page=1, page_size=10

Получение проверенных отзывов путешественников и оценок по категориям.

get_hotel_faq

hotel_id, provider='agoda'

Получение официальных проверенных часто задаваемых вопросов отеля.

get_login_status

provider='all'

Проверка активной аутентификации для Agoda (VIP), Booking.com (Genius) и Hotels.com (OneKey).

interactive_login

provider='agoda'

Открывает Chrome для входа в систему, если сессия истекла (поддерживает 'agoda', 'booking.com' или 'hotels.com').

MCP-подсказки и ресурсы (MCP 2.0)

Подсказки

  • plan_trip_itinerary(destination, check_in, check_out, adults, dining_preferences): Комплексное планирование поездки, объединяющее отели, рекомендации по ресторанам и транспортные маршруты.

  • search_japan_dining(query, prefecture, genre, meal_type): Поиск лучших ресторанов и лауреатов премий в Японии.

  • compare_hotel_deals(hotel_name, check_in, check_out, adults, rooms): Сравнение цен в трёх системах и оценка преимуществ.

  • search_destination_hotels(destination, check_in, check_out, adults, rooms): Поиск и ранжирование вариантов размещения.

Ресурсы

  • travel://providers (и hotels://providers): Реестр провайдеров размещения, питания, маршрутизации и отзывов.

  • travel://capabilities: Полная разбивка возможностей по всем туристическим доменам.

  • travel://status (и hotels://status): Состояние сессий и cookie в реальном времени по всем провайдерам.

Install Server
F
license - not found
B
quality
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • MCP Travel Concierge Server

    abhinavmathur-atlan
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables comprehensive travel planning by integrating Google Travel Services and Amadeus GDS for dual flight and hotel searches, plus event discovery, weather forecasting, currency conversion, and location services. Combines consumer-friendly search with professional travel industry data for optimal trip planning.
    6
    MIT

  • Jinko Hotel Booking MCP Server

    dumyCq
    A
    license
    A
    quality
    D
    maintenance
    Enables AI agents to search, browse, and book hotels from a database of 2 million properties worldwide. Provides comprehensive hotel search capabilities with location lookup, filtering by amenities, detailed property information, and integrated booking functionality.
    6
    79
    1
    ISC

View all related MCP servers

Related MCP Connectors

  • MolTravel

    Aggregated travel MCP — flights, tours, activities, price checks, visas, and more.

  • Bitvoya MCP

    Luxury hotel search, rate comparison, booking quotes, and secure checkout handoff.

  • 1stay

    Hotel booking MCP server. Search, book, and manage reservations across 250K+ properties worldwide.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Skyline-9/hotels-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server