Restaurante MCP - Ejemplo

餐厅 MCP - 示例

此仓库演示了一个使用 MCP（Model Context Protocol）、Python 和 OpenAI GPT 构建的对话式数字餐厅。

---

🚀 描述

• 带有表情符号 🍕🍔 的数字菜单
• 按餐桌下单（最多可同时使用 10 张餐桌，不过也可以是任意数量！）
• 清空、更换餐桌、获取帮助等实用命令
• 模拟支付链接
• 由 GPT 和 MCP 工具驱动的对话式客户端

---

⚡ 安装和首次使用

要求： 已安装 uv（官方安装指南）

1. 克隆仓库

git clone https://github.com/Charlytoc/mcp-server-client.git
cd mcp-server-client

2. 配置你的 OpenAI API 密钥

在根目录中创建一个 .env 文件，并添加：

OPENAI_API_KEY=sk-...

3. 运行项目

bash start.sh

此命令会：

• 创建并激活虚拟环境（如果尚不存在）
• 使用 uv 自动安装依赖项
• 在交互式终端中启动服务端和客户端

---

📝 主要结构

• server.py → 餐厅逻辑和 MCP API
• client.py → 对话式客户端
• management/menu.csv → 可编辑菜单（可以使用表情符号！）
• management/pedidos.csv → 按餐桌记录的订单（自动生成）
• start.sh → 自动启动脚本

---

💡 目标

本项目旨在演示如何以简单的方式使用 MCP 创建对话式数字餐厅，无需具备丰富的 AI 知识。

---

📋 带表情符号的菜单示例

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

---

🛠️ 自定义菜单

编辑 management/menu.csv 文件，以添加、删除或修改商品。
你可以在名称中使用表情符号，让菜单更直观。

---

🧪 可用的 MCP 功能

• 查看菜单
• 添加订单
• 删除订单
• 清空某张餐桌的订单
• 查看某张餐桌的订单
• 计算账单总额
• 生成模拟支付链接

---

⚠️ 技术说明

• 如果端口 8080 已被占用，可以通过以下命令释放：
  • netstat -ano | findstr :8080（查看 PID）
  • taskkill /PID <PID> /F（结束进程）
• 虚拟环境和依赖项由 start.sh 使用 uv 自动管理。
• 如果缺少 uv，脚本会检测操作系统并引导你安装。

---

📣 致谢

• @Charlytoc 的 MCP（Model Context Protocol）示例项目
• 基于 OpenAI GPT 和 MCP

---

有疑问或建议？
欢迎提交 issue 或在 Discussions 中留言！

---