Skip to main content
Glama
booking-mcp

booking-mcp

by LuoZihYuan

booking-mcp

booking-mcp ist ein Model Context Protocol-Server für die Verwaltung von Restaurantreservierungen, der über Streamable HTTP bereitgestellt wird. Er stellt Tools zum Buchen eines Tisches, zum Prüfen der Verfügbarkeit und zum Stornieren einer Reservierung bereit; Ressourcen zum Lesen des Reservierungsbuchs; und einen Prompt zum Entwerfen von Bestätigungen. Beim Buchen holt der Server die Kontaktdaten des Gasts durch Rückfragen beim Benutzer ein.

Voraussetzungen

  • Python 3.13

  • uv

Related MCP server: mcp-booking-bridge

Verwendung

Einrichtung

Erstellen Sie die virtuelle Umgebung, installieren Sie das SDK (mcp[cli,rich]) und die Abhängigkeiten und installieren Sie das Paket im bearbeitbaren Modus:

uv sync

Server

Starten Sie den Server, der Streamable HTTP unter http://127.0.0.1:8000/mcp bereitstellt:

uv run booking-mcp

Durchlauf

Ein eigenständiger interaktiver Client, der prozessintern läuft, sodass nichts anderes laufen muss. Er bietet Ihnen ein Aktionsmenü und ermöglicht es Ihnen, die Rückfragen selbst zu beantworten.

uv run python scripts/walkthrough.py

[!TIP]

Reservierungen werden standardmäßig in var/bookings.json gespeichert. Setzen Sie BOOKING_DB_PATH, um sie an einem anderen Ort zu speichern:

BOOKING_DB_PATH=/tmp/demo.json uv run python scripts/walkthrough.py

MCP-Schnittstelle

Art

Name

Beschreibung

Tool

book_table(date, time, party_size)

erfragt Name, Telefonnummer und Anmerkungen vom Benutzer

Tool

cancel_booking(id)

markiert eine Reservierung als storniert

Tool

check_availability(date, time)

verbleibende Tische für ein Zeitfenster

Ressource

bookings://all

alle Reservierungen als JSON

Ressource

bookings://{id}

eine Reservierung als JSON

Ressource

availability://{date}

Kapazität für jedes Zeitfenster an einem Datum, als JSON

Prompt

confirmation_message(id)

entwirft eine Bestätigungsnachricht für den Gast

Projektstruktur

booking-mcp/
├── src/booking_mcp/
│   ├── app.py               # the shared MCPServer instance
│   ├── config.py            # storage path + capacity limits
│   ├── models.py            # Reservation domain model
│   ├── store.py             # JSON file repository
│   ├── server.py            # entrypoint: registers features, runs the server
│   └── features/
│       ├── reservations.py  # book/cancel + reservation resources + prompt
│       └── availability.py  # availability tool + resource
├── scripts/
│   └── walkthrough.py       # manual interactive client
└── var/                     # runtime state, gitignored (holds bookings.json)

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables restaurant reservation management through SevenRooms API, allowing users to create reservations and query available time slots with guest details and party size information.
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables managing restaurant table bookings through natural language conversations with an AI assistant, with built-in safety measures like no deletion and explicit write enable.
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to manage restaurant reservations through typed MCP tools, including checking table availability, creating and canceling reservations, and listing the day's confirmed bookings.
    -