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