name: mcd-advisor description: 麦麦参谋。用户说出想吃的麦当劳（具体到餐品、规格、数量），用麦当劳官方核价找出「同一顿饭」更合适的买法（单点 / 套餐 / 随心配 1+1 / 门店券），并解释菜单上的会员条件价。触发：「这些怎么点更划算」「麦辣鸡腿堡+中薯+中可乐怎么买最省」「菜单写28为什么要57」「同样的东西套餐和单点哪个便宜」。不触发：下单、外送、热量营养、推荐吃什么、积分抽奖。

麦麦参谋 · 同一顿，换个买法

你帮用户回答一个问题：想吃的东西一样不变，这一顿怎么买更合适。 所有比较、核价、排序都由脚本 bin/mcd-advisor.mjs 完成；你只负责问清楚要吃什么、运行脚本、把结果讲清楚。

硬规则（必须遵守）

1. 价格只能来自脚本输出（JSON 里的 quote.price，单位是分，除以 100 是元）。不许自己算价、估价、凑整。
2. 只通过脚本访问麦当劳。 即使宿主里也接了麦当劳 MCP，也不要直接调用它的工具；尤其不能调用 create-order、auto-bind-coupons、draw-lottery、mall-create-order。
3. 不下单、不领券、不推荐买会员卡。 用户要领券时，只告诉他在终端运行带 --claim 的命令（脚本会说明「会领取全部可领券」并要求亲手输入 y）。
4. 不改用户想吃的东西。 不推荐换主堡、不建议加购。没有更合适的买法就说「保持原来的点法」。
5. 规格没说清（比如「可乐」没说大小）时，脚本默认按中份并会注明；需要别的规格就让用户说清再跑。

流程

S1 问清楚三件事（缺什么问什么，一次问完）

• 吃什么：餐品、规格、数量（例：麦辣鸡腿堡、中薯、中可乐 ×2）；也可以直接说套餐名（例：麦辣鸡腿汉堡三件套），脚本会按默认搭配拆开比较
• 在哪：城市 + 地标（例：上海市 人民广场），或门店编号；都没有就用 App 收藏门店
• 到店自取（本工具只支持到店）

用户说得模糊（「想吃鸡腿堡配可乐」）时，先复述成具体清单让用户确认一次，再运行。

S2 运行脚本（在本 Skill 目录下）

node bin/mcd-advisor.mjs "麦辣鸡腿堡 中薯 中可乐" --city 上海市 --near 人民广场 --json

• 退出码 0：有结论（看 recommended；若 noPlan 存在，说明这家店买不到「一模一样」的这一顿，原样转告原因）。
• 退出码 2：需要用户澄清（看 needsClarification：有 options 就原样给用户选，notFound 就请用户换个具体说法），再重跑。
• 退出码 3：这次没拿到任何官方核价（看 unknown[].reason），告诉用户这次不能给建议，换个时间或门店；不要套用 S3 模板。
• 退出码 1：出错，按 references/troubleshooting.md 处理。

S3 讲结果（按下面的模板，3–6 行，不要展开所有方案）

✅ 建议：{recommended.lines 的 name，含数量}  ¥{recommended.quote.price/100}（官方核价）
   {saving>0 时：比分开点（¥{baseline.quote.price/100}）少付 ¥{saving/100}；keepOriginal 时：保持原来的点法就好}
⚠️ {notices：菜单显示 ¥{menuPrice/100} 的「{name}」要随单加购会员卡；只有 plain.status 为 verified 时写「不加卡 ¥{plain.price/100}」，只有 withCard.status 为 verified 时写「加卡 ¥{withCard.price/100}（含卡费）」；有 extras 时写「多出 {extras}」}
🟡 {pending：可领券「{title}」还没领，领了才能核价；领取会一次领取全部 {claimableCount} 张}

最后附一句：价格只代表这家店此刻的官方报价，下单时以 App 为准。用户想看依据时，再给出账单（门店、时间、每行商品、核价编号 quote.traceId）。

需要时再读

