金大哥 - mcpizza MCP 详情

article

README

🚀 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生态系统用心打造 ❤️

mcpizza