1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | mcd-coupon-strategist |
| 项目自述名称 | 麦麦省钱助手 |
| 作者/维护者 | Syenzzz(仓库由 Ayzzz123 账号迁名而来,旧地址 301 跳转) |
| 来源链接 | https://github.com/Syenzzz/mcd-coupon-strategist |
| 许可证 | MIT |
| GitHub Stars / Forks | 993 / 21(GitHub API,2026-10-29 读取) |
| 最新版本 | 未打版本标签;主分支最近一次提交 2026-10-21 |
| 安装方式 | 克隆仓库 + 麦当劳中国 MCP Token + MCP 客户端配置 |
| 数据来源 | 上述数字取自 GitHub API;功能与评分依据来自仓库文档与源码 |
2. 功能介绍与亮点
一句话:把「这一单怎么点最省」和「你正在白扔多少钱」两件事都算给你。
- 两条链路:A 链路枚举点餐方案(单品、套餐、券组合、加购凑单),每个候选都调麦当劳
calculate-price真实计价,输出 1 个推荐加 1~2 个备选;B 链路做消费审计,从历史订单还原月度支出与客单价,量化即将过期券的沉默成本。 - 反凑单陷阱:为用满减券而加购时,同时给出不凑单的对照方案,指出实付反而更高。
- 券包体检与排程:按「净价值 = 券面价值 − 为用它多花的钱」把券分成顺手可用、努一把、纸面富贵、无法判断四类;再按窗口内还会点几单分配用券机会,点明注定浪费多少。
- 积分与活动:体检积分余额、过期与可兑换性;把活动时间线与券的有效期做纯日期比较,回答「等活动再买等不等得起」。
- 工程底子:零第三方依赖,8 套单元测试,4 个 Python 版本的 CI,录制真实响应的离线 demo。
还有一条是克制:明确不越界到营养与健康建议,不估算无法反查的券值,不拿营销文案里的数字算价。
3. 适用场景
所属分类:集成与工作流自动化(主体是连接并操作麦当劳中国 MCP 这一外部系统)。
- 常点麦当劳、手里囤了券,想知道这一单怎么点最省的上班族与学生;
- 券多到记不清有效期,需要提醒「哪几张快过期、值多少钱」的人;
- 想复盘自己在麦当劳花了多少、客单价是否偏高的消费者;
- 看重积分与活动节奏、判断「现在买还是等等」的重度用户。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 需适配 | SKILL.md 为通用 Agent Skills 格式,MCP 用标准 JSON 即可接入;仓库未提供 Claude Code 的安装指引或插件清单,需手动放置技能并自行配置 |
| Codex | 需适配 | 技能文本可直接使用,MCP 配置需按 Codex 的格式改写 |
| OpenClaw | 需适配 | 需平台自带 MCP 客户端能力,并按平台格式配置连接 |
| Hermes Agent | 未验证 | 未找到该平台的接入示例 |
5. 推荐理由
它把「省钱」从口号变成可核对的计算:每个报价都来自 MCP 真实返回,不是模型凭经验估。券的价值被拆成面值与触发成本两部分,净价值为负的券会被明确劝退;用券机会还会被「你还会点几单」约束,避免把纸面优惠说成真省钱。对有囤券习惯的人来说,这类「券快过期」的提醒本身就是可执行的钱。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 993 stars、21 forks,建仓 19 天即近千星;热度与麦当劳中国大赛按 star 排名的赛制相关,GitHub 上无 issue、无合并 PR,第三方平台亦无具名讨论 |
| 可用性 | 8 | 文档含 30KB 的 MCP 接入契约、逐步 Token 指引与 29KB 技能正文;零第三方依赖,python demo.py 离线跑通;CI 覆盖 4 个 Python 版本;真用需申请 Token 并配置 MCP |
| 安全性 | 8 | 见下方清单 |
安全性检查清单:
| 项 | 结果 |
|---|---|
| ① 执行 shell 与权限 | 只调用仓库内 Python 做解析与计价;无 subprocess、无 eval,无提权操作 |
| ② 联网外发 | 代码自身不联网;数据经 MCP 客户端发往麦当劳官方端点 mcp.mcd.cn,目标透明 |
| ③ 凭据 | Token 经环境变量 MCD_MCP_TOKEN 注入,仓库只留占位符,.gitignore 屏蔽 .env 与 *.token |
| ④ 可疑指令 | 未见注入或夹带推广;反倒写了反幻觉、反文案取数的硬规则 |
| ⑤ 作者信誉 | 个人开发者,无造假证据,仓库有完整提交史与 CI |
| ⑥ License | MIT,全文可查 |
| ⑦ 维护时间 | 最后提交 2026-10-21,建仓三周内持续更新 |
扣分点:Token 等同账号凭证,可读订单、券与积分,部分工具是写操作(领券、下单);技能已要求先取得用户同意,但权限面本身不小。
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| mcd-budget-planner | 预算与营养双约束的套餐优选,带在线试算页与 49 项测试 | 强在营养约束与可视化试算;本技能强在券的沉默成本、用券排程与消费审计 |
| mcd-wrapped | 麦当劳数据全景报告、个人年报与方言播报 | 强在报告产出与传播物料;本技能强在逐单计价与券价值判定 |
| McOracle | 以答案之书为灵感的抽签、推荐与命运卡 | 娱乐属性为主;本技能不涉玩法,专注成本 |
核心差异化:同类多停在「查券加比价」,它把「券值多少钱、会不会白扔、机会够不够用」做成可结算的三步。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价,GitHub issues 为零。
9. 其他补充
README 与徽章仍指向旧账号的克隆地址,克隆时以现地址为准。
10. 安装使用方式
- 申请 Token:打开 https://open.mcd.cn/mcp ,手机号登录 → 控制台 → 激活并复制 MCP Token。
- 克隆仓库:
git clone https://github.com/Syenzzz/mcd-coupon-strategist.git - 配置 MCP:把下面的 JSON 写入客户端的 MCP 配置,Token 由环境变量注入。
{"mcpServers":{"mcd-mcp":{"type":"streamablehttp","url":"https://mcp.mcd.cn","headers":{"Authorization":"Bearer ${MCD_MCP_TOKEN}"}}}}
- 把
SKILL.md放进 agent 的技能目录,并让 agent 在仓库根目录调用src/下的模块;WorkBuddy 用户可在连接器页粘贴上面的 JSON。新配置需重新启用或信任才生效。 - 先跑
python demo.py验证环境(离线、零依赖),再开始真实查询;之后直接说「麦当劳怎么点最便宜」即可触发。
11. 注意事项
- 仅适用于麦当劳中国:Token 需中国手机号实名激活,其他地区无法使用。
- Token 等同账号凭证,勿提交到公开仓库;泄露后立即在控制台重置。
- 领券与下单属写操作,执行前务必确认,不要让它替你做决定。
- 价格与券可用性绑定门店与时段,跨店、跨时段数据不可混用;活动文案里的价格不能当计价依据。
- 需在仓库目录内运行其 Python 模块,单独复制 SKILL.md 会缺少适配层。