Mcpizza

🚀 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工具

💻 使用示例

基础用法

# 查找门店
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生态系统用心打造 ❤️