同样一份餐，两条点法差 ¥12.00（24.7%）。 同店同时刻：单品直选 ¥48.50，三件套 ¥36.50。
一句话 → 一个答案 → 一张点单卡。 说「35 元，不辣，有糖可乐去冰，带走」，它把这一餐真正要付的钱算出来，给你一张能照着点的清单；没有方案就直说没有，不拿不完整的餐单凑数。
菜单写 ¥32.00，核价 ¥58.50 —— 它只认后者。 实测遇到过展示价要求随单购买麦金卡；这时它会同时给出条件与核价。金额一律取官方 calculate-price 返回的整数分。
不领券、不兑换、不下单、不支付，也不收集你的 Token。 网页打开就是答案：不用账号、不用 Token、不用安装；要实时核价时，Token 只留在你本机的环境变量里。
打开在线体验（免登录） · 安装 Skill · 真实联调记录 · English
English TL;DR — A read-only McDonald's China MCP client + agent skill. Say "35 yuan, not spicy, regular cola, no ice, takeaway" and it compares complete meals (main + side + drink) using official per-order pricing, tells you why each rejected meal lost (dominated by which candidate, on which axis), and when nothing fits it says so — plus how much budget would actually be needed. An explicit regular-cola choice is never silently swapped for zero sugar. It never orders, pays, or collects your token. English README · 30-second demo
不用账号、Token 或安装：
- 打开就是答案：默认直接给出这一餐（巨无霸三件套 ¥36.50）和一句可核对的理由——「比单品直选省 ¥12.00（24.7%）」。
- 点 「就这个」：出现可复制的点单卡（门店 / 取餐方式 / 每样官方名称 / 合计）。
- 把预算改成 30 元：它说没有方案，并告诉你最低需要多少（¥36.50）——不硬凑。
- 想看别的，点 「我想比较」：才展开全部候选与「为什么不是它」。默认不给表格。
- 想看得更深，展开 「更细的比较」：切换比较角度（价格与钠 / 口味与钠 / 四维营养），并看三种推荐角度各自选了什么。
点单卡就是最终产出物——门店、取餐方式、每样官方名称、合计，照着它就能在 App 或柜台点单：
网页使用历史快照，所有比较在你的浏览器内完成，不收集凭证、不调用下单、不加入追踪器；本项目为独立参赛作品，非麦当劳官方产品。也可看 30 秒录屏演示（当前界面，静音）。
网页默认门店（fixtures/hongwu-single-vs-combo.json，2026-10-17 真实核价）上的实际输出：
这顿就它了 👇
巨无霸三件套 · 套餐（巨无霸 + 中薯条 + 可乐中杯）
¥36.50 南京某门店（名称与地址已脱敏） · 到店自取
比「单品直选」省 ¥12.00（24.7%）
点单卡（可复制）
门店：南京某门店（名称与地址已脱敏） · 到店自取
1. 巨无霸
2. 中薯条
3. 可乐中杯
合计：¥36.50
比「单品直选」省 ¥12.00（24.7%）
以上只是记录你的选择；没有下单、没有支付。
想在 CLI 复现同一段输出（默认快照是老的那组，省 ¥12.00 这组要显式指定）：
python3 demo.py --input fixtures/hongwu-single-vs-combo.json \
--budget 40 --baseline-plan single-pick- 默认只给一个答案，不让你在 3 份表格里做多目标权衡；理由必须是可核对的事实（省了多少钱 / 价格最低 / 钠最低），不是说服文案。
- 点单卡是最终产出物：门店、取餐方式、每样官方名称、合计——照着在 App 或柜台点即可。
- 想看别的：
--compare才展开全部候选与「为什么不是它」。
- 一个人或两个人吃饭、预算有限、对口味有明确偏好的人；
- 以到店自取 / 外带为主，想在下单前把「这一顿多少钱、怎么点更划算」算清的人；
- 需要把钠 / 能量 / 蛋白质当筛选条件的人（条件由你自己设，不是健康建议）；
- 用 WorkBuddy 等 AI 客户端、希望"说一句话就得到可核价餐单"的人；
- 开发者：想看一个只读 MCP 客户端 + 确定性比较 + 可复算省钱数字的实现样板。
- 钱必须是真数：金额只认官方
calculate-price返回的整数分；菜单展示价附带的条件（例如「随单购麦金卡」）会一并说清。例：巨无霸三件套菜单价 ¥36.50、官方核价也是 ¥36.50；带「随单购卡」条件的商品两者会不同，此时它会同时显示条件与核价。 - 你的硬约束只说一次：不辣、去冰、有糖……记住你的条件，不反复问，也不因为"营养更优"替你改。
- 两个人也能算：份数完备性按人数（主食与饮料各 ≥ 人数），比较用人均价，而不是拿"两人总价"去比"一人总价"。
再加上一条：不领券、不兑换、不下单、不支付，也没有购物车。
“35 元，不辣，有糖可乐去冰，带走。帮我看看附近哪家店合适。”这是我们希望用户直接表达的需求。Skill 会先补齐地点、让你确认门店，再比较完整餐单，不要求普通用户复制门店、商品或券的编码。这条路径由安装了 Skill 的 AI 客户端执行；网页是免登录的历史数据体验，CLI 是开发者入口。
比较程序按价格、已知钠含量、口味匹配三个明确标准给出结果。同一餐单可能符合多个标准；这不代表三个独立模型进行了讨论，也不承诺全菜单最优。
查看历史核价示例：预算 35 元、想吃辣，三个比较角度为什么选不同餐单
| 比较角度 | 本次选择 | 理由 |
|---|---|---|
| 价格较低 | 双层吉士汉堡 + 小杯玉米杯 + 无糖可口可乐中杯 | 当次整单核价 ¥32.00，在候选中价格较低 |
| 钠含量较少 | 麦香鱼 + 小杯玉米杯 + 无糖可口可乐中杯 | 当次 ¥32.50；官方标准份量单品合计钠 592 mg，在候选中较少 |
| 更贴近辣味偏好 | 麦辣鸡腿汉堡 + 小杯玉米杯 + 无糖可口可乐中杯 | 当次 ¥32.00，保留辣味偏好 |
上表是 2026-10-13 演示门店的真实核价快照，不是当前报价，也不是营养搭配建议。实际购买须重新核价。我们比较六份候选，不保证全菜单最低价。
App 是下单的地方；这里是打开 App 之前把「这顿怎么点」算清楚的地方。
- 下单仍在麦当劳 App 或门店完成；本工具不提供购物车、不代下单。
- 它只做「打开下单渠道之前」的那一步：把你的条件变成可核价的完整餐单，并说明取舍。
- 没有符合条件时会直说，并给出保持其他条件的预算阶梯（差多少钱、加多少后有几份可选）。 两者不冲突：用它决定点什么，用 App 完成购买。
先按官方文档配置麦当劳 MCP 连接器。mcp-config.example.json 只含环境变量占位符；若客户端不支持变量展开，请只在该客户端的私有配置中设置实际凭证。
可以把下面这段发给 WorkBuddy：
请安装这个技能：https://github.com/polaris-smart/mcd-agent-gourmet
保留 SKILL.md、gourmet/、demo.py、fixtures/ 的相对位置。
使用我已配置的麦当劳 MCP 连接器。
35 元，不辣，有糖可乐去冰，主食、小食、饮料各一份，带走。
我在南京江宁区。先显示门店名称和地址，让我选店。
再查当次菜单，给我最多三份符合要求的方案，说明价格和取舍。
没有满足条件的方案时说明原因，先别替我改饮料或加预算。
只查询和核价，不领券、不兑换、不下单、不支付。
偏好可按自己的习惯改成无糖或其他可选饮料。门店编码由客户端从查询结果中传递；不能在没有位置依据时声称自动选中了“离你最近”的店。
实现说明： Python 和网页使用确定性筛选、排序与非支配集合比较。SKILL.md 引导 AI 客户端理解需求、查询并解释结果，不制造三个独立模型的角色对话。新版在 WorkBuddy 客户端中的完整对话路径仍需验收，详见 验证记录。
| 入口 | 行为 |
|---|---|
随便来一份（--any） |
不设预算时明说"未设预算"，只按其他硬性条件给一个默认答案；不会偷偷替你假定一个预算 |
跟上次一样（--last，需 --live） |
读最近一次订单，只复用门店与商品编码，按当次价重新核价（不复用历史金额）；上次的商品若已售罄会逐条告诉你并去掉，不替换；上次那家店不在营业时间就明说，退回默认方案 |
| 企业团餐 / 主题派对 | 不是个人点餐的渠道，属于独立场景（query-meal-assistance / party-*），本工具不把它们混进来 |
官方 MCP 覆盖的是麦当劳自有渠道的只读数据。下面三类现在拿不到，遇到时它会直说，而不是猜：
- 券/卡的完整条款原文：「不与其他优惠同享」的具体边界没有对应工具，只有券名、官方状态与时间字段。
- 麦金卡 / 早餐卡的实时权益（剩余次数、适用门店）：35 个工具里没有对应入口。
- 份量 / 克重 / 尺寸：没有数据源，所以它不会回答「是不是缩水了」，只会给同价位的替代方案。
另外，MCP 不含美团、饿了么、京东、抖音、淘宝闪购等第三方渠道——第三方价格与券以各渠道自己的页面为准。以上三类之外的实时价格、门店供应、营业状态、券的可用性判定，都走官方接口。
前沿解释（其他候选被谁、差在哪个维度比下去）与预算阶梯（差 ¥2 能多几份）的完整说明见 功能细节。
网页收录的独立历史样例由 fixtures/demo-snapshots.json 管理，当前包括三组南京门店样例；其中一组的门店名与地址已脱敏，因为该门店位于作者住所附近，公开它等于公开个人位置。其余两组均包含实测“薯条＋有糖可乐”和“薯条＋无糖可乐”的去冰组合。各组独立标明门店、公开地址与核价时间，不跨店混比；脱敏只作用于门店标识，核价与营养数据未做修改。网页不实时核价、不接受 Token。
以下命令供开发者调试；日常使用可直接采用上面的 WorkBuddy 对话入口。
python3 demo.py --sugar zero --energy-limit 700 --protein-min 20
python3 demo.py --search-stores --city 南京 --keyword 新街口
# 用返回的真实门店和套餐编码替换下列占位文本
python3 demo.py --list-meals --store-code 门店编码
python3 demo.py --live --store-code 门店编码 --meal-code 套餐编码 --expand --sugar zero --ice none没有核验冰量的历史样例不能被改成去冰报价。CLI 当前只自动构造三轮完整套餐；全部杯型、儿童玩具、辣度分级及过敏原尚未完整支持。
券包的时间窗口判定、积分兑换、会员积分、配送地址、以及到店/得来速/麦乐送的编码对应关系，见 功能细节 · 券与会员。
已按官方格式补齐元数据与资源目录，可构建 ZIP 分发包：
python3 scripts/build_skill_package.py --output /tmp/mcd-agent-gourmet-1.0.0-rc.zip包可用于开放平台投稿，目前未提交审核、未上架。安装与上架文案见 市场发布说明。Skill 优先使用客户端已配置的麦当劳 MCP；脚本只需 Python 标准库。
Python 3.9+，仅标准库，零第三方依赖。
git clone https://github.com/polaris-smart/mcd-agent-gourmet.git
cd mcd-agent-gourmet
python3 demo.py
python3 demo.py --budget 35 --taste no-spicy --sodium-limit 800
python3 demo.py --budget 35 --taste spicy --side fries --json默认读取 fixtures/snapshot.json。即使本机有 Token，也不会自动联网。
- 在 麦当劳开放平台 MCP 登录页 用手机号登录后申请自己的 MCP Token；工具清单、限额与字段说明见 官方文档。
- 在本机私有环境中设置
MCD_MCP_TOKEN。不要提交到 Git，也不要粘贴到公共对话或网页。 - 先搜索并选择门店。实时模式必须明确传入
--store-code或已确认的--plan，不会自动沿用南京样例店。再用--list-meals查看该店当次菜单，用--meal-code选择套餐。只传门店编码不会载入演示套餐；覆盖计划的旧门店时，必须重新选择餐品及适用的渠道业务编码。 - 显式运行：
python3 demo.py --list-tools
python3 demo.py --live --plan fixtures/plan.json --budget 35 --taste spicy程序读取当次菜单、官方营养数据，对候选逐份 calculate-price。真实查询失败会停止，不拿历史快照伪装成实时结果。自动构造支持即时三轮套餐；到店已实测，配送/得来速参数已接入但未完成真实核价联调。默认不使用优惠券。
按名称查可用券、--save-snapshot 保存脱敏快照、以及“价格与钠 / 口味与钠 / 四维营养”的非支配比较规则，见 功能细节 · 券查询与多维比较。
- 先完整，再便宜。 只有满足主食、小食、饮料和份数要求的餐单才进入候选。
- 硬性条件与偏好分开。 “不吃辣”严格排除；“想吃辣”作为偏好，无法满足时解释替代。
- 比较标准透明。 分别按价格、已知钠含量、口味匹配筛选；多个标准可能选中同一餐单，不制造虚假的“争论”。
- 未知就是未知。 营养表按餐品完整名称精确匹配。无法匹配则保留
null；不能把缺失变成 0，也不输出“营养均衡”标签。 - 选择不是下单。
--select和网页按钮只记录餐单决定，不创建订单或支付。
适合预算有限、想看清取舍的个人用户，以及学习真实业务 MCP、Agent 角色审阅和失败处理的开发者。当前不处理多人分摊、过敏原判断、医学饮食建议、自动下单或全菜单最优搜索。
python3 -B -m unittest discover -s tests -v
node tests/parity.cjs # 可选开发检查，需要 Node.js
python3 -B scripts/build_demo.py # 从同一快照生成网页数据验证记录 区分真实接口运行、离线测试、浏览器检查和未验证内容。改进记录 说明从原演示修正了什么。
gourmet/core.py 完整餐单检查、三角色意见、选择记录
gourmet/mcp.py 标准 Streamable HTTP、只读白名单、错误处理
gourmet/live.py 套餐选项、官方核价、营养表解析
demo.py 本地演示与显式实时入口
fixtures/plan.json 六份候选模板，不含凭证
fixtures/snapshot.json 脱敏真实历史快照
docs/ 免 Token 网页体验与说明
tests/ Python 回归与 Python/JS 决策一致性
M-CODE 2026 独立参赛作品，非麦当劳官方产品。官方报名记录。本次修订使用 Codex 辅助，WorkBuddy 历史材料与证据状态单独说明，不将本次工作冒充 WorkBuddy 对话。
欢迎提 Issue，描述“我输入了什么、期望什么、实际出现什么”；不要附 Token、账号或原始优惠券数据。提 PR 前请先看 CONTRIBUTING.md（本地四步检查：测试 / parity / CLI 冒烟 / data.js 无 drift）。如果这个透明决策的思路对你有帮助，欢迎点一颗 Star。
原创代码采用 MIT License。官方参赛声明按官方原文保留，相关商标与服务条款归权利人所有。输出仅供参考，餐品信息、价格和供应状态以官方当前结果为准，不构成医疗、营养或其他专业建议。