Addition2000/mcd-diet-guard

选用指南

AI 根据 README 整理 · 2026/10/24 05:26:35

目标用户

适合有饮食禁忌、食物过敏或口味挑剔的人，也适合帮别人点餐的人。

查看 README 依据

{"code": "100160", "key": "0-1", "quantity": 1}, {"code": "100168", "key": "0-1", "quantity": 1}, {"code": "100214", "key": "0-1", "quantity": 1}, {"code": "103386", "key": "0-0", "quantity": 1} ]}} ``` （`103386` 培根传 `unselectedKey`，其余配料保留。） ## 目标用户 - **有饮食禁忌的人**：不吃猪肉（包括有清真需求的朋友，工具会如实说明边界）、不吃牛肉、素食者。 - **有食物过敏或不耐受的人**：海鲜、蛋、奶、麸质、芝麻、坚果；乳糖不耐。 - **口味挑剔的人**：不吃辣、不吃洋葱、不吃酸黄瓜、晚上不想喝咖啡因。 - **帮别人点餐的人**：给朋友、同事、家人拼单，每个人忌口都不一样。 ## 安装 ### 1. 申请麦当劳 MCP Token 登录 [麦当劳 MCP 开放平台](https://open.mcd.cn/mcp) → 控制台 → 激活并复制 MCP Token。 ### 2. 在智能体里配置 MCP

使用方式

通过命令行或智能体使用，支持整店扫描、多人分组推荐、Plan生成下单参数、check按名称快速判断、card生成沟通卡。

查看 README 依据

git clone https://github.com/Addition2000/mcd-diet-guard.git cd mcd-diet-guard export MCD_MCP_TOKEN=你的Token # Windows PowerShell: $env:MCD_MCP_TOKEN="你的Token" S=skills/mcd-diet-guard/scripts/mcd_diet.py python $S profiles # 查看支持的忌口 python $S stores --city 上海 --keyword 人民广场 # 找门店，拿 storeCode python $S scan --store <storeCode> --diet 不吃猪肉 # 整店扫描 python $S scan --store <storeCode> --diet 素食 --reservation "2026-10-26 08:00" # 看明早早餐 python $S group --store <storeCode> --person "小王:清真" --person "小李:素食,不吃辣"

部署要求

需要申请麦当劳MCP Token并配置到智能体；命令行使用需Python 3.8+。

查看 README 依据

{"code": "100160", "key": "0-1", "quantity": 1}, {"code": "100168", "key": "0-1", "quantity": 1}, {"code": "100214", "key": "0-1", "quantity": 1}, {"code": "103386", "key": "0-0", "quantity": 1} ]}} ``` （`103386` 培根传 `unselectedKey`，其余配料保留。） ## 目标用户 - **有饮食禁忌的人**：不吃猪肉（包括有清真需求的朋友，工具会如实说明边界）、不吃牛肉、素食者。 - **有食物过敏或不耐受的人**：海鲜、蛋、奶、麸质、芝麻、坚果；乳糖不耐。 - **口味挑剔的人**：不吃辣、不吃洋葱、不吃酸黄瓜、晚上不想喝咖啡因。 - **帮别人点餐的人**：给朋友、同事、家人拼单，每个人忌口都不一样。 ## 安装 ### 1. 申请麦当劳 MCP Token 登录 [麦当劳 MCP 开放平台](https://open.mcd.cn/mcp) → 控制台 → 激活并复制 MCP Token。 ### 2. 在智能体里配置 MCP

参考 [`mcp-config.example.json`](./mcp-config.example.json)： ```json { "mcpServers": { "mcd-mcp": { "type": "streamablehttp", "url": "https://mcp.mcd.cn", "headers": { "Authorization": "Bearer ${MCD_MCP_TOKEN}" } } } } ``` 把 `${MCD_MCP_TOKEN}` 换成你的 Token（或在支持环境变量的客户端里设置该变量）。**不要把真实 Token 提交到任何仓库。** ### 3. 安装 Skill 把 [`skills/mcd-diet-guard`](./skills/mcd-diet-guard) 整个文件夹放进智能体的技能目录（支持 `SKILL.md` 格式的智能体都可以使用，例如 WorkBuddy、Claude Code 等），然后直接用自然语言提需求即可。 ### 4.（可选）命令行使用 只需要 Python 3.8+，无需安装任何第三方包： ```bash

已知限制

不判断清真，不提供官方过敏原数据，无法排除交叉接触；结果基于名称和配料推断，严重过敏需向门店确认。脚本不自动下单，需用户确认。

查看 README 依据

单品：名称 + 特调配料 套餐：逐轮逐个子项判定 │ │ 主料冲突→❌ 配料冲突且可去→🔧去掉 每轮挑默认/最低差价的可吃项 可能含→⚠️ 都没问题→✅ 某轮全冲突→❌ └────────────────┬────────────────┘ 推荐 ──► calculate-price ──► 用户确认 ──► create-order ──► query-order 核对 ``` 详细的 MCP 工具使用与调用流程见 [MCP_INTEGRATION.md](./MCP_INTEGRATION.md)，判定规则写在 [`references/knowledge.json`](./skills/mcd-diet-guard/references/knowledge.json)，可以自行扩充。 ## 安全与边界 - **不判断清真**：只能排除含猪肉成分的餐品；清真还涉及屠宰方式与交叉接触，MCP 不提供相关认证信息，工具会明确告知。

- **不是官方过敏原数据**：结果基于餐品名称和 MCP 返回的可见配料推断，无法排除共用设备造成的交叉接触。过敏者只看名称时一律标为“需确认”，严重过敏请向门店确认。 - **宁可错杀**：识别不出主料的餐品不会被标为放心；“香肠”一律按含猪肉处理。 - **下单前必须确认**：生成参数、试算价格都不会产生订单；只有你说“确认下单”后智能体才会调用 `create-order`。 - **Token 不落盘**：脚本只从环境变量 `MCD_MCP_TOKEN` 读取 Token。 ## 项目结构 ``` . ├── README.md # 本文件 ├── CONTEST_DECLARATION.md # 参赛声明（官方原文） ├── MCP_INTEGRATION.md # 使用的 MCP Server / Tool / 调用流程 / 业务价值 ├── mcp-config.example.json # 脱敏的 MCP 配置示例（仅环境变量占位符） ├── .env.example ├── skills/mcd-diet-guard/ │ ├── SKILL.md # Skill 主说明：工作流程、判定规则、下单规则、安全规则