SM

samwang0723/mcp-booking

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

16 stars 12 forks 质量 57 趋势 21MIT

预订模式上下文协议服务器

概览

一个AI动力的模型背景协议(MCP)服务器,用于餐馆的发现和预订. 这个服务器与Google Maps Places API集成,根据位置,美食喜好,心情,以及事件类型寻找餐厅,然后提供智能建议和预订协助. - 在20公里半径以内找到餐馆,进行高级过滤 - :在没有指定坐标时,在台湾周围自动搜索(24.1501164、120.6692299) - :获得3个最高级的餐厅建议,并详细推理 - :真正的餐厅数据,包括收视率、评论和照片 - :优化约会、家庭聚会、商务会议和庆祝活动 - :寻找符合浪漫、随意、升级、有趣或安静气氛的餐厅 - :获得预订指示和模拟预订能力 - QQ:根据位置,烹饪类型,心情,以及事件类型,在20公里半径范围内寻找餐厅 - QQ:有收视率,评论,相片,以及联系方式的真实餐厅数据 - QQ:检查...

概述(AI 翻译)

一个AI动力的模型背景协议(MCP)服务器,用于餐馆的发现和预订. 这个服务器与Google Maps Places API集成,根据位置,美食喜好,心情,以及事件类型寻找餐厅,然后提供智能建议和预订协助.

# # 关键特性

  • 智能饭店搜索**: 在半径20公里范围内找到有高级过滤器的餐厅
  • ** 台湾站点**:在没有指定坐标时,在台湾周围自动搜索(24.1501164、120.6692299)
  • ** AI授权建议**:获得有详细推理的3个最佳餐厅建议
  • 谷歌地图集成: 真正的餐厅数据,包括收视率、评论和相片
  • ** 具体匹配**:优化约会、家庭聚会、商务会议和庆祝活动
  • ** 以地雷为基础的过滤**: 寻找符合浪漫、随意、上层、有趣或安静气氛的餐厅
  • ** 订货援助**:获得预订指示和模拟订货能力

□ 特性

  • 🔍 m m 根据位置、烹饪类型、心情和事件类型在半径20公里范围内找到餐厅

本页由 AI 翻译,技术细节请以原文为准。

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
在 GitHub 查看完整 README

安装

docker run --rm -i mcp/booking
新手?先看 mcpskill.org 教程 →