kergee/mcd-undercover

选用指南

AI 根据 README 整理 · 2026/10/17 00:41:24

使用方式

通过网页游玩，支持本机运行，需Node.js 20.11+，无第三方依赖。

查看 README 依据

支持两档难度、发言计时，以及 5 人起可选的白板模式。白板没有餐品词，与卧底同阵营。连续开局时，优先避开最近 3 组词对；候选不足会逐步放宽。 ## 真实菜单如何变成游戏 通过麦当劳官方 MCP 查询门店和当前菜单，筛选可识别单品，生成同类餐品词对。名称相似度参与难度排序；两款餐品都精确匹配到官方热量数据时，热量接近程度也参与排序。 - 使用 `query-nearby-stores`、`query-meals`、`list-nutrition-foods` 三个只读工具。 - 结果页标注菜单来源与获取时间，展示已匹配的营养信息；缺失数据保留未知。 - 仅查询，不下单、不领券，也不读取历史订单。 集成流程与真实调用说明见 [MCP_INTEGRATION.md](https://github.com/kergee/mcd-undercover/blob/main/MCP_INTEGRATION.md)。 ## 本机运行 需要 **Node.js 20.11+**，无第三方运行依赖，无需执行 `npm install`。 ```powershell git clone https://github.com/kergee/mcd-undercover.git cd mcd-undercover npm start ```

已知限制

当前为面对面同机游戏，不支持远程开房；对局仅保存在页面内存，刷新会清空；菜单为获取时快照，不保证之后仍在售。

查看 README 依据

打开终端显示的本机地址，默认是 `http://127.0.0.1:4317`。Windows 也可双击 `启动游戏.cmd`。 连接真实菜单时，Windows 用户双击 `启动真实菜单.cmd`，在本机终端隐藏输入 Token，再从网页“菜单补给站”选择门店。已有菜单包 JSON 则直接导入。凭证不写入源码，也不传给游戏网页。 ## 开发与文档 ```powershell npm test npm run check ``` - [Skill 使用说明](https://github.com/kergee/mcd-undercover/blob/main/SKILL.md) - [验证记录](https://github.com/kergee/mcd-undercover/blob/main/docs/VALIDATION.md) - [开发记录](https://github.com/kergee/mcd-undercover/blob/main/workbuddy.md) - [参赛声明](https://github.com/kergee/mcd-undercover/blob/main/CONTEST_DECLARATION.md) 当前为面对面同机游戏，暂不支持远程开房。对局只保存在当前页面内存中，刷新会清空；菜单为获取时快照，不保证之后仍在售。