qqqqqq-stu / mcparallel

# 🍔 麦门平行宇宙 McParallel
> 基于麦当劳官方 MCP 的**三合一** AI 点餐 Skill —— **你点什么，决定你是谁。**
**当点麦当劳变成一场人格鉴定。** 不知道吃什么？抽三张牌（还自动帮你算最优惠买法）。想知道你是谁？六大人格宇宙 46 种人格等你鉴定，生成可分享的麦门身份卡。想吃得明白？健身高碳日、减脂 500 大卡线、学生党省钱数学，全部由真实数据算给你看。
> 🏆 本项目参加 麦当劳程序员节创意开发大赛。全部餐品/价格/营养/门店/优惠券数据来自 麦当劳官方 MCP 实时调用——**命运可以随机，价格必须真实。**
## 三合一 · 三层咬合（不是三个功能，是一个产品）
决定吃什么（抽卡）↔ 你是谁（人格）↔ 怎么吃最值（指南）——三层共享同一个数据底座（菜品五维标签矩阵）与同一个用户状态（人格向量），收敛为一张可分享的麦门身份卡。鉴定出的人格实时加权你的抽卡池，身份卡自带专属省钱攻略，任一入口进入都能走完全程。
| 层 | 一句话 | 怎么实现 |
|---|---|---|
| 🃏 **决定层** · 三连抽 | 主食/小吃/饮品各抽一张（人格向量加权），自动计算**最优惠购买方案**：直接单点 vs **1+1 随心配** vs 用券，实时算价比对 | `query-meals` 三池 × `query-meal-detail` 蓝粉区解析 × `calculate-price` 实算 × `query-store-coupons` |
| 🧬 **身份层** · 麦人格鉴定 | 六大宇宙任你测（🍔 单品人格 × 🎮 游戏战术 × 💼 打工人 × 🧠 麦门16型 × 🎬 创作者 × 🎤 主播），3 道场景题出**五维雷达身份卡** + 适配套餐 + 专属省钱 tip | 营养数据量化五维标签矩阵 × 中心化余弦双向匹配 × LLM 文案（黑名单过滤）× SVG 卡片渲染 |
| 📖 **实用层** · 高性价比指南 | 健身高碳/低碳日菜单、减脂 500 大卡线、学生党 kcal/元排行与预算搜索、打工人活动日历——**每个数字都是算出来的** → GUIDE.md | `list-nutrition-foods` 160 条营养数据 × `calculate-price` 实算 × 券策略 × `campaign-calendar` |
### 麦门身份卡（可分享的社交货币）
 [code] 
生成 1200×1680 SVG 身份卡（GitHub 原生可渲染）：五维雷达图（你的口味向量 vs 人格画像叠加）+ 契合度 + 实时适配套餐 + 专属省钱 tip + 人格推荐语。示例见 output/cards/。
## 🖥️ 30 秒看效果
 [code] 
## 快速开始
 [code] 
MCP 客户端配置见 mcp-config.example.json；WorkBuddy 技能定义见 SKILL.md。MIT License，见 LICENSE。
## 技术架构
 [code] 
- **取数交给 MCP，算术交给代码，表达交给 LLM**：标签/匹配/优惠全为可单测的确定性代码，LLM 只写文案且过黑名单（竞品/真人/角色名/占卜用语）。
- **零门槛**：纯 Python 标准库（零第三方依赖）+ fixtures 离线回放，无需 Token 跑通全流程。
- **诚实边界**：价格来源逐项标注（实算/估算）；券不参与最优判定；未验证能力如实声明（见能力矩阵）。
- **实测彩蛋**：随心配子项的 code 与菜单单品不是一套体系（菜单可乐 `9900008751` vs 粉区可乐中杯 `3050`），优惠引擎用 code+名称双轨匹配解决——详见 docs/mcp-tools.md。
## 项目结构
 [code] 
## 开发状态
- [x] MCP 全量工具探测与全链路验证（35 tools）
- [x] 统一数据底座：三池分类 × 五维标签矩阵 × 六宇宙 46 人格库 × 双向匹配
- [x] 板块一：三连抽（人格加权）+ 最优购买方案引擎（1+1 路径实测省 ¥18.1）
- [x] 板块二：场景题流 + LLM 文案层（黑名单）+ SVG 身份卡渲染
- [x] 板块三：高性价比指南引擎 + GUIDE.md 生成
- [x] 统一 CLI + 零 Token 离线 Demo + 59 项单元测试
- [x] WorkBuddy SKILL.md + 比赛必备四件套
- [x] WorkBuddy 真实联调（4 段对话实测通过，记录已回填 workbuddy.md）
- [ ] 传播物料（Demo GIF / 短视频 / 发布帖）
## 声明
本项目为麦当劳程序员节创意开发大赛参赛作品，由参赛者独立开发，非官方产品。输出的餐品信息、价格及供应状态以麦当劳官方渠道的实时结果为准；推荐与人格内容仅供娱乐参考，健康饮食请遵循均衡膳食原则。