hujjun/mcd-saver-strategist

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/hujjun/mcd-saver-strategist.svg?style=card)](https://bestofgithub.dev/repo/hujjun/mcd-saver-strategist)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/hujjun/mcd-saver-strategist.svg)](https://bestofgithub.dev/repo/hujjun/mcd-saver-strategist)

Loading README…

问题	能力
这顿饭我想省钱 / 吃全 / 低卡 / 少排队	多目标优化：4 种点餐目标，同一约束给不同最优解
手里这堆券，哪张优惠更实在？	券体检：名义面额 vs 实际节省 vs 机会成本
差几块钱到下一档满减，加购划不划算？	凑单建议：最小代价补位，算出净变化（可能为负）
便宜和低卡不可兼得，边界在哪？	帕累托前沿：价格 × 热量的不可支配解集
一家人 / 一桌同事怎么点？	多人拼单：按份数计价、人均分摊，优惠只计一次（保守）

角色	职责
麦当劳 MCP	实时菜单、价格、优惠券、营养、门店、下单
`scripts/optimizer.py`	确定性组合优化，输出总价最低的 Top-N 方案
WorkBuddy Agent	理解需求、归一化数据、讲解方案、确认后下单

项目	性质	说明
优化算法	✅ 真实	`optimizer.py` 与在线试算页为同一套逻辑，且 CI 里有 17 项前后端对拍防漂移
「省 53%」结论	✅ 真实	算法在示例数据上算出，非人工编排
券叠加规则	✅ 真实	保守策略：`stackable:false` 与任何券互斥，保证方案价 ≤ 实付价
MCP 数据链路	✅ 真实	`mcp_probe.py` 可现场验证：Token 握手 + 35 个工具清单 + 试调用
菜单价格 / 热量	🟡 示例快照	结构对齐 MCP 返回，数值为演示用，以门店实时返回为准
优惠券内容	🟡 示例快照	结构对齐 MCP 四路券池归一化结果，可用性以账号实时状态为准
下单能力	✅ 真实	经 MCP 核价（`calculate-price`）→ 下单（`create-order`），本仓库页面不涉及下单

规则要求	本仓库情况
仓库创建时间在 2025-12-25 ~ 2026-10-25 之间	✅ 创建于 2026-10-09
仓库公开可访问	✅ public
`README.md`（介绍 / 安装 / 使用示例 / 目标用户）	✅ 四个部分均有独立章节
`CONTEST_DECLARATION.md`	✅ 与官方原文逐字节一致（md5 `91a7b32e…`）
`MCP_INTEGRATION.md`（Server / Tool / 调用流程 / 业务价值）	✅ 六个章节，含 Tool 清单与字段映射
`mcp-config.example.json`（只允许环境变量占位符）	✅ 仅 `Bearer ${MCD_MCP_TOKEN}`
`workbuddy.md`（WorkBuddy 专项）	✅ 含开发环境、对话摘要、技术决策与迭代记录
真实使用麦当劳 MCP	✅ `scripts/mcp_probe.py` 可复现握手 + tools/list + 调用
真实使用 WorkBuddy	✅ 本 Skill 在 WorkBuddy 中开发与联调，过程见 `workbuddy.md`
未包含真实 Token / 密钥	✅ 全 git 历史扫描为零命中
内容合规（不贬损品牌与产品）	✅ 仅陈述券面数据与算法结果，使用中性表述，不与其它品牌对比

hujjun/mcd-saver-strategist

麦门省钱精算师 · mcd-saver-strategist

项目介绍

它解决什么问题

架构

一句话安装

安装

1. 申请麦当劳 MCP Token

2. 配置 MCP 连接

3. 安装本 Skill

使用示例

命令行快速体验（无需 Token）

真实性对照表

参赛合规自查

实测发现

目录结构

目标用户

技术亮点

搜索关键词

免责声明

许可