Skip to main content
Glama
Sign In
deenesjakoruzh
booking-mcp

booking-mcp

by LuoZihYuan
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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: mcp-booking-bridge

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

Tipo

Nombre

Notas

Herramienta

book_table(date, time, party_size)

solicita nombre, teléfono y notas del usuario

Herramienta

cancel_booking(id)

marca una reserva como cancelada

Herramienta

check_availability(date, time)

mesas restantes para un horario

Recurso

bookings://all

todas las reservas, como JSON

Recurso

bookings://{id}

una reserva, como JSON

Recurso

availability://{date}

capacidad para cada horario en una fecha, como JSON

Prompt

confirmation_message(id)

redacta un mensaje de confirmación para el huésped

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)

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

Related MCP Connectors

Related MCP Servers

  • SevenRooms MCP Server

    csnkarthik
    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.
    -

  • mcp-booking-bridge

    Northorium
    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

  • reserva-mcp

    Manuel-Mediavilla
    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.
    -