kergee / mcd-undercover

# 麦麦谁是卧底 🍔
**把今天的菜单，变成朋友之间的推理局。**
3～8 人，一部手机。大家拿到相似的餐品词，轮流描述、投票，找出拿了不同菜单的那位朋友。适合同事午休、朋友聚会和线下社团活动，无需购买餐品。
**立即试玩 →**
> 在线版提供示例词库，也支持导入真实菜单包。真实菜单通过本机服务或麦当劳 MCP 客户端查询；在线页面不直接连接个人账户。
## 怎么玩
1. **秘密上桌**：设置昵称、人数和难度，把手机传给每个人，私密查看自己的餐品词。
2. **一句线索**：依次描述餐品，不能直接说出完整名称；可以记下本局金句。
3. **找出演技派**：逐人私密投票，只展示合计票数。最高票出局；平票加投一次，再平票则进入下一轮。
4. **揭晓与分享**：卧底阵营全部出局，队员获胜；卧底阵营人数达到或超过队员，则卧底阵营获胜。结束后可下载 PNG 战报。
支持两档难度、发言计时，以及 5 人起可选的白板模式。白板没有餐品词，与卧底同阵营。连续开局时，优先避开最近 3 组词对；候选不足会逐步放宽。
## 真实菜单如何变成游戏
通过麦当劳官方 MCP 查询门店和当前菜单，筛选可识别单品，生成同类餐品词对。名称相似度参与难度排序；两款餐品都精确匹配到官方热量数据时，热量接近程度也参与排序。
- 使用 `query-nearby-stores`、`query-meals`、`list-nutrition-foods` 三个只读工具。
- 结果页标注菜单来源与获取时间，展示已匹配的营养信息；缺失数据保留未知。
- 仅查询，不下单、不领券，也不读取历史订单。
集成流程与真实调用说明见 MCP_INTEGRATION.md。
## 本机运行
需要 **Node.js 20.11+**，无第三方运行依赖，无需执行 `npm install`。
 [code] 
打开终端显示的本机地址，默认是 `http://127.0.0.1:4317`。Windows 也可双击 `启动游戏.cmd`。
连接真实菜单时，Windows 用户双击 `启动真实菜单.cmd`，在本机终端隐藏输入 Token，再从网页“菜单补给站”选择门店。已有菜单包 JSON 则直接导入。凭证不写入源码，也不传给游戏网页。
## 开发与文档
 [code] 
- Skill 使用说明
- 验证记录
- 开发记录
- 参赛声明
当前为面对面同机游戏，暂不支持远程开房。对局只保存在当前页面内存中，刷新会清空；菜单为获取时快照，不保证之后仍在售。
代码采用 MIT 许可。本项目为独立趣味作品，非麦当劳官方产品；品牌与接口数据的权利归各自权利人。