lzp76995-labb/mcd-fairbite

选用指南

AI 根据 README 整理 · 2026/10/24 20:26:33

使用方式

通过命令行启动本地服务，在浏览器中操作；也可作为Agent Skill使用，需连接官方MCP并设置环境变量。

查看 README 依据

# 麦麦同桌 · FairBite **一起吃，每个人都刚刚好。** 为 2–6 位同事或朋友做多人点餐协商：共同预算有限、每个人口味不同，也能得到每人一份、预算可核查、理由说得清的麦当劳点餐草案。 这是麦当劳程序员创意开发大赛的独立参赛作品，非麦当劳官方产品。  ## 30 秒体验 需要 Node.js 22 或更新版本，无需安装第三方依赖，无需模型 API Key。 ```sh npm start ``` 打开 http://127.0.0.1:4173 ，修改成员预算和偏好，点击生成方案。Windows 也可双击 `START.cmd` 一键启动，保持启动窗口开启，结束时按 Ctrl+C。页面有三种比较策略、复制分餐单、下载 JSON、导入菜单和真实联调样例。页面不会读取 Token。 ```sh npm test npm run demo node scripts/plan.mjs examples/demo.json --json ``` ## 为什么需要它

将整个仓库作为 `mcd-fairbite` 文件夹导入支持 `SKILL.md` 的 Agent 客户端；根目录的 [SKILL.md](SKILL.md) 为入口，保留 `src/`、`scripts/`、`references/`。在宿主客户端连接官方麦当劳 MCP，并使用该客户端支持的环境变量配置方式设置 `MCD_MCP_TOKEN`。不要把真实 Token 放在仓库或聊天记录中。 示例提示词： > 使用 mcd-fairbite。我们 4 人到店自取，共同预算 150 元，每人最多 40 元。甲喜欢牛肉，乙和丁喜欢鸡肉，丙喜欢鱼。地点是上海人民广场，先给出门店选择，再生成照顾每个人的方案并复核整单价格。 配置和完整流程见 [MCP_INTEGRATION.md](MCP_INTEGRATION.md)。本项目提供官方 MCP 只读客户端，语义对话由宿主 Agent 执行。 ## 可复现的真实联调 在已设置 `MCD_MCP_TOKEN` 的终端运行： ```sh node scripts/mcp.mjs discover node scripts/live-demo.mjs 上海市 人民广场 private/live ```

部署要求

需要Node.js 22或更新版本，无需第三方依赖和模型API Key；作为Skill使用时需设置MCD_MCP_TOKEN。

查看 README 依据

# 麦麦同桌 · FairBite **一起吃，每个人都刚刚好。** 为 2–6 位同事或朋友做多人点餐协商：共同预算有限、每个人口味不同，也能得到每人一份、预算可核查、理由说得清的麦当劳点餐草案。 这是麦当劳程序员创意开发大赛的独立参赛作品，非麦当劳官方产品。  ## 30 秒体验 需要 Node.js 22 或更新版本，无需安装第三方依赖，无需模型 API Key。 ```sh npm start ``` 打开 http://127.0.0.1:4173 ，修改成员预算和偏好，点击生成方案。Windows 也可双击 `START.cmd` 一键启动，保持启动窗口开启，结束时按 Ctrl+C。页面有三种比较策略、复制分餐单、下载 JSON、导入菜单和真实联调样例。页面不会读取 Token。 ```sh npm test npm run demo node scripts/plan.mjs examples/demo.json --json ``` ## 为什么需要它

将整个仓库作为 `mcd-fairbite` 文件夹导入支持 `SKILL.md` 的 Agent 客户端；根目录的 [SKILL.md](SKILL.md) 为入口，保留 `src/`、`scripts/`、`references/`。在宿主客户端连接官方麦当劳 MCP，并使用该客户端支持的环境变量配置方式设置 `MCD_MCP_TOKEN`。不要把真实 Token 放在仓库或聊天记录中。 示例提示词： > 使用 mcd-fairbite。我们 4 人到店自取，共同预算 150 元，每人最多 40 元。甲喜欢牛肉，乙和丁喜欢鸡肉，丙喜欢鱼。地点是上海人民广场，先给出门店选择，再生成照顾每个人的方案并复核整单价格。 配置和完整流程见 [MCP_INTEGRATION.md](MCP_INTEGRATION.md)。本项目提供官方 MCP 只读客户端，语义对话由宿主 Agent 执行。 ## 可复现的真实联调 在已设置 `MCD_MCP_TOKEN` 的终端运行： ```sh node scripts/mcp.mjs discover node scripts/live-demo.mjs 上海市 人民广场 private/live ```

已知限制

仅支持2-6人、候选1-12份、预算最多2000元；不处理共享拼盘、库存限量、费用分摊和优惠券组合；不吃标签仅用于口味筛选，过敏等需向官方核实。

查看 README 依据

每人一份完整餐，2–6 人，候选 1–12 份，预算最多 2000 元。有限候选集内精确搜索，不宣称全菜单全局最低价。共享拼盘、库存限量、费用分摊和优惠券组合不由本地算法求解。导入菜单不等于已验证数据；整单报价必须重新核查预算。 不吃标签只用于口味筛选。涉及过敏、宗教或医学要求须向官方核实。完整成分未知且存在排除条件时，规划器会拒绝该候选。输出是草案，实时价格与供应以麦当劳官方渠道为准。 项目源码以 MIT 许可证提供。官方声明、服务、商标及官方返回数据的权利不因本项目开源而改变，详见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。