MCPizza - Domino's Pizza 订购 MCP 服务器

这是一个使用非官方 Domino's API 的 MCP（模型上下文协议）服务器，使AI助手能够订购披萨。

🍕 功能

• 店铺定位器：通过地址或邮政编码查找最近的Domino's店铺
• 菜单浏览：搜索披萨、鸡翅、配菜等
• 订单管理：添加商品到购物车并计算总价
• 客户信息：处理配送地址和联系方式
• 安全预览：准备订单而不实际下单（安全第一！）

🚀 快速演示

# 使用模拟数据查看效果
python mcpizza/demo_no_real_api.py

📦 安装

请参阅INSTALLATION.md获取详细的安装说明。

快速开始：

# 安装 uv 包管理器
curl -LsSf https://astral.sh/uv/install.sh | sh

# 设置环境
uv venv && source .venv/bin/activate
uv pip install pizzapi requests pydantic

# 运行演示
python mcpizza/demo_no_real_api.py

🛠 可用的 MCP 工具

工具	描述
find_dominos_store	查找最近的Domino's位置
get_store_menu_categories	获取菜单类别
search_menu	搜索特定的菜单项
add_to_order	将商品添加到您的披萨订单中
view_order	查看当前订单内容
set_customer_info	设置配送信息
calculate_order_total	获取订单总价（含税/费用）
prepare_order	准备订单以供放置（安全模式）

🎯 使用示例

# 查找店铺
result = server.call_tool("find_dominos_store", {"address": "10001"})

# 搜索披萨
result = server.call_tool("search_menu", {"query": "pepperoni pizza"})

# 添加到订单
result = server.call_tool("add_to_order", {
    "item_code": "M_PEPPERONI",
    "quantity": 1
})

⚠️ 安全与免责声明

• 默认情况下，实际下单功能是禁用的，以确保安全
• 仅用于教育目的，使用非官方的Domino's API
• 除了最终下单步骤外，所有订单功能均可用
• 请负责任地使用，并遵守Domino's的服务条款

🔧 集成

准备好与MCP客户端集成！该服务器提供完整的披萨订购流程，同时通过禁用下单功能来保证安全性。

📝 要求

• Python 3.9+
• pizzapi 包用于访问Domino's API
• 有效的地址用于查找店铺
• 网络连接用于API调用

---

由 ❤️ 为MCP生态系统打造