麦当劳中国助手(McDonald's China Assistant)
核心功能
本技能通过麦当劳中国官方MCP(McDonald's China Platform)API,为用户提供完整的数字化服务体验:
1. 优惠券管理
- browse/claim: 浏览可领取优惠券、一键自动领取、查看已拥有优惠券
- 支持查看优惠券有效期、使用条件及适用商品
2. 麦乐送(McDelivery)完整流程
- 地址管理: 查询/新建配送地址,获取匹配的门店信息
- 菜单浏览: 按门店查询实时菜单与价格
- 门店优惠券: 查询当前门店可用的专属优惠券
- 价格计算: 计算含优惠、运费、打包费的最终价格(注意:API返回单位为"分",需除以100)
- 下单支付: 创建订单并返回支付链接
关键流程依赖: 配送订单必须严格按序执行——delivery-query-addresses → query-meals/query-store-coupons → calculate-price(用户确认)→ create-order。storeCode和beCode必须来自同一地址记录。
3. 营养信息与智能搭配
- 查询菜单项完整营养成分:热量(kcal)、蛋白质(g)、脂肪(g)、碳水化合物(g)、钠、钙
- 支持按目标卡路里(如"帮我搭配500大卡套餐")智能组合餐食
- 强制输出格式: 营养数据必须以表格形式展示全部营养素,而非仅热量
4. 活动日历与订单追踪
- 查看近期及 upcoming 促销活动
- 通过34位订单号查询配送状态
配置要求
| 环境变量 | 必需 | 说明 |
|---------|------|------|
| `MCD_TOKEN` | ✅ | API认证令牌,从 https://mcp.mcd.cn 获取 |
| `MCD_MCP_URL` | ❌ | MCP服务端点,默认 https://mcp.mcd.cn |
显著优点
- 官方直连: 直接调用麦当劳中国官方API,数据实时准确,优惠同步
- 完整闭环: 覆盖从领券、浏览、计算、下单到追踪的全链路
- 营养透明: 提供完整macronutrient数据,满足健身/控糖/减脂人群需求
- 流程严谨: 文档详细规定了API调用顺序和参数来源,减少出错可能
潜在局限性与风险
| 方面 | 说明 |
|------|------|
| **认证门槛** | 需用户自行从 mcp.mcd.cn 获取TOKEN,有一定技术门槛 |
| **地理限制** | 仅支持麦当劳中国(大陆地区),港澳台及海外不可用 |
| **支付跳转** | 创建订单后需用户手动完成外部支付,非站内闭环 |
| **地址敏感** | `delivery-create-address` 收集姓名、电话、详细住址,需确保不记录或泄露 |
| **价格单位陷阱** | API统一返回"分",若未正确处理会导致100倍价格错误 |
| **严格流程依赖** | 跳过地址查询直接调后续API会导致必然失败 |
适合人群
- 频繁使用麦乐送、希望自动化领券比价的习惯性用户
- 健身/减脂人群,需要精确计算每餐营养素摄入
- 开发者或高级用户,能独立配置环境变量
常规风险
- 隐私: 配送地址、电话属于PII,技能明确要求"never use placeholder values",但需确保运行环境安全
- 资金安全: 虽仅生成支付链接不直接扣款,但需防范钓鱼链接伪造
- Token泄露:
MCD_TOKEN具有账户级权限,文档强调"never log or expose in output" - 订单确认: 强制要求用户确认价格后再下单,避免误操作