booking-mcp

booking-mcp — это сервер Model Context Protocol для управления бронированием столиков в ресторане, предоставляемый через Streamable HTTP. Он включает инструменты для бронирования столика, проверки доступности и отмены брони; ресурсы для чтения книги бронирований; а также промпт для составления подтверждений. При бронировании сервер собирает контактные данные гостя, запрашивая их у пользователя.

Требования

• Python 3.13

• uv

Related MCP server: Lumen Resto MCP

Использование

Настройка

Создайте виртуальное окружение, установите SDK (mcp[cli,rich]) и зависимости, а затем установите пакет в режиме редактирования:

uv sync

Сервер

Запустите сервер, который обслуживает Streamable HTTP по адресу http://127.0.0.1:8000/mcp:

uv run booking-mcp

Пошаговое руководство

Автономный интерактивный клиент, работающий в процессе, поэтому больше ничего запускать не нужно. Он предоставляет меню действий и позволяет самостоятельно отвечать на уточняющие запросы.

uv run python scripts/walkthrough.py

[!TIP]

Брони по умолчанию сохраняются в var/bookings.json. Установите BOOKING_DB_PATH, чтобы хранить их в другом месте:

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

Интерфейс MCP

Структура

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)