booking-mcp

booking-mcp is a Model Context Protocol server for managing restaurant reservations, served over Streamable HTTP. It exposes tools to book a table, check availability, and cancel a reservation; resources to read the reservation book; and a prompt for drafting confirmations. When booking, the server gathers the guest's contact details from the user through elicitation.

Requirements

• Python 3.13

• uv

Related MCP server: Lumen Resto MCP

Usage

Setup

Create the virtual environment, install the SDK (mcp[cli,rich]) and dependencies, and install the package in editable mode:

uv sync

Server

Start the server, which serves Streamable HTTP at http://127.0.0.1:8000/mcp:

uv run booking-mcp

Walkthrough

A standalone interactive client that runs in process, so nothing else needs to be running. It gives you a menu of actions and lets you answer the elicitation prompts yourself.

uv run python scripts/walkthrough.py

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

MCP surface

Layout

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)