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生態系統用心打造 ❤️