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: Lumen Resto MCP

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

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)