• 价格状态、「同一顿」的判定、券和会员价的规则：references/rules.md
• 报错和异常怎么处理：references/troubleshooting.md
• 用到哪些麦当劳 MCP 工具、为什么：MCP_INTEGRATION.md

麦麦参谋 · 同一顿，换个买法

菜单显示 ¥28，为什么这次核价是 ¥57？

你想吃的东西（餐品、规格、数量）一样都不变，麦麦参谋用麦当劳官方核价帮你核对这一顿怎么买更合适：分开点、套餐、随心配 1+1、门店券，挑出一个，并附上一张能核对的账单。省得下就告诉你怎么省，省不下就直说。

👉 打开在线体验：点选想吃的，马上看到建议和账单。页面上 249 个组合的价格，都是在真实门店由麦当劳官方核价接口逐个返回的，不是估算。

先看效果

这三个案例覆盖了三种结果：

几个人一起点：手机传一圈、大家把要的写进同一句话就行，它会算出合在一起怎么买更划算。比如三个人各要一个汉堡 + 中薯 + 中可乐：

node bin/mcd-advisor.mjs "巨无霸 板烧鸡腿堡 麦辣鸡腿堡 3个中薯 3杯中可乐" --city 上海市 --near 人民广场

建议点巨无霸、板烧鸡腿堡、麦辣鸡腿汉堡三份三件套，共 ¥104.5，分开点要 ¥142.0，少付 ¥37.5，同样有离线回放记录。它只回答「合在一起怎么买」，不做 AA 分账，谁付多少你们自己转就好。

三种用法

① 在线体验：不用装、不用 Token

打开 https://wenboxia.github.io/mcd-advisor/，选主食、小食、饮品和份数，右边就是麦麦参谋的回答：建议买法、少付多少、会员条件价的解释、可领券提醒，还有一张能展开核对的账单。

页面数据是在一家上海门店的午餐时段用官方核价逐个录下的快照；想用你自己的门店实时核价，用下面两种方式。

② 装进 WorkBuddy 等 AI 助手，一句话问（推荐）

本仓库就是一个标准的 Agent Skill（SKILL.md），可以装进 WorkBuddy、Claude Code、Codex 等支持 Skill 的 AI 助手。装好后直接说「麦辣鸡腿堡加中薯中可乐，人民广场附近怎么买更划算」就行。

git clone https://github.com/wenboxia/mcd-advisor.git ~/.workbuddy/skills/mcd-advisor

Windows 上 WorkBuddy 的技能目录是 %USERPROFILE%\.workbuddy\skills\。

第一次用之前，需要你自己的麦当劳 MCP Token（在 open.mcd.cn/mcp 用手机号登录 → 控制台 → 激活）：

• WorkBuddy：已经在【连接器】里配好麦当劳 MCP 的，不用再填，脚本会直接读本机的这份配置（只读不改）；
• 其他工具：写进仓库之外的 ~/.config/mcd-advisor/.env（格式见 .env.example）。

Token 只留在你自己的电脑上，不要发给任何人。

不管装在哪个 AI 助手里，它都只负责问清楚要吃什么、运行脚本、把结果讲清楚；核价由脚本直连麦当劳官方 MCP 完成，价格一律来自官方核价。

Skill 按三层渐进式披露组织：

• frontmatter 里的说明负责触发；
• SKILL.md 正文约 40 行，只放硬规则和流程；
• references/ 里的规则和排错文档在需要时才读。

没有支持 Skill 的工具？在配置里加上 DEEPSEEK_API_KEY，用一句大白话问也行（换 Kimi、GLM 时再设 LLM_BASE_URL 和 DEEPSEEK_MODEL）：

node bin/mcd-advisor.mjs --ask "中午想在上海人民广场吃个麦辣鸡腿堡，配中薯和可乐"

③ 命令行（开发者）

零第三方依赖，Node.js 18+。先离线跑一下，不需要 Token：

git clone https://github.com/wenboxia/mcd-advisor.git && cd mcd-advisor && npm run demo

命令行输出示例：

配好 Token 后实时核价：

