lzp76995-labb/mcd-fairbite
效率与系统工具为 2–6 人规划预算可核查、兼顾各自口味的麦当劳多人点餐草案,可本地运行或交给 AI Agent。
麦麦同桌(FairBite)把“到底吃什么”变成一份可检查的多人点餐草案:面向 2–6 位共同预算有限、口味不同的同事或朋友。它是一款麦当劳程序员创意开发大赛的独立参赛作品,并非麦当劳官方产品。
生成什么
规划器在给定的 1–12 份候选餐品中搜索,同时满足共同预算与个人预算上限。存在排除条件且成分未知时,会先过滤掉该候选;在可行组合中,先提高最低个人偏好匹配分,再提高整桌匹配分,最后降低总价。README 的虚构示例是 4 人、共同预算 88 元:照顾每个人方案为 84 元、最低匹配 75;总价优先方案为 72 元、最低匹配 50。输出只是草案,不是下单。
三种使用方式
- 本地浏览器演示: 需要 Node.js 22 或更新版本,无需第三方依赖,也不需要模型 API Key。运行
npm start后打开本地页面,可修改预算和偏好、比较三种策略、复制分餐单或下载 JSON,也提供菜单导入和真实联调样例。 - 命令行: 可运行
npm test、npm run demo,或用规划脚本读取示例 JSON 并输出 JSON。 - Agent 技能: 将整个仓库作为
mcd-fairbite文件夹导入支持SKILL.md的客户端,保留src/、scripts/、references/。宿主客户端需连接官方麦当劳 MCP,并按该客户端支持的环境变量方式设置MCD_MCP_TOKEN。项目提供只读 MCP 客户端,语义对话由宿主 Agent 执行。
真实联调与限制
README 记录了一次 2026-10-21 针对官方 https://mcp.mcd.cn 的联调:查询上海一家门店,完成 12 次业务工具调用,四人候选合计 128.50 元,与官方整单报价一致,处于示例 150 元预算内;未创建订单、领券、支付或扣积分。这是带时间的历史快照,价格和可售状态必须重新查询;该测试没有覆盖配送、优惠券、过敏信息或所有门店。
范围限制写得很明确:每人一份完整餐、2–6 人、候选 1–12 份、预算最多 2000 元;只在给定候选集内精确搜索,不宣称全菜单全局最低价;共享拼盘、库存限量、费用分摊和优惠券组合不由算法求解。“不吃”标签仅用于口味筛选,过敏、宗教或医学要求须向官方核实;成分未知且存在排除条件时,规划器会拒绝该候选。输出是草案,实时价格与供应以官方渠道为准。
源码采用 MIT 许可证,但麦当劳的声明、服务、商标及官方返回数据不因本项目开源而改变授权,详见仓库与第三方声明。
HotRepo 点评
HotRepo 在 2026-10-25 观察到该项目位列 javascript 新项目榜第 20 名、总星数 122。这只是一个年轻项目在新项目榜上的单次记录,不是总榜或日榜,也没有足够的可比历史来判断势头。
本文由 AI 根据项目 README 生成,更新于 2026年10月28日,以项目官方文档为准。