🚀 MCPizza - 达美乐披萨订购MCP服务器
MCP（模型上下文协议）服务器，它使AI助手能够利用非官方的达美乐API订购披萨。
🚀 快速开始
你可以通过以下命令使用模拟数据查看它的实际运行效果：
# 使用模拟数据查看实际运行效果
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 |
查找最近的达美乐门店 |
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
})
⚠️ 安全提示与免责声明
⚠️ 重要提示
- 为了安全起见，默认情况下禁止实际下单。
- 仅出于教育目的使用非官方的达美乐API。
- 除了最终下单步骤外，所有订单功能均可正常使用。
- 请负责任地使用，并遵守达美乐的服务条款。
🔧 集成
该服务器已准备好与MCP客户端集成！它提供了完整的披萨订购工作流程，同时通过禁用下单功能来确保安全。
📝 要求
- Python 3.9及以上版本。
- 用于访问达美乐API的
pizzapi包。 - 用于查找门店的有效地址。
- 用于API调用的互联网连接。
为MCP生态系统用心打造 ❤️