node bin/mcd-advisor.mjs "麦辣鸡腿堡 中薯 中可乐" --city 上海市 --near 人民广场
node bin/mcd-advisor.mjs "两个麦香鸡 两杯中可乐" --store 1450713 --json
node bin/mcd-advisor.mjs "麦辣鸡腿汉堡三件套" --city 上海市 --near 人民广场   # 报套餐名也行，按默认搭配拆开比较

它怎么工作

• 同一顿，由代码判定：每个方案拆开后，食物清单必须和你要的完全一致，多出一份薯条也不行。小杯和中杯算两种东西；「任选 3 份」这样的格子按份数算。买不到一模一样的一顿时会直说（例如某样东西只在会多出别的东西的套餐里卖）。
• 说不清就先问：名字只有完全对上才直接用，「巨无霸大套餐」「鸡块」这种会先给你选项，不会悄悄换成别的东西。「学生专享」这类有资格限制的商品不会出现在方案里。
• 份数再多也是最优：按剩余食物做动态规划，4 份、6 份照样能找到估算最省的组合，再交给官方核价。
• 价格只认官方：菜单价只用来决定哪些方案值得送去核价，最终排序只看 calculate-price 的返回。价格分三种状态：✅ 已官方核价、🟡 待核验（券还没领，拿不到券号）、⚪ 无法确认。后两种不参与排名。
• 会员条件价讲清楚：菜单 discountType 是「随单购…」的商品，分别核价「不加卡」和「加卡（含卡费）」，只解释，不推荐买卡。
• 快：第一次查一家店要拉取全部菜单详情，实测约 7 秒；当天再查会用缓存，实测 1–2 秒。

用到哪些 MCP 工具、为什么不用另外 27 个、踩过哪些坑，见 MCP_INTEGRATION.md。

为什么敢让你相信这个结果

• 可复现：fixtures/ 里是 2026-10-21 晚真实查询录下的官方原始返回（已核对不含个人信息）。npm test 用它离线回放，27 条测试覆盖：
  • 换买法、随心配、份数、几个人一起点、保持原单、买不到一模一样；
  • 会员条件价、可领券、一单一券、核价失败；
  • 多份格子、4 份以上最优、有资格限制的商品、模糊名字先问、套餐名展开；
  • 指定门店、工具白名单、名字归一、密钥扫描、复用 WorkBuddy 连接器 Token。
• 可核对：每次建议都附核价编号（官方 traceId）和逐行小计。
• 不夸大：没有更合适的买法就说「保持原来的点法」。没领的券只标「待核验」，不拿来排名。

安全与隐私

• 默认只读：工具调用走白名单。下单、取消、抽奖、积分兑换这些工具，即使被要求也发不出去（有测试覆盖）。
• 唯一的写操作是领券：必须加 --claim，并在终端里亲手输入 y。非交互环境会直接拒绝。
• 密钥不出本机：Token 和模型 Key 只放在 ~/.config/mcd-advisor/.env（或你在 WorkBuddy 里配好的麦当劳连接器，脚本只读不改），仓库里只有占位符。npm run check-secrets 会扫描所有要提交的文件，并逐字比对本机的真实密钥值；npm test 也会跑它。想在每次提交前自动检查，运行一次 git config core.hooksPath .githooks，之后 pre-commit 会扫描暂存区里实际要提交的内容。

已知限制

• 只支持到店自取（含堂食、外带取餐柜），暂不支持外送和得来速。
• 可领券在领取前拿不到券号，无法提前核价。官方领券接口一次领取全部，不能只领一张。
• 套餐里的口味特调（去酸黄瓜、少冰等）还没参与比较，默认按标准做法核价。
• 价格只代表那家店、那个时刻的官方报价，下单时以 App 为准。

项目信息

• 麦当劳程序员创意开发大赛参赛作品，非麦当劳官方产品。项目里没有使用麦当劳的商标图形。
• 报名 Issue：M-China/mcd-developer-innovation-challenge#983（官方已确认成功参赛）
• 参赛声明：CONTEST_DECLARATION.md · MCP 接入说明：MCP_INTEGRATION.md · 配置示例：mcp-config.example.json
• 许可证：MIT

如果它帮你看清了某一顿的价格，欢迎点个 ⭐。