Mcd Health Check — Development skill for Claude Code

麦门健康体检官 · mcd-health-check

把你真实的麦当劳消费数据，变成一份体检报告。

一个基于**麦当劳官方 MCP Server** 的 Agent Skill。它不生成建议清单，而是拿你真实的订单、积分和优惠券，算出一个可复现的**麦门健康分**，并给出「该做什么」的行动项和一张可分享的报告卡。

麦门健康分 68.1（C）
最短板在「权益把控」（33.5 分）——你的账户里有这张券还没用，还剩 1 天。


上面这张是**内置合成数据**跑出来的示例（`--demo`），不含任何真实账户信息。

**在线看示例**：[demo/report_demo.html](demo/report_demo.html) —— 浏览器直接打开即可。

---

为什么做这个

麦当劳 MCP 提供了 35 个工具，能查订单、查营养、查积分、查券。但原始数据是「能查到」，不是「看完知道该做什么」：

• 券的到期时间藏在 markdown 文本里，没人提醒
• 积分过期了（expiredPoint）大多数人不看
• 营养表 158 条全是单品，套餐得自己拆才知道一餐多少热量
• 单餐钠摄入能占到每日上限的 74%，但没人算过

这个 Skill 把这四件事补上，并且**每一分都可追溯到 MCP 返回的原始数据**。

亮点

套餐拆解	order-list 的 comboItemList 拆开再算营养，营养表里只有单品不做拆解等于算不出来
分级匹配 + 公开覆盖率	精确 / 近似 / 品类估算 / 未覆盖四级，报告底部如实给出覆盖率，估算值标 ≈
券到期预警	从 markdown 返回里正则出券的到期时间，按 MCP 服务器时间算剩余天数
积分体检	同时看可用、累计、已用、已过期、本月将过期五个口径，不只看余额
只读安全	全程只调用 8 个只读工具，领券/抽奖/下单一律不碰
零依赖	纯 Python 标准库，完整实现 MCP Streamable HTTP 握手

快速开始

1. 拿 Token

到 [open.mcd.cn/mcp](https://open.mcd.cn/mcp) 用手机号登录 → 控制台 → 激活 → 复制 MCP Token。

2. 跑起来

git clone https://github.com/nihaobeijing/mcd-health-check.git
cd mcd-health-check

export MCD_TOKEN=你的Token

# 拉取 MCP 数据（8 个只读工具）
python3 scripts/fetch_raw.py --out raw

# 生成体检报告
python3 scripts/health_report.py --raw-dir raw --out out --name "你的昵称"

产出三个文件：

文件	说明
out/report.html	自包含的可分享报告卡（内联 CSS/SVG，单文件，可直接发朋友圈）
out/report.md	文字版报告
out/report.json	结构化指标，便于二次分析

Python 3.8+，**不需要 pip install 任何东西**。

2.5 先看看效果（不需要 Token）

python3 scripts/health_report.py --demo --out out --name "示例麦门人"

演示模式用内置的合成数据跑同一条流水线，不会访问任何真实账户。

3. 作为 Skill 使用

本目录符合 [Agent Skills](https://agentskills.io/specification) 规范，复制到技能目录即可被识别：

cp -r mcd-health-check ~/.commandcode/skills/        # Command Code
cp -r mcd-health-check ~/.claude/skills/             # Claude Code

之后直接说「来份麦门体检」「我的麦当劳消费分析」就能触发。

如果你的 MCP