SM

samwang0723/mcp-booking

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

16 stars 12 forks Качество 57 Тренд 21MIT

Сервер контекстного протокола модели бронирования

Обзор

Сервер Model Context Protocol (MCP) для обнаружения и бронирования ресторанов. Этот сервер интегрируется с API Google Maps Places, чтобы найти рестораны на основе местоположения, предпочтений кухни, настроения и типа события, а затем предоставляет интеллектуальные рекомендации и помощь в бронировании. Найдите рестораны в радиусе 20 км с расширенной фильтрацией - Автоматический поиск по Тайваню (24.1501164, 120.6692299), когда не указаны координаты - : Получите 3 лучших предложения ресторана с подробными рассуждениями - : Реальные данные ресторана, включая рейтинги, обзоры и фотографии - : Оптимизированные для знакомств, семейных встреч, деловых встреч и торжеств - : Найдите рестораны, соответствующие романтической, случайной, высококлассной, веселой или тихой атмосфере - : Получите инструкции по бронированию и возможности макетного бронирования Найдите рестораны в радиусе 20 км в зависимости от местоположения, типа кухни, настроения и типа мероприятия - data : Реальные данные ресторана с рейтингами, обзорами, фотографиями и контактной информацией - : Проверьте ...

Обзор (машинный перевод)

Сервер Model Context Protocol (MCP) для обнаружения и бронирования ресторанов. Этот сервер интегрируется с API Google Maps Places, чтобы найти рестораны на основе местоположения, предпочтений кухни, настроения и типа события, а затем предоставляет интеллектуальные рекомендации и помощь в бронировании.

Ключевые особенности

Умный ресторан: Найдите рестораны в радиусе 20 км с улучшенной фильтрацией Местоположение тайваньского дефолта: автоматический поиск по Тайваню (24.1501164, 120.6692299), когда координаты не указаны Рекомендации на основе ИИ: Получите топ-3 предложений ресторана с подробным обоснованием Интеграция Google Maps: Реальные данные ресторана, включая рейтинги, обзоры и фотографии Конкретное совпадение событий: оптимизировано для знакомств, семейных встреч, деловых встреч и торжеств ** Фильтрация на основе настроения**: Найдите рестораны, соответствующие романтической, повседневной, высококлассной, веселой или тихой атмосфере ** Помощь в бронировании**: Получите инструкции по бронированию и возможности макета бронирования

Особенности

Умный ресторанный поиск **: Найдите рестораны в радиусе 20 км в зависимости от местоположения, типа кухни, настроения и типа мероприятия

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Restaurant Booking MCP Server

An AI-powered Model Context Protocol (MCP) server for restaurant discovery and booking. This server integrates with Google Maps Places API to find restaurants based on location, cuisine preferences, mood, and event type, then provides intelligent recommendations and booking assistance.

🎯 Key Features

  • Smart Restaurant Search: Find restaurants within 20km radius with advanced filtering
  • Default Taiwan Location: Automatically searches around Taiwan (24.1501164, 120.6692299) when no coordinates specified
  • AI-Powered Recommendations: Get top 3 restaurant suggestions with detailed reasoning
  • Google Maps Integration: Real restaurant data including ratings, reviews, and photos
  • Event-Specific Matching: Optimized for dating, family gatherings, business meetings, and celebrations
  • Mood-Based Filtering: Find restaurants matching romantic, casual, upscale, fun, or quiet atmospheres
  • Booking Assistance: Get reservation instructions and mock booking capabilities

Features

  • 🔍 Smart Restaurant Search: Find restaurants within 20km radius based on location, cuisine types, mood, and event type
  • 📍 Google Maps Integration: Real restaurant data with ratings, reviews, photos, and contact information
  • 📅 Booking Assistance: Check availability and get reservation instructions
  • 🎯 Event-Specific Matching: Optimized recommendations for dating, family gatherings, business meetings, etc.
  • 🎭 Mood-Based Filtering: Find restaurants that match your desired atmosphere (romantic, casual, upscale, etc.)

Prerequisites

  • Node.js 18+
  • Google Maps API Key with Places API enabled
  • TypeScript knowledge for customization

Installation

  1. Clone or download this project

    git clone 
    cd mcp-restaurant-booking
    
  2. Install dependencies

    npm install
    
  3. Set up environment variables

    cp .env.example .env
    

    Edit .env and add your Google Maps API key:

    GOOGLE_MAPS_API_KEY=your_actual_api_key_here
    
  4. Build the project

    npm run build
    

Getting Google Maps API Key

  1. Go to Google Cloud Console
  2. Create a new project or select existing one
  3. Enable the following APIs:
    • Places API
    • Maps JavaScript API
    • Geolocation API
    • Places API (New)
    • Geocoding API
  4. Create credentials (API Key)
  5. Restrict the API key to the enabled APIs for security

Usage

Running the Server

Development mode:

npm run dev

Production mode:

npm start

Running in Docker

To run the MCP Restaurant Booking server in Docker:

# Build the Docker image
Открыть полный README на GitHub

Установка

docker run --rm -i mcp/booking
Новичок в MCP? Начните с руководства на mcpskill.org →