mcd-coupon-strategist - 用真实计价回答「这一单怎么点最省」和「你正在白扔多少钱」

mcd-coupon-strategist 是一个基于麦当劳中国 MCP 打造的点餐成本助手。据项目自述，它想回答两个层次的问题：短期是「这一单怎么点最省」，长期是「你正在白扔多少钱」。前者通过拉取当前门店的实时菜单与价格、账户内当前门店可用的优惠券，枚举单品、套餐、券组合、加购凑单等候选方案，再交由 MCP 的计价接口逐方案真实计价；后者则从历史订单与券存量出发，量化即将过期的券面价值，并还原月度支出、客单价与高频单品。它适合预算固定的学生与上班族、手里攒了一堆券却不知道先用哪张的持券用户、不想在菜单里反复横跳的选择困难用户，以及想弄清自己在快餐上到底花了多少钱的人。

维护者与状态

项目由 Ayzzz123 维护，仓库创建于 2026-10-10，最后一次提交在 2026-10-12。截至 2026-10-13，仓库获得 232 个星标。事实表显示，该项目尚无正式 release，也就是说目前没有可供引用的版本化发布，代码以仓库主干形态存在。项目采用 MIT 许可证。

主要能力

以下能力均据项目 README 自述整理，未经本站实测：

• 门店菜单感知：价格与供应状态随门店实时变化，不写死菜单。
• 券面价值解析：MCP 返回的券通常只有名字没有面值，项目从门店菜单反查原价来推算券的真实价值——满减券直接取减免额，买一送一取该商品菜单单价，固定价券取菜单原价减去固定价。
• 方案枚举计价：所有候选方案都经 MCP 真实计价，不复用历史价格。
• 省钱归因：明确告诉用户省在哪，用了哪张券、换成了哪个套餐、加了什么凑单品。
• 反凑单陷阱：当「为用券而加购」反而更贵时，主动指出并给出更优解。
• 券的沉默成本：量化即将过期的券面值，项目自述这是其独有视角。
• 消费习惯画像：从历史订单还原月度支出、客单价、高频单品，给出结构性省钱建议。

README 中给出的示例显示，在某个录制场景里，同样吃到「汉堡 + 薯条 + 可乐」，套餐组合实付 33.5 元，而单点组合为 46.5 元。需要说明的是，这些数字来自项目自述的演示数据，并非本站验证结果。

项目自述的设计原则包括：绝不猜测价格，所有金额均来自 MCP 计价接口返回；宁可少报不可编造，券的价值若无法从菜单反查到原价则取 0 并在报告中标注；省在哪要说清；不诱导消费；退款不算消费，历史订单中的整单退款会被过滤；信息以官方渠道实时结果为准。

使用入口

仓库地址：https://github.com/Ayzzz123/mcd-coupon-strategist

据项目说明，最快的方式是克隆仓库后运行演示脚本，该演示零第三方依赖、不需要 MCP Token、不联网，读取 fixtures 目录中录制的真实 MCP 响应跑通两条链路：

git clone https://github.com/Ayzzz123/mcd-coupon-strategist.git
cd mcd-coupon-strategist
python demo.py

测试同样为纯本地运行，不需要 Token，也不需要安装第三方库：

python src/test_saver.py
python src/test_auditor.py
python src/test_adapter.py
python src/test_order_adapter.py

若要接入真实数据，项目说明需要先在麦当劳 MCP 开放平台申请 Token，再把仓库提供的脱敏示例配置 mcp-config.example.json 中的环境变量占位符替换为自己的 Token，写入 MCP Client 配置。README 特别提醒不要把真实 Token 提交到任何公开仓库。项目还提供了在 WorkBuddy 中通过自定义连接器配置 MCP 的步骤说明。更完整的 Server、Tool、调用流程与业务价值说明见 MCP_INTEGRATION.md，项目自述其中记录了官方文档未写、但跑通链路必需的 12 条调用契约，包括门店查询的必传参数、计价接口的字段名，以及「分与元」在两个接口方向上相反的坑。

许可与限制

项目采用 MIT 许可证。使用前需要注意以下几点，均来自项目自述：

• 真实数据链路需要麦当劳 MCP Token，需自行前往麦当劳 MCP 开放平台申请并激活；Token 属于敏感凭据，不应提交到公开仓库。
• 演示与测试虽然无需 Token，但依赖 fixtures 中录制的响应数据，并非实时结果。
• 券面价值反查依赖门店菜单中存在对应商品；若菜单中查不到，项目取 0 并在报告中标注，因此报告中的沉默成本可能低于实际。
• 价格、供应状态与券的可用范围均以麦当劳官方渠道的实时结果为准，项目输出仅供参考。
• 项目自述为麦当劳程序员创意开发大赛参赛作品，由参赛者独立开发，非麦当劳官方产品。

此外，事实表显示该项目尚无正式 release，使用时应以仓库当前代码为准，并留意后续变更。