linzhiqin2003 / mcfit-meal-planner

麦麦健身餐规划师 （McFit Meal Planner）· 健身人群的麦当劳点餐 Skill 项目主页 · 安装 · 开放数据集 
# 麦麦健身餐规划师
> Go to Gym 不如 Go to ᗰ
健身人群的麦当劳点餐 Skill。告诉它这一顿最多吃多少热量、至少要多少蛋白质（还可以说想要「汉堡 + 小食 + 饮料」、想吃健康点），它在你附近的麦当劳里算出**最便宜的几种点法**，写成训练计划卡。它有三个本事：
- **配料级营养计算**：官方只给整份营养，它算到每一种配料。双层吉士汉堡整份 429 大卡，下单去吉士 339 大卡，到手只吃牛肉饼和吉士 272 大卡；巨无霸下单去巨无霸酱，513 → 395 大卡。
- **分顿吃配餐建议**：点两个双吉、都下单去吉士，今晚两片面包夹四块牛肉饼（522 大卡、蛋白质 38 g），另外两片面包留到明早当早餐（157 大卡）。
- **多样省钱搭配**：比如 500 大卡以内、蛋白质 25 克以上、汉堡 + 小食 + 饮料、健康配餐，它按价格排出几套用不同汉堡的组合，随心配、三件套自动套上，汉堡还能下单去酱：
 左起：拆层算热量 · 分顿吃 · 按价格排出的「汉堡 + 小食 + 饮料」（点开看大图） 
| 组合 | 价格 | 这一顿 |
|---|---|---|
| 高达吉士双牛堡 + 小杯玉米杯 + 纯悦 | ¥21.4 | 约 434 大卡 · 蛋白质 26 g |
| 双层吉士汉堡 + 苹果片 + 无糖可乐 | ¥21.9 | 461 大卡 · 蛋白质 27 g |
| 吉士汉堡包 + 小杯玉米杯 + 纯牛奶 | ¥26.0 | 476 大卡 · 蛋白质 25 g |
| 培根蔬萃双层牛堡（下单去酱）+ 小杯玉米杯 + 纯悦 | ¥32.5 | 445 大卡 · 蛋白质 26 g |
| 板烧鸡腿堡 + 小杯玉米杯 + 无糖可乐 | ¥34.0 | 444 大卡 · 蛋白质 25 g |
| 巨无霸（下单去酱）+ 小杯玉米杯 + 无糖可乐 | ¥36.0 | 448 大卡 · 蛋白质 29 g |
（示例门店快照上 `plan --kcal-max 500 --protein-min 25 --meal 汉堡+小食+饮料 --healthy --top 6` 的真实输出；高达吉士双牛堡是新品，营养按配料库估算。）其中第二套写成训练计划卡是这样：
 [code] 
## 它解决什么问题
健身的人想吃麦当劳，难点不在「哪个热量低」，而在：
- **官方只给整份营养。** 双层吉士汉堡 429 大卡、31 克碳水，可如果只吃两块肉饼和芝士呢？面包留着当明天早餐呢？没人告诉你。
- **套餐、加价、单点交织在一起。** 同样的东西，单点、套餐、随心配的价格差很多；随单购的标价要连同会员卡一起买才有。
- **约束一多就算不过来。** 400 大卡以内、蛋白质 30 克以上、碳水尽量少、还要便宜，这是一个组合优化问题。
「麦麦健身餐规划师」的做法：
1. **配料级营养库。** 用 28 款餐品的官方营养和 33 份配方联合求解出每种配料（肉饼、面包、吉士、各种酱）的营养和误差，参考美国麦当劳官网和 USDA 的配料数据。这样「去吉士」「只吃馅」吃进去多少、留下多少，都能算出来。拆不准的吃法不推荐。
2. **约束求解。** 把门店里每个单品、每个套餐的每种选法、每种吃法展开成选项，用分支定界在热量、蛋白质、碳水、脂肪、钠、预算的约束下找最便宜的组合。
3. **实时门店与核价。** 按城市和地点找最近的营业门店，拉实时菜单，用 `calculate-price` 核对价格；用户确认后再下单。
同一家店、同样 400 大卡和 30 克蛋白质：整份吃最便宜是 2 份薄皮焦香V翅，¥32.0；允许只吃馅，2 份「人气经典随心配」高达吉士双牛堡就够，¥27.8，这一顿碳水只有 6 克，面包留作明天的早餐。高达吉士双牛堡是新品，不在官方营养表里，这一份按配料库估算（约 ±27 大卡），卡片上会注明；只用官方营养表里有的餐品，最便宜是麦香鸡去酱和双层吉士汉堡各一份、都只吃馅，¥28.8，碳水 16 克。
## 安装
四步，macOS 和 Windows 都一样。需要 Python 3.9 及以上，只用标准库，不用装依赖：
- **macOS**：系统自带的 `python3` 就够。第一次在终端输入 `python3` 时，如果系统提示安装命令行开发者工具，点「安装」即可。
- **Windows**：从 python.org 下载安装，安装时勾选「Add python.exe to PATH」；也可以在终端运行 `winget install Python.Python.3.12`。
先装好 WorkBuddy 或 Claude Code，并至少打开过一次。
### 1. 下载并安装 Skill
macOS（打开「终端」）：
 [code] 
Windows（打开 PowerShell 或「终端」）：
 [code] 
没有装 git 也行：在本仓库页面点 **Code → Download ZIP**，解压后在解压出来的文件夹里打开终端，再运行最后一行。Windows 上在文件夹空白处右键选「在终端中打开」；macOS 上先在终端输入 `cd `（末尾有空格），再把文件夹拖进终端窗口、按回车。
`install.py` 会自动装进本机已有的客户端：WorkBuddy 装到 `~/.workbuddy/skills/mcfit-meal-planner`，Claude Code 装到 `~/.claude/skills/mcfit-meal-planner`（Windows 上 `~` 是 `C:\Users\你的用户名`）。只想装其中一个，就加上 `--target workbuddy` 或 `--target claude`。Windows 上没有 `py` 命令时，把 `py` 换成 `python`。
### 2. 申请 Token
打开 open.mcd.cn/mcp，用手机号登录后点右上角「控制台」，点「激活」申请麦当劳 MCP Token，复制下来。
### 3. 设置环境变量 MCD_MCP_TOKEN
脚本取菜单、核价时要用。把下面的「你的Token」换成刚复制的 Token。
macOS（终端）：
 [code] 
终端窗口标题里写的是 bash 而不是 zsh 时，把 `~/.zshrc` 换成 `~/.bash_profile`。
Windows（PowerShell）：
 [code] 
设置完要关掉所有终端窗口，**完全退出再重新打开** WorkBuddy 或 Claude Code，新的环境变量才会生效（macOS 上按 Command+Q 退出，不是只关窗口；Claude Code 要从新开的终端启动）。如果 macOS 上重开 WorkBuddy 后仍提示缺 Token（有的桌面应用从程序坞打开时不读 shell 配置），在终端再运行 `launchctl setenv MCD_MCP_TOKEN "你的Toke