Back to search
mcd-advisor
SkillWorks with Claude CodeGitHub
麦麦参谋。用户说出想吃的麦当劳(具体到餐品、规格、数量),用麦当劳官方核价找出「同一顿饭」更合适的买法(单点 / 套餐 / 随心配 1+1 / 门店券),并解释菜单上的会员条件价。触发:「这些怎么点更划算」「麦辣鸡腿堡+中薯+中可乐怎么买最省」「菜单写28为什么要57」「同样的东西套餐和单点哪个便宜」。不触发:下单、外送、热量营养、推荐吃什么、积分抽奖。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/wenboxia--mcd-advisor)HTML
<a href="/listings/wenboxia--mcd-advisor"><img src="/api/listings/wenboxia--mcd-advisor/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 47 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- 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 目录下)
- ```bash
- 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`
README.md · README · 189 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <p align="center">
- <img src="docs/images/banner.png?v=2" alt="麦麦参谋 · 同一顿,换个买法" width="880">
- </p>
- <p align="center">
- <a href="https://wenboxia.github.io/mcd-advisor/"><strong>🍔 在线体验</strong></a> ·
- <a href="#先看效果"><strong>先看效果</strong></a> ·
- <a href="#三种用法"><strong>三种用法</strong></a> ·
- <a href="#它怎么工作"><strong>怎么工作</strong></a> ·
- <a href="README.en.md"><strong>English</strong></a>
- </p>
- <p align="center">
- <a href="https://wenboxia.github.io/mcd-advisor/"><img src="https://img.shields.io/badge/%E5%9C%A8%E7%BA%BF%E4%BD%93%E9%AA%8C-%E4%B8%8D%E7%94%A8%E8%A3%85%E3%80%81%E4%B8%8D%E7%94%A8%20Token-FFC72C?style=for-the-badge" alt="在线体验:不用装、不用 Token"></a>
- <a href="#三种用法"><img src="https://img.shields.io/badge/Skill%20%E5%8F%AF%E8%A3%85%E8%BF%9B-WorkBuddy%20%C2%B7%20Claude%20Code%20%C2%B7%20Codex-27251F?style=for-the-badge" alt="Skill 可装进 WorkBuddy · Claude Code · Codex"></a>
- </p>
- <p align="center">
- <img src="https://img.shields.io/badge/%E4%BB%B7%E6%A0%BC%E6%9D%A5%E6%BA%90-%E9%BA%A6%E5%BD%93%E5%8A%B3%E5%AE%98%E6%96%B9%E6%A0%B8%E4%BB%B7-DA291C" alt="价格来源:麦当劳官方核价">
- <a href="tests/advisor.test.mjs"><img src="https://img.shields.io/badge/%E7%A6%BB%E7%BA%BF%E6%B5%8B%E8%AF%95-27%20%E6%9D%A1%E9%80%9A%E8%BF%87-2E7D32" alt="离线测试 27 条通过"></a>
- <img src="https://img.shields.io/badge/%E4%BE%9D%E8%B5%96-0-FFC72C" alt="零依赖">
- <img src="https://img.shields.io/badge/node-%E2%89%A518-3C873A" alt="Node ≥18">
- <a href="MCP_INTEGRATION.md"><img src="https://img.shields.io/badge/%E9%BA%A6%E5%BD%93%E5%8A%B3%20MCP-8%20%2F%2035%20%E4%B8%AA%E5%B7%A5%E5%85%B7-27251F" alt="麦当劳 MCP:8/35 个工具"></a>
- <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT License"></a>
- </p>
- # 麦麦参谋 · 同一顿,换个买法
- **菜单显示 ¥28,为什么这次核价是 ¥57?**
- 你想吃的东西(餐品、规格、数量)**一样都不变**,麦麦参谋用**麦当劳官方核价**帮你核对这一顿怎么买更合适:分开点、套餐、随心配 1+1、门店券,挑出一个,并附上一张能核对的账单。省得下就告诉你怎么省,省不下就直说。
- 👉 **[打开在线体验](https://wenboxia.github.io/mcd-advisor/)**:点选想吃的,马上看到建议和账单。页面上 249 个组合的价格,都是在真实门店由麦当劳官方核价接口逐个返回的,不是估算。
- <table>
- <tr><td width="64"><b>场⁠景</b></td><td>点麦当劳之前,想知道「同样这些东西」怎么买更合适</td></tr>
- <tr><td width="64"><b>输⁠入</b></td><td>想吃什么(例:麦辣鸡腿堡 中薯 中可乐)+ 在哪(城市 + 地标,或 App 收藏门店)</td></tr>
- <tr><td width="64"><b>输⁠出</b></td><td>一个建议 + 少付多少 + 会员条件价的解释 + 可领券提醒 + 一张账单(门店、时间、逐行小计、核价编号)</td></tr>
- <tr><td width="64"><b>不⁠做</b></td><td>不下单、不替你换主食、不劝你多买、不推荐买会员卡、不承诺「全场最省」</td></tr>
- </table>
- ## 先看效果
- <p align="center">
- <img src="docs/images/cases.png?v=2" alt="三个真实案例:随心配省 ¥13.1;菜单 ¥28 的四件套不加卡要 ¥57;只要一个汉堡时保持原单" width="880">
- </p>
- <p align="center">
- <a href="https://wenboxia.github.io/mcd-advisor/?m=%E9%BA%A6%E8%BE%A3%E9%B8%A1%E8%85%BF%E5%A0%A1&s=%E4%B8%AD%E8%96%AF&d=%E4%B8%AD%E5%8F%AF%E4%B9%90&n=1"><img src="docs/images/demo-page.png?v=1" alt="在线体验页:选麦辣鸡腿堡 + 中薯 + 中可乐,建议三件套 ¥33.5,比分开点少付 ¥12.5,并解释 ¥28 的四件套和可领券" width="880"></a>
- <br><sub>在线体验页截图:每个价格都是麦当劳官方核价(上海黄浦华旭国际大厦餐厅,2026-10-22 午餐时段)。<a href="https://wenboxia.github.io/mcd-advisor/">点图打开,自己选一顿试试</a>。</sub>
- </p>
- 这三个案例覆盖了三种结果:
- | 你想吃 | 麦麦参谋的回答 | 依据 |
- |---|---|---|
- | 麦香鸡 + 中可乐 | 点**随心配 1+1**,¥13.9(分开点 ¥27.0) | 两样一样不少,官方核价 |
- | 麦辣鸡腿堡 + 中薯 + 中可乐 | 点**三件套**,¥33.5(分开点 ¥46.0);菜单上 ¥28 的四件套要随单加购麦金卡,不加卡 ¥57.0,加卡 ¥37.9(含 ¥9.9 卡费),而且会多一份麦乐鸡 | 每种买法都单独核价 |
- | 只要一个麦辣鸡腿堡 | **保持原单**,¥22.5 | 套餐会多出薯条可乐,不算同一顿 |
- **几个人一起点**:手机传一圈、大家把要的写进同一句话就行,它会算出合在一起怎么买更划算。比如三个人各要一个汉堡 + 中薯 + 中可乐:
- ```bash
- node bin/mcd-advisor.mjs "巨无霸 板烧鸡腿堡 麦辣鸡腿堡 3个中薯 3杯中可乐" --city 上海市 --near 人民广场
- ```
- 建议点**巨无霸、板烧鸡腿堡、麦辣鸡腿汉堡三份三件套**,共 ¥104.5,分开点要 ¥142.0,少付 ¥37.5,同样有离线回放记录。它只回答「合在一起怎么买」,不做 AA 分账,谁付多少你们自己转就好。
- ## 三种用法
- ### ① 在线体验:不用装、不用 Token
- 打开 **[https://wenboxia.github.io/mcd-advisor/](https://wenboxia.github.io/mcd-advisor/)**,选主食、小食、饮品和份数,右边就是麦麦参谋的回答:建议买法、少付多少、会员条件价的解释、可领券提醒,还有一张能展开核对的账单。
- 页面数据是在一家上海门店的午餐时段用官方核价逐个录下的快照;想用你自己的门店实时核价,用下面两种方式。
- ### ② 装进 WorkBuddy 等 AI 助手,一句话问(推荐)
- 本仓库就是一个标准的 Agent Skill([`SKILL.md`](SKILL.md)),可以装进 **WorkBuddy**、Claude Code、Codex 等支持 Skill 的 AI 助手。装好后直接说「麦辣鸡腿堡加中薯中可乐,人民广场附近怎么买更划算」就行。
- | AI 助手 | 怎么装 |
- |---|---|
- | **WorkBuddy** | 下载本仓库,在【专家 · 技能 · 连接器】里导入整个文件夹;或者用下面的命令放进 WorkBuddy 的技能目录,再重启 WorkBuddy |
- | Claude Code | `git clone https://github.com/wenboxia/mcd-advisor.git ~/.claude/skills/mcd-advisor` |
- | Codex 等 | 把仓库放进该工具的 Skill 目录 |
- ```bash
- git clone https://github.com/wenboxia/mcd-advisor.git ~/.workbuddy/skills/mcd-advisor
- ```
- Windows 上 WorkBuddy 的技能目录是 `%USERPROFILE%\.workbuddy\skills\`。
- 第一次用之前,需要你自己的麦当劳 MCP Token(在 [open.mcd.cn/mcp](https://open.mcd.cn/mcp) 用手机号登录 → 控制台 → 激活):
- - **WorkBuddy**:已经在【连接器】里配好麦当劳 MCP 的,不用再填,脚本会直接读本机的这份配置(只读不改);
- - **其他工具**:写进**仓库之外**的 `~/.config/mcd-advisor/.env`(格式见 [`.env.example`](.env.example))。
- Token 只留在你自己的电脑上,不要发给任何人。
- 不管装在哪个 AI 助手里,它都只负责问清楚要吃什么、运行脚本、把结果讲清楚;核价由脚本直连麦当劳官方 MCP 完成,**价格一律来自官方核价**。
- Skill 按**三层渐进式披露**组织:
- - frontmatter 里的说明负责触发;
- - `SKILL.md` 正文约 40 行,只放硬规则和流程;
- - `references/` 里的规则和排错文档在需要时才读。
- 没有支持 Skill 的工具?在配置里加上 `DEEPSEEK_API_KEY`,用一句大白话问也行(换 Kimi、GLM 时再设 `LLM_BASE_URL` 和 `DEEPSEEK_MODEL`):
- ```bash
- node bin/mcd-advisor.mjs --ask "中午想在上海人民广场吃个麦辣鸡腿堡,配中薯和可乐"
- ```
- ### ③ 命令行(开发者)
- 零第三方依赖,Node.js 18+。先离线跑一下,不需要 Token:
- ```bash
- git clone https://github.com/wenboxia/mcd-advisor.git && cd mcd-advisor && npm run demo
- ```
- 命令行输出示例:
- <p align="center">
- <img src="docs/images/terminal.png?v=2" alt="命令行输出示例:建议三件套 ¥33.5,比分开点少付 ¥12.5,并解释 ¥28 的四件套和可领券" width="720">
- </p>
- 配好 Token 后实时核价:
- ```bash
- node bin/mcd-advisor.mjs "麦辣鸡腿堡 中薯 中可乐" --city 上海市 --near 人民广场
- node bin/mcd-advisor.mjs "两个麦香鸡 两杯中可乐" --store 1450713 --json
- node bin/mcd-advisor.mjs "麦辣鸡腿汉堡三件套" --city 上海市 --near 人民广场 # 报套餐名也行,按默认搭配拆开比较
- ```
- | 选项 | 作用 |
- |---|---|
- | `--city` `--near` | 按城市 + 地标找最近的门店;都不填就用你在 App 里收藏的门店 |
- | `--store` | 直接指定门店编号 |
- | `--json` | 输出 JSON,给 Agent 或其他程序用 |
- | `--ask` | 用一句大白话提问(需要 DeepSeek 等模型 Key) |
- | `--claim` | 领取麦麦省可领券后重新核价。官方接口会**一次领取全部**可领券,所以脚本会先说明,并要你在终端里亲手输入 `y` |
- | `--replay <dir>` | 用录好的数据离线运行 |
- ## 它怎么工作
- <p align="center">
- <img src="docs/images/flow.png?v=3" alt="业务流程(泳道图):用户、AI 助手、麦麦参谋引擎、麦当劳官方 MCP 四条泳道;名字不明确先反问,买不到一模一样的直说,只有官方核价成功的方案参与排名" width="880">
- </p>
- - **同一顿,由代码判定**:每个方案拆开后,食物清单必须和你要的完全一致,多出一份薯条也不行。小杯和中杯算两种东西;「任选 3 份」这样的格子按份数算。买不到一模一样的一顿时会直说(例如某样东西只在会多出别的东西的套餐里卖)。
- - **说不清就先问**:名字只有完全对上才直接用,「巨无霸大套餐」「鸡块」这种会先给你选项,不会悄悄换成别的东西。「学生专享」这类有资格限制的商品不会出现在方案里。
- - **份数再多也是最优**:按剩余食物做动态规划,4 份、6 份照样能找到估算最省的组合,再交给官方核价。
- - **价格只认官方**:菜单价只用来决定哪些方案值得送去核价,最终排序只看 `calculate-price` 的返回。价格分三种状态:✅ 已官方核价、🟡 待核验(券还没领,拿不到券号)、⚪ 无法确认。后两种不参与排名。
- - **会员条件价讲清楚**:菜单 `discountType` 是「随单购…」的商品,分别核价「不加卡」和「加卡(含卡费)」,只解释,不推荐买卡。
- - **快**:第一次查一家店要拉取全部菜单详情,实测约 7 秒;当天再查会用缓存,实测 1–2 秒。
- 用到哪些 MCP 工具、为什么不用另外 27 个、踩过哪些坑,见 [MCP_INTEGRATION.md](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](https://github.com/M-China/mcd-developer-innovation-challenge/issues/983)(官方已确认成功参赛)
- - 参赛声明:[CONTEST_DECLARATION.md](CONTEST_DECLARATION.md) · MCP 接入说明:[MCP_INTEGRATION.md](MCP_INTEGRATION.md) · 配置示例:[mcp-config.example.json](mcp-config.example.json)
- - 许可证:[MIT](LICENSE)
- 如果它帮你看清了某一顿的价格,欢迎点个 ⭐。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.