mcpField
R
Restaurante MCP - Ejemplo

Restaurante MCP - Ejemplo

Local
github.com/CharlytocDeveloper Tools3Updated 73w ago

About Restaurante MCP - Ejemplo

A sample conversational restaurant built with Python, OpenAI GPT, and MCP. It is aimed at demonstrating restaurant workflows, with table-based orders and a mock payment link.

Key features

  1. 01View and edit the digital menu
  2. 02Add, remove, and view table orders
  3. 03Clear orders for a table
  4. 04Calculate the bill total
  5. 05Generate a mock payment link

Use cases

  1. 01Demonstrate MCP-based restaurant ordering
  2. 02Manage customer orders by table
  3. 03Test conversational dining workflows

MCP support

The MCP server exposes tools for viewing the menu, managing orders, calculating bills, and generating a mock payment link.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Restaurante MCP - Ejemplo

Este repositorio demuestra un restaurante digital conversacional usando MCP (Model Context Protocol), Python, y OpenAI GPT.


🚀 Descripción

  • Menú digital con emojis 🍕🍔
  • Pedidos por mesa (¡hasta 10 mesas simultáneas, peor puede ser cualquier número!)
  • Comandos útiles para limpiar, cambiar de mesa, ayuda, etc.
  • Mock de link de pago
  • Cliente conversacional potenciado con GPT y herramientas MCP

⚡ Instalación y primer uso

Requisito: Tener instalado uv (guía oficial de instalación)

1. Clona el repositorio
git clone https://github.com/Charlytoc/mcp-server-client.git
cd mcp-server-client
2. Configura tu API KEY de OpenAI

Crea un archivo .env en la raíz y agrega:

OPENAI_API_KEY=sk-...
3. Ejecuta el proyecto
bash start.sh

Este comando:

  • Crea y activa el entorno virtual (si no existe)
  • Instala dependencias automáticamente con uv
  • Lanza el servidor y el cliente en terminal interactiva

📝 Estructura principal

  • server.py → Lógica del restaurante y API MCP
  • client.py → Cliente conversacional
  • management/menu.csv → Menú editable (¡puedes usar emojis!)
  • management/pedidos.csv → Pedidos por mesa (se genera solo)
  • start.sh → Script de arranque automático

💡 Objetivo

El objetivo de este proyecto es demostrar cómo se puede usar MCP para crear un restaurante digital conversacional de una forma sencilla y sin necesidad de grandes conocimientos de IA.


📋 Ejemplo de menú con emojis

id,nombre,precio
1,🍕 Pizza,120
2,🍔 Hamburguesa,80
3,🥗 Ensalada,60
4,🍪 Cookie de Oreo,10
5,🥖 Pan de Jamón,30
# ... y más

🛠️ Personaliza el menú

Edita el archivo management/menu.csv para agregar, quitar o modificar productos.
Puedes usar emojis en los nombres para hacerlo más visual.


🧪 Funcionalidades MCP disponibles

  • Ver menú
  • Agregar pedido
  • Eliminar pedido
  • Limpiar pedidos de una mesa
  • Ver pedidos de una mesa
  • Calcular total de la cuenta
  • Generar link de pago mock

⚠️ Notas técnicas

  • Si el puerto 8080 aparece ocupado, puedes liberarlo con:
    • netstat -ano | findstr :8080 (ver PID)
    • taskkill /PID <PID> /F (matar proceso)
  • El entorno virtual y dependencias se gestionan automáticamente por start.sh usando uv.
  • El script detecta el sistema operativo para guiar la instalación de uv si falta.

📣 Créditos


¿Dudas o sugerencias?
¡Abre un issue o escribe en Discussions!


Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.