告诉它你今天的心情，它按「情绪-饮食」推荐原则在麦当劳菜单里搭好一套最契合当下情绪的餐品，你确认后直接下单。 预算与优惠券匹配算价是可选的辅助项——想省就帮你把券配齐，不在意价格就直接看餐。 基于麦当劳 MCP + 腾讯 WorkBuddy Skill 构建，无自建后端——源代码即 SKILL.md 及其参考文档。

点麦当劳的真正成本不是钱，是决策：今天吃什么、怎么搭、怎么用券最省。本项目把这三件事交给一个 Skill：

• 按心情荐餐：先问你今日心情（开心 / 平静 / 疲惫 / 焦虑 / 低落 / 生气 / 无聊），结合预算、时段、取餐方式给出搭配结论，并附一句可解释的理由。
• 三层漏斗推荐原则：即时情绪诉求 → 营养构成优选 → 硬约束过滤（单餐热量上限、情绪化进食保护），依据见 docs/情绪饮食关联依据与推荐算法设计原则.md。
• 省钱辅助（可选）：用户有预算或省钱诉求时，拉取门店可用券，多方案对比原价 / 券后价 / 省多少；不在意价格就跳过，不强推。
• 确认后下单：写操作一律先复述订单、取得确认，再经 MCP 创建订单返回支付链接。

.
├── SKILL.md                              # Skill 主体：五步工作流 + 安全约束
├── references/
│   ├── mcd-tools.md                      # mcd-mcp 工具速查表（核验记录 + 官方工具清单）
│   └── 情绪饮食关联依据与推荐算法设计原则.md  # 推荐算法依据（随 Skill 打包副本）
├── docs/情绪饮食关联依据与推荐算法设计原则.md  # 算法依据（母本文档）
├── README.md                             # 本文件
├── MCP_INTEGRATION.md                    # 麦当劳 MCP 集成说明
├── CONTEST_DECLARATION.md                # 参赛声明（官方原文）
├── mcp-config.example.json               # 脱敏 MCP 配置示例（仅环境变量占位符）
└── workbuddy.md                          # WorkBuddy 开发过程记录（联动活动核验）

• 每天纠结「今天吃什么」的上班族与学生——想按当下心情选餐的人（核心用户）。
• 麦当劳会员用户（麦享会积分 / 麦麦省券持有者）——顺带想省一笔的，优惠匹配是加分项。
• 正在使用腾讯 WorkBuddy、希望用自然语言完成点餐全链路的用户。

1. 访问 open.mcd.cn/mcp，右上角【登录】，使用手机号验证登录。
2. 打开【控制台】→【激活】，阅读并同意服务协议，申请 MCP Token 并复制。

Token 代表你的麦当劳会员身份，请勿泄露、勿提交进公开仓库。

1. 打开 WorkBuddy，左侧边栏【专家·技能·连接器】→【连接器】页签。
2. 右上角【自定义连接器】→【配置MCP】，粘贴 mcp-config.example.json 的内容，把 ${MCD_MCP_TOKEN} 替换为实际 Token，点击保存。
3. 回到【自定义连接器】，将 mcd-mcp【启用】。

本仓库根目录即为 Skill 本体（SKILL.md + references/ + docs/）。

• 全局使用（推荐）：将本仓库整个目录复制（或 git clone）到 ~/.workbuddy/skills/ 下，WorkBuddy 即可通过自然语言唤起。
• 项目内共享使用：把本仓库放进某项目的 .workbuddy/skills/ 目录下，该项目内的对话即可自动发现该技能。

示例 1：按心情 + 预算荐餐

你：今天有点累，预算 30 元以内，想吃点热乎的

助手：好的——累了的时候适合来点热乎的。这家店的「热香饼套餐」热食为主、份量适中，券后 ¥24.5，省 ¥6；另外搭一杯无糖可乐比配奶铁再省 3 元。要不要看这两个方案？

调用链路：now-time-info（时段）→ query-nearby-stores（门店）→ query-meals / query-meal-detail（选品）→ query-store-coupons（可用券）→ calculate-price（算价）→ 你确认 → create-order。

示例 2：用券最省

你：附近门店，帮我用最省的方式点麦辣鸡腿堡套餐，看看有什么券能用

助手会对比「直接买 / 用券 / 换套餐组合」多个方案，给出券后总价与节省金额。

示例 3：预约 + 健康约束

你：明天中午 12 点取，我最近在控卡路里

助手会用 list-nutrition-foods 核对热量是否超上限（默认 1000 kcal 硬约束），并优先蛋白质占比更高的组合。

安全说明：create-order 等写操作一律在你明确确认订单内容与金额之后才执行；下单后可用 query-order 查进度、cancel-order 取消。

营养与价格信息以麦当劳官方接口实时结果为准；本项目输出仅供参考，不构成医疗或营养建议。本项目为麦当劳程序员创意开发大赛参赛作品，由参赛者独立开发，非麦当劳官方产品。