一起吃，每个人都刚刚好。

为 2–6 位同事或朋友做多人点餐协商：共同预算有限、每个人口味不同，也能得到每人一份、预算可核查、理由说得清的麦当劳点餐草案。

这是麦当劳程序员创意开发大赛的独立参赛作品，非麦当劳官方产品。

需要 Node.js 22 或更新版本，无需安装第三方依赖，无需模型 API Key。

npm start

打开 http://127.0.0.1:4173 ，修改成员预算和偏好，点击生成方案。Windows 也可双击 START.cmd 一键启动，保持启动窗口开启，结束时按 Ctrl+C。页面有三种比较策略、复制分餐单、下载 JSON、导入菜单和真实联调样例。页面不会读取 Token。

npm test
npm run demo
node scripts/plan.mjs examples/demo.json --json

「随便吃什么」往往意味着组局者反复确认预算、口味和价格。FairBite 把这件事拆为可检查的约束：个人预算与共同预算都满足；不吃条件先过滤；在可行方案中先提高最低偏好匹配分，再提高整桌匹配分，最后降低总价。

演示场景：4 人共同预算 88 元。照顾每个人方案为 84 元，最低匹配 75；总价优先方案为 72 元，最低匹配 50。两者的差异可直接比较。以上餐品和价格均为虚构演示，匹配分是规则分。

2026-10-21 20:53:48（北京时间）开始，使用官方 https://mcp.mcd.cn，查询上海黄浦华旭国际大厦餐厅，完成 12 次业务工具调用：时间、门店、菜单、4 份套餐详情、4 次候选计价和 1 次整单计价。

四人方案候选价合计 128.50 元，官方整单 calculate-price 返回 128.50 元，在示例 150 元预算内。没有创建订单、领券、支付或扣积分。

脱敏调用记录见 docs/LIVE_EVIDENCE.json。这是带时间的历史快照，当前价格和可售状态必须重新查询；此测试没有验证过敏信息、配送、优惠券或所有门店。

将整个仓库作为 mcd-fairbite 文件夹导入支持 SKILL.md 的 Agent 客户端；根目录的 SKILL.md 为入口，保留 src/、scripts/、references/。在宿主客户端连接官方麦当劳 MCP，并使用该客户端支持的环境变量配置方式设置 MCD_MCP_TOKEN。不要把真实 Token 放在仓库或聊天记录中。

示例提示词：

使用 mcd-fairbite。我们 4 人到店自取，共同预算 150 元，每人最多 40 元。甲喜欢牛肉，乙和丁喜欢鸡肉，丙喜欢鱼。地点是上海人民广场，先给出门店选择，再生成照顾每个人的方案并复核整单价格。

配置和完整流程见 MCP_INTEGRATION.md。本项目提供官方 MCP 只读客户端，语义对话由宿主 Agent 执行。

在已设置 MCD_MCP_TOKEN 的终端运行：

node scripts/mcp.mjs discover
node scripts/live-demo.mjs 上海市 人民广场 private/live

脚本使用明确的演示地标、首家营业门店、四份已知套餐名称、4 名虚构搭子和 150 元预算。它是可复现的只读联调脚本，实际用餐由 Skill 引导用户选店。菜单发生变化、默认选配缺失或计价失败时会停止，不生成成功证据。输出目录含查询结果，请脱敏后再公开。

每人一份完整餐，2–6 人，候选 1–12 份，预算最多 2000 元。有限候选集内精确搜索，不宣称全菜单全局最低价。共享拼盘、库存限量、费用分摊和优惠券组合不由本地算法求解。导入菜单不等于已验证数据；整单报价必须重新核查预算。

不吃标签只用于口味筛选。涉及过敏、宗教或医学要求须向官方核实。完整成分未知且存在排除条件时，规划器会拒绝该候选。输出是草案，实时价格与供应以麦当劳官方渠道为准。

项目源码以 MIT 许可证提供。官方声明、服务、商标及官方返回数据的权利不因本项目开源而改变，详见 THIRD_PARTY_NOTICES.md。