AI导哈

餐厅后端协议服务器

用于与餐厅FastAPI后端交互的MCP服务器，提供菜单管理、订单管理、客户管理等功能。

  • by PasanIS
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 PasanIS/mcp-server

使用说明

餐厅后端MCP服务器

MCP（模型上下文协议）服务器，用于与餐厅FastAPI后端交互。

安装

cd mcp-servers/backend-mcp
uv sync

配置

更新src/backend_mcp/server.py中的BASE_URL，以匹配您的FastAPI后端URL：

(python)
BASE_URL = "http://localhost:8000"  # Change this to your backend URL

可用工具

菜单管理

  • get_menu_items-使用过滤器浏览菜单项
  • get_menu_item_details-获取详细的项目信息
  • create_menu_item-添加新菜单项（仅限员工）
  • update_menu_item-更新现有项目（仅限员工）

订单管理

  • create_order-下新订单
  • get_order_details-获取订单信息
  • get_customer_orders-获取客户的所有订单
  • get_orders_by_status-按状态筛选订单
  • update_order_status-更新订单状态
  • get_order_journey-查看订单状态历史记录
  • get_filtered_orders-高级订单过滤

客户管理

  • register_customer-创建新客户帐户
  • get_customer_profile-获取客户信息
  • update_customer_profile-更新客户详细信息
  • customer_login-验证客户身份

促销码

  • apply_promo_code-验证和计算折扣
  • get_promo_details-获取促销代码信息

评论

  • get_order_reviews-获取订单评论
  • create_review-提交评论

分析

  • get_dashboard_stats-总体统计数据
  • get_popular_items-订购最多的商品
  • get_revenue_starts-收入分析

员工运营

  • staff_login-员工身份验证

系统

  • check_backend_health-后端健康检查

运行服务器

用于开发/测试

uv run python -m backend_mcp.server

作为MCP服务器（用于克劳德桌面）

添加到您的Claude Desktop配置中：

(.json)
{
  "mcpServers": {
    "restaurant-backend": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/mcp-servers/backend-mcp",
        "run",
        "backend-mcp"
      ]
    }
  }
}

测试

uv run python test_server.py
**Make sure your FastAPI backend is running before testing.

环境变量

您可以使用环境变量覆盖后端URL：

export BACKEND_URL="http://<your-backend-url>:8000"

建筑

Chatbot (Claude) 
    ↓ (MCP Protocol)
Backend MCP Server
    ↓ (HTTP/REST)
FastAPI Backend
    ↓
Database

下一步

  • 为直接SQL操作创建数据库MCP服务器 实施身份验证/授权
  • 添加错误处理和重试逻辑
  • 为频繁访问的数据添加缓存

相关 MCP