janetom645-coder / mcd-buddy

一个真正懂麦当劳的 AI 助手 —— 基于麦当劳中国官方 MCP，把点餐这件事玩出四种花样。
---
## 🎬 30 秒看懂
 上面这两个命令，不用申请 Token， git clone 下来就能跑出一样的输出。 
---
## 👋 认识一下麦麦
**麦麦**是麦门四重奏的吉祥物——一只圆滚滚的汉堡小人，头顶金拱门小帽，笑眯眯的。
它每天的工作，就是帮你把「吃麦当劳」这件小事，变得更有趣、更明白、更划算。
---
## 🎥 完整宣传片（发社交媒体用）
| 横屏 16:9 · 86 秒 | 竖屏 9:16 · 68 秒 |
| --- | --- |
| ▶ `promo/mcquartet-16x9.mp4` | ▶ `promo/mcquartet-9x16.mp4` |
| B 站 / YouTube / 掘金 | 抖音 / 视频号 / 小红书 |
- **片里没有一个是编的数字。** 修行录的 8 单 / ¥138.00 / 3 张卡包券、团餐的 ¥109.50（人均 ¥18.25）、
 隐藏菜单的 2150 → 1212 kcal，全部来自麦当劳中国 MCP 的真实菜单与价格数据。
- **而且你可以自己复现。** 视频里的每一帧数字，都和 `mcd-buddy --demo` 跑出来的完全一致 ——
 不用申请 Token，clone 下来敲一条命令就能看到同一份结果。
- 视频不是录屏，是 `promo/make_promo.py` 用 Pillow 逐帧绘制 + ffmpeg 编码生成的，
 改一句文案、换一个数字就能重新出片。
- 各平台配套文案（含发布节奏与「求 Star」话术）在 `promo/推广文案.md`，
 技术长文在 `promo/掘金长文.md`。
- **想拍一条实拍质感的版本？** `promo/剪映实操脚本.md` 里有完整的
 12 镜拍摄清单、精确到秒的分镜表、逐句字幕文案、音效清单，配 `promo/overlay/`
 的 4 张透明底产品截图，照着铺就能出片。
---
## 🎮 四大玩法
 🧘 修行录 
 🍱 团餐指挥官 
 🧪 隐藏菜单实验室 
 🔮 每日运势签 
 点餐即打卡，解锁成就徽章与「麦门段位」 
 一群人的点单自动合成最优团餐，凑满减、卡预算、避忌口 
 用套餐替换选项重组配方，实时对比营养与价格 
 今天宜吃啥 + 今日活动 + 抽奖吉时，仪式感拉满 
 order-list query-my-account query-my-coupons query-my-prizes now-time-info 
 query-nearby-stores query-meals calculate-price query-my-coupons query-store-coupons 
 query-meal-detail list-nutrition-foods calculate-price 
 now-time-info list-nutrition-foods campaign-calendar query-lottery-info query-my-prizes 
---
## ✨ 长这样
### 🧘 修行录 —— 把吃麦当劳变成一场修行
 [code] 
### 🍱 团餐指挥官 —— 一群人的点单终于不用吵了
 [code] 
### 🧪 隐藏菜单实验室 —— 人人都能发明自己的麦当劳
 [code] 
### 🔮 每日运势签 —— 今天宜吃巨无霸
 [code] 
> 📎 完整输出见 `examples/sample-outputs.md`
---
## 🚀 快速开始
### 1️⃣ 申请麦当劳 MCP Token
前往 **https://open.mcd.cn/mcp** → 右上角【登录】→ 手机号验证 → 【控制台】→【激活】→ 复制 Token。
### 2️⃣ 安装
 [code] 
### 3️⃣ 先玩离线演示（不需要 Token）
 [code] 
### 4️⃣ 接上真实麦当劳 MCP
 [code] 
---
## 🧭 命令一览
| 命令 | 说明 | 关键参数 |
|---|---|---|
| `mcd-buddy practice` | 🧘 修行录 | — |
| `mcd-buddy group-meal` | 🍱 团餐指挥官 | `--people "名字:预算:忌口;…"`（也支持 JSON / `@file`） |
| `mcd-buddy hidden-menu` | 🧪 隐藏菜单实验室 | `--meal ` `--preset 减脂\|增肌\|解馋\|清醒` `--swap 轮次=商品` `--list` |
| `mcd-buddy fortune` | 🔮 每日运势签 | — |
| `mcd-buddy tools` | 列出 MCP Server 全部工具 | — |
**通用参数**
| 参数 | 说明 |
|---|---|
| `--demo` | 离线演示模式，无需 Token |
| `--token` | 指定 MCP Token（默认读环境变量 `MCD_MCP_TOKEN`） |
| `--json` | 输出 JSON（含**未拆信封**的原始工具返回 + 渲染结果） |
| `--city` | 城市名（默认 `深圳市`，也可用环境变量 `MCD_CITY`） |
| `--keyword` | 门店关键词（默认 `麦当劳`，也可用环境变量 `MCD_KEYWORD`） |
| `--store` | 直接指定门店编码，跳过搜索 |
> 💡 `--city` / `--keyword` 只在团餐指挥官和隐藏菜单实验室生效 —— 其余两个模块只用你的账号数据，不依赖门店。
 🍱 团餐指挥官：自定义伙伴需求 
**写法一：直接说人话**（推荐，每个人用 `;` 分隔，字段用 `:` 分隔）
 [code] 
字段按内容自动归类：纯数字 = 预算，`不要/忌/免…` 开头 = 忌口，`要/想吃…` 开头 = 口味，
其余第一个字段 = 名字。`--people "小王:预算25:不要辣,不要香菜"` 这种混写也能识别。
**写法二：JSON**（适合脚本调用）
 [code] 
**写法三：从文件读取** —— `--people @examples/people.json`
字段说明：`name` 姓名、`budget` 预算（元）、`want` 想吃什么、`avoid` 忌口列表。
匹配优先级：**忌口 > 口味 > 预算**。预算内取**最接近预算**的一份，而不是最便宜的那份；
如果为了满足口味不得不超预算，会在「匹配说明」里写明。
 🧪 隐藏菜单实验室：自定义替换 
先看看这个门店有什么、套餐能怎么换：
 [code] 
再按「轮次 = 商品」指定替换（轮次可以是编号，