booking-mcp

booking-mcp es un servidor de Protocolo de Contexto de Modelo para gestionar reservas de restaurantes, servido sobre HTTP Streamable. Expone herramientas para reservar una mesa, comprobar disponibilidad y cancelar una reserva; recursos para leer el libro de reservas; y un prompt para redactar confirmaciones. Al reservar, el servidor recopila los datos de contacto del huésped del usuario mediante elicitación.

Requisitos

• Python 3.13

• uv

Related MCP server: Lumen Resto MCP

Uso

Configuración

Crea el entorno virtual, instala el SDK (mcp[cli,rich]) y las dependencias, e instala el paquete en modo editable:

uv sync

Servidor

Inicia el servidor, que sirve HTTP Streamable en http://127.0.0.1:8000/mcp:

uv run booking-mcp

Tutorial

Un cliente interactivo independiente que se ejecuta en el proceso, por lo que no necesita que nada más esté en ejecución. Te ofrece un menú de acciones y te permite responder tú mismo a las solicitudes de elicitación.

uv run python scripts/walkthrough.py

[!TIP]

Las reservas se guardan en var/bookings.json por defecto. Establece BOOKING_DB_PATH para almacenarlas en otro lugar:

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

Superficie MCP

Estructura

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)