正在整理你需要的资料…
baihua2471/mcd-expiry-butler ↗ · 项目主页 ↗
券快到期了,该不该为了过期去吃一顿?WorkBuddy 技能基于麦当劳官方 MCP,只读查你的优惠券与积分,列出 7 天窗口内快到期的权益,用官方 calculate-price 试算实际应付金额,最后给最多两套用餐方案、推荐理由和「不值得为消耗而额外花钱」的清单;第一版红线是不领券、不兑换、不下单、不付款。
适合卡包里囤了一堆券、每次点单前要翻半天的人;前提是在 open.mcd.cn 激活 MCP Token 并在 WorkBuddy 里信任该连接器,Token 别提交进仓库。
mcd-expiry-butler
券快到期了,该不该为了过期去吃一顿?WorkBuddy 技能基于麦当劳官方 MCP,只读查你的优惠券与积分,列出 7 天窗口内快到期的权益,用官方 calculate-price 试算实际应付金额,最后给最多两套用餐方案、推荐理由和「不值得为消耗而额外花钱」的清单
下面是把仓库 README 逐节读完后归纳出的中文要点。
帮你看哪些麦当劳权益快到期、哪些值得用、哪些不必为了到期硬消费;这是真实使用麦当劳 MCP 的 WorkBuddy Skill,只读查询优惠券与积分,按预算给出最多两套用餐方案,金额都经官方 calculate-price 试算,并明确指出哪些权益不值得为消耗而额外花钱
预算优先于消耗权益,没有合适方案时它会直接说「这次别用」
面向三类人:卡包里攒了一堆券、每次点单前都要翻半天的人;被「今日到期」提示催着下单、事后发现并不划算的人;有预算约束(比如这周只吃一次、只花 30 元)、想吃得明白的人
做的是列出快到期权益(默认 7 天窗口,可调)与有效期、剩余天数,按门店和渠道筛出真正可用的券,对每个候选方案调用官方价格试算给出已验证的应付金额,输出最多两套方案加推荐理由、不建议使用清单与未确认条件,积分与现金分开展示且不做兑换比例换算;不做的是领券、兑换、抽奖、下单、付款等操作,也不估算或编造价格、不推断缺失的到期时间、不假设券可叠加或跨店通用
已在 https://open.mcd.cn/mcp 用手机号登录并激活 MCP Token,配置位置是 ~/.workbuddy/mcp.json(WorkBuddy 的用户级自定义 MCP 配置);配好后需在连接器管理中的自定义连接器里信任该服务并重启 WorkBuddy;mcp-config.example.json 只含 ${MCD_MCP_TOKEN} 占位符,WorkBuddy 不会自动展开,需手工替换且不要把替换后的文件提交到任何仓库;使用时直接用自然语言提问,Skill 会自动接管,先问清预算、就餐方式与门店,再查数据、试算价格并生成结果页
examples/sample-requests.md 里给出三条可直接复制的问法:这周只准备吃一次、预算 30 元时看哪些快到期权益值得用;哪些券 3 天内到期、在深圳科技园到店吃、预算 25 元;以及积分快过期时该不该换,但不要为积分多花钱
mcd-expiry-butler/
├── README.md 本文件
├── CONTEST_DECLARATION.md 参赛声明(取自官方仓库,原样保留)
├── MCP_INTEGRATION.md MCP 工具、调用流程、联调状态
├── mcp-config.example.json 脱敏配置(仅环境变量占位符)
├── workbuddy.md WorkBuddy 专项材料说明
├── skill/mcd-expiry-butler/
│ └── SKILL.md Skill 本体(工作流与规则)
├── src/expiry_butler/
│ ├── core.py 到期判定 / 渠道匹配 / 预算筛选 / 方案生成
│ ├── report.py 单文件 HTML 结果页渲染
│ └── cli.py 命令行入口
├── src/fixtures/
│ ├── demo_case.json 演示样例(标注为样例数据)
│ └── real_case_sanitized.json 真实联调脱敏快照
├── scripts/
│ ├── install_skill.sh 安装到 WorkBuddy
│ └── run_demo.py 演示模式
├── tests/test_core.py 17 个独立逻辑用例
├── demo_output/ 生成的结果页(可截图)
├── docs/ 联调记录、演示脚本、报名草稿
└── examples/sample-requests.md 可直接复制的示例请求| 主要语言 | Python | 许可 | NOASSERTION |
|---|---|---|---|
| 创建时间 | 2026-10-10 | 最近提交 | 2026-10-12 |
| 站内采集 | 2026-11-08 起,连续观察 1 天 | 最近一次 | 2026-11-08 |
最近 1 次采集
这个项目刚进入观察名单,还没有足够的历史数据画曲线。
数据来自 GitHub 公开接口的每日采集快照,star 数为采集当时读到的值, 与 GitHub 页面上显示的实时数字可能有几分钟的差距。 项目名点击可回到 本页。