麦享掌柜 · mc-points-steward
一个替你打理麦当劳积分资产的 WorkBuddy Skill —— 查得清账、剔得掉假、算得出值、守得住手。
麦当劳中国 MCP 开发者创新大赛
WorkBuddy Skill
纯 Python 标准库
MIT
本页是什么：这是作品的离线在线演示——
所有数字来自 2026-10-12 对麦当劳官方 MCP 的真实调用快照，
由脚本自动渲染，无需 Token、无需安装即可看到完整效果。
真实使用时连接
mcd-mcp 即可获取实时数据。
01一图看懂：积分资产体检报告
这张图不是手工绘制的，是 make_report_svg.py 从真实调用快照实算生成。
02你有多少积分，掌柜就怎么答
不同积分余额拿到的是完全不同的答案。天梯分界（24 / 50 / 100 / 200 / 500 / 800 分）与各级解锁件数，由 make_points_ladder.py 从真实商城数据实算。
03动态演示：完整跑一遍
终端风录屏，文字与 python scripts/demo.py 实际输出逐字一致。
04三段输出原文
与 Skill 真实运行时的输出格式完全一致（此处为离线快照）。
W1 · 积分账本
╔══════════════════════════════════╗
║ |\/| 麦享掌柜 ║
║ |/\| 积分资产管家 ║
╚══════════════════════════════════╝
本演示使用仓库内数据快照（2026-10-12 真实调用），
无需麦当劳 MCP Token 即可复现 Skill 的完整输出效果。
账户 ID 已脱敏。实际使用时请连接 mcd-mcp 获取实时数据。
──────────────────────────────────
麦享掌柜 · 积分账本（W1）
──────────────────────────────────
可用积分 0 分
── 来龙去脉 ─────────────────────────
累计获得 0 分
已使用 0 分
已过期 0 分
冻结中 0 分
── 到期提醒 ─────────────────────────
本月将过期 0 分
下月将过期 0 分
上月已过期 0 分
──────────────────────────────────
掌柜批注
账上是空的。这不要紧——眼下商城
真能兑的有 9 件（见下一段），攒够就开张。
三条攒分路子（客观列出，不催你）：
① 消费累积 —— 每笔订单自动计分
② 活动赠送 —— 麦金学期卡学生
49 元/150 天，赠多邻国月卡
③ 抽奖 —— 24 分/次；奖池 10 品里
仅 1 品返 30 积分，命中率未知，
不算攒分主路径
── 过期止损 ─────────────────────────
最低可兑门槛 50 分（6.9元可乐麦炫酷）
· 本月将过期 0 分
· 下月将过期 0 分
──────────────────────────────────
── 资产现值 ─────────────────────────
按最优出口折算（6.9元可乐麦炫酷，50 分）：
每 100 积分现值 ¥13.79
⚠️ 但每件都要到店另付现金（见下一段）
──────────────────────────────────
账户 02007421*****************7704 · 麦享会积分
──────────────────────────────────
数据来源 tests/fixtures/：account_20261012.json ·
mall_products_cat_1_4_20261012.json ·
mall_products_cat_2_8_20261012.json ·
mall_products_20261012.json（默认查询，用于对比漏报）·
lottery_info_20261012.json
──────────────────────────────────
W2 · 积分商城真实可兑榜单
╔══════════════════════════════════╗
║ |\/| 麦享掌柜 ║
║ |/\| 积分资产管家 ║
╚══════════════════════════════════╝
本演示使用仓库内数据快照（2026-10-12 真实调用），
无需麦当劳 MCP Token 即可复现 Skill 的完整输出效果。
账户 ID 已脱敏。实际使用时请连接 mcd-mcp 获取实时数据。
──────────────────────────────────
积分商城 · 真实可兑榜单（W2）
──────────────────────────────────
27 件在售 → 去伪后 9 件真可兑
⚠️ 默认查询漏报 2 件，已按类目补回：
+ 16.9元2份麦辣鸡翅 200 分
+ 3.9元圆筒冰淇淋 100 分
⚪ 普通
6.9元可乐麦炫酷 50分 7.25 分/元
└ 2026-12-30 23:59:59 下架 · 还差 50 分 · 到店另付 ¥6.9
6.9元香芋派/菠萝派任选 50分 7.25 分/元
└ 2026-12-30 23:59:59 下架 · 还差 50 分 · 到店另付 ¥6.9
10.9元指定小食任选 100分 9.17 分/元 ⚠️同名
└ 2026-12-30 23:59:59 下架 · 还差 100 分 · 到店另付 ¥10.9
16.9元2份麦辣鸡翅 200分 11.83 分/元
└ 2026-12-30 23:59:59 下架 · 还差 200 分 · 到店另付 ¥16.9
10.9元指定小食任选 200分 18.35 分/元 ⚠️同名
└ 2026-12-30 23:59:59 下架 · 还差 200 分 · 到店另付 ¥10.9
3.9元圆筒冰淇淋 100分 25.64 分/元
└ 2026-12-30 23:59:59 下架 · 还差 100 分 · 到店另付 ¥3.9
🔷 稀有
17.9元板烧可乐组合 500分 27.93 分/元
└ 2026-12-30 23:59:59 下架 · 还差 500 分 · 到店另付 ¥17.9
16.9元麦辣可乐组合 500分 29.59 分/元
└ 2026-12-30 23:59:59 下架 · 还差 500 分 · 到店另付 ¥16.9
21.9元巨无霸可乐组合 800分 36.53 分/元
└ 2026-12-30 23:59:59 下架 · 还差 800 分 · 到店另付 ¥21.9
── 隐藏现金成本 ───────────────────────
🔴 真可兑 9 件 → 9 件需到店另付现金，纯积分白拿 0 件
另付区间 ¥3.9 ~ ¥21.9
这笔钱不在列表接口里（extTradePrice 只在详情中），
只看列表就推荐 = 告诉用户「100 分白拿冰淇淋」，其实是 100 分 + 3.9 元。
── 余额分档 · 你有 0 分 ────────────────
现在能兑 0 件 · 还锁着 9 件
下一档 50 分 · 还差 50 分 · 解锁 2 件
→ 6.9元可乐麦炫酷
→ 6.9元香芋派/菠萝派任选
── 同名陷阱 1 组 ─────────────────────
⚠️ 10.9元指定小食任选
100 分 · 另付 ¥10.9 · 中薯条/奥利奥麦旋风 任选1件
200 分 · 另付 ¥10.9 · 麦乐鸡-4块/麦辣鸡翅-2块/那么大鸡排（椒盐风味）任选1件
→ 同名不同物，不是谁更贵的问题，按想吃什么选
── 已剔除 18 件 ─────────────────────
名存实亡 18 件（标 status=2 上架，实则已过期）
☠️ Nike Book 2 麦当劳特别联名款 8888 分
下架于 2026-06-05 16:00:00
☠️ 罗技键鼠套装 6666 分
下架于 2026-08-21 23:59:59
☠️ 28.9元板烧四件套 800 分
下架于 2026-06-24 23:59:59
…… 其余 15 件见图鉴 · 绝版栏
现金商品 本段未含（默认查询另有 26 件，派对/品鉴会/体验营）
──────────────────────────────────
图鉴进度 金拱门限定 0 / 9
已绝版收藏 18 件
限时掉落 当前无
──────────────────────────────────
注：券面价由商品名解析（price 恒为 0，不是市价）
──────────────────────────────────
数据来源 tests/fixtures/：account_20261012.json ·
mall_products_cat_1_4_20261012.json ·
mall_products_cat_2_8_20261012.json ·
mall_products_20261012.json（默认查询，用于对比漏报）·
lottery_info_20261012.json
──────────────────────────────────
W3 · 积分抽奖参谋
╔══════════════════════════════════╗
║ |\/| 麦享掌柜 ║
║ |/\| 积分资产管家 ║
╚══════════════════════════════════╝
本演示使用仓库内数据快照（2026-10-12 真实调用），
无需麦当劳 MCP Token 即可复现 Skill 的完整输出效果。
账户 ID 已脱敏。实际使用时请连接 mcd-mcp 获取实时数据。
──────────────────────────────────
积分抽奖 · 参谋（W3）
──────────────────────────────────
麦麦积分抽奖
状态 进行中 · 至 2030-12-31
单次消耗 24 积分 · 你的可用 0 分
── 奖池 10 品 ──────────────────────
· 下单立减3元券 [优惠券]
· 下单立减2元券 [优惠券]
· 下单立减1元券 [优惠券]
· 麦辣三件套5折券 [优惠券]
· 板烧三件套5折券 [优惠券]
· 双层鳕鱼三件套6折券 [优惠券]
· 甜辣小食组合5折券 [优惠券]
· 小食四件套5.5折券 [优惠券]
· 麦旋风5折券 [优惠券]
· 30积分 [积分奖]
── 资格判定 ─────────────────────────
⛔ 暂不可抽 —— 积分不足
（资格只信 drawDecision，不由积分余额自行推断）
── 机会成本（无概率，不算期望） ───────────────
抽 1 次消耗 24 分 ≈ 放弃确定券面 ¥3.31
（按最优出口 7.25 分/元折算）
若命中「30 积分」净得 +6 分；其余 9 品是券
⚠️ 接口无中奖概率，期望值保持未知——是否要抽，你拍板。
──────────────────────────────────
──────────────────────────────────
数据来源 tests/fixtures/：account_20261012.json ·
mall_products_cat_1_4_20261012.json ·
mall_products_cat_2_8_20261012.json ·
mall_products_20261012.json（默认查询，用于对比漏报）·
lottery_info_20261012.json
──────────────────────────────────
05它挖出了三个官方接口不会告诉你的问题
| 问题 | 实测结论 | 后果 |
|---|---|---|
| 假上架 | 27 件标 status=2 的积分类商品中，18 件的下架时间早已过去 |
货架 67% 是名存实亡的 |
| 隐藏现金成本 | 9 件真可兑商品，0 件是纯积分白拿（extTradePrice 只在详情接口） |
「100 分换冰淇淋」实为 100 分 + ¥3.9 |
| 默认查询漏报 | 不传 catRuleIds 会少返回 2 件真能兑的商品 |
漏报率 22% |
06手机端预览
竖版 / 方版预览图，数字与 GIF/SVG 同源，全部由 fixtures 实算。
07安全边界
涉及不可逆操作（兑换下单 mall-create-order、抽奖 draw-lottery）时，
Skill 一定先把商品名、积分、有效期、到店另付金额摆出来，
等你明确说「确认」才动手。资格判定只信官方的 drawDecision，
不由积分余额自行推断。