WilderNoTrack / mcd-calorie-butler

# 麦麦热量管家 · 味热比
**减脂不是少吃你爱的，是先换掉不值这口热量的。**
一个装进 AI 里的麦当劳 Skill。你告诉它今天吃了什么，麦当劳的按官方营养数据记，别的饭说一句就行；它算出这一顿还能吃多少，按你的口味和「味热比」排好一顿麦当劳，用官方接口核完价，等你说一句「下单」。
**打开在线演示**：不用 Token，直接看它怎么调用麦当劳 MCP、怎么按味热比排一顿。
> 非麦当劳官方产品，由参赛者独立开发。内容仅供参考，不构成营养或医疗建议。
## 它干了什么
 [code] 
上面每个数字都来自真实调用：热量来自 `list-nutrition-foods`，价格 ¥25.0 是 `calculate-price` 返回的 `"price":2500`（单位是分）。
## 和常见做法有什么不同
| | 常见的减脂点餐工具 | 麦麦热量管家 |
|---|---|---|
| 一天三顿 | 默认三顿都吃麦当劳 | 麦当劳只是其中一顿，别的饭说一句、AI 估算（标注"估算"） |
| 热量超了 | 推荐热量最低的 | 按**味热比**换：先换不值这口热量的，最爱的最后才动 |
| 口味 | 每次重新说 | **说一次就记住**：去酸黄瓜、可乐去冰，自动写进官方特调参数 |
| 老样子 | 不管 | 放得下就原样保留，放不下才改，每处改动都讲清楚为什么 |
| 数字 | 模型估或算 | 计算脚本算，`calculate-price` 核价；实测估算与官方核价一致 |
| 吃超了 | 建议下一顿少吃 | 不惩罚、不劝饿，给出最轻的选项和"明天再调整" |
## 味热比
**味热比 = 爱吃程度 ÷ 每百大卡热量。**
热量超了要换东西时，比的是**换掉它的代价**：少掉的爱吃程度 ÷ 少掉的热量。代价小的先换。所以可乐换无糖可乐（代价 0）最先，薯条换玉米杯（代价 1.36）最后——薯条是大众最爱，换掉最心疼。
爱吃程度先用大众口味作默认值（来源：麦购网「麦当劳十大最受欢迎产品」综合指数，汇总了大众点评、美团、饿了么的评价与热销情况），榜单外的餐品给中间值 6.0；用户可以随时改，常点的会自动加分。
按大众口味算，**圆筒冰淇淋是麦当劳最值这口热量的（8.9），麦辣鸡腿汉堡和巨无霸最不值（约 1.7）**。
详见 味热比。
## 怎么用
### 1. 申请麦当劳 MCP Token
在 open.mcd.cn/mcp 登录后申请。把 Token 放进环境变量，**不要**写进任何文件或发给别人：
 [code] 
### 2. 在 AI 客户端里连上麦当劳 MCP
参考 mcp-config.example.json。WorkBuddy：左侧【专家·技能·连接器】→【连接器】→【自定义连接器】→【配置MCP】，填入配置并把 `${MCD_MCP_TOKEN}` 换成你的 Token。Claude Code、Cursor、Cherry Studio 同理。
### 3. 安装 Skill
 [code] 
也可以在 WorkBuddy 的技能页上传 `skill/mcd-calorie-butler` 文件夹。需要 Python 3.9+，无第三方依赖。
### 4. 开始
对 AI 说"我在减脂，帮我建个档"，它会问目标、口味、常去的店和老样子。之后每天说"中午吃了……""晚上吃什么麦当劳"就行。
## 不用 Token 先看看
 [code] 
演示页的排餐算法与 Skill 的计算脚本是同一套，数据是录制的真实菜单与营养表。本机配置了 `DEEPSEEK_API_KEY` 时，演示页的午饭可以随便输入，由大模型估算；Key 只在本地服务端读取。
也可以直接跑计算脚本：
 [code] 
## 它怎么工作
 [code] 
- **麦当劳 MCP** 只负责取数和下单，详见 MCP_INTEGRATION.md。
- **计算脚本** `scripts/butler.py` 负责所有数字，模型不心算。
- **AI** 负责听懂你、估算非麦当劳食物、把结果讲清楚。
## 适合谁
- 在减脂、控卡或增肌，但不想和麦当劳绝交的人
- 想吃得心里有数、又懒得每顿查热量表的上班族和学生
- 想和对象/朋友一起点，但各自目标不同的人（一起吃）
## 健康与隐私
- 每日目标不低于基础代谢（女性不低于 1200、男性不低于 1500 大卡），设得更低会被提到下限。
- 吃超了照实记，不劝饿、不评价身材；提到疾病、孕期等情况会建议咨询医生或营养师。详见 健康边界。
- 饮食日记、口味、爱吃程度只存在本机 `~/.mcd-calorie-butler/`。仓库里没有任何 Token 或个人信息。
- 只有你明确说"下单"才会调用 `create-order`；不会自动领券、抽奖、兑换或取消订单。
## 目录
 [code] 
## 许可
MIT。参赛声明见 CONTEST_DECLARATION.md。