gaojimmy27/mcd-group-order

选用指南

AI 根据 README 整理 · 2026/10/22 02:46:26

适用场景

适合多人聚餐点麦当劳时统一收集订单、计算每人应付金额的场景。

查看 README 依据

# 🍔 麦麦拼单官（mcd-group-order） > 聚餐点麦当劳，一群人各自选、一个人下单，自动算清**每个人该付多少钱**。 麦当劳中国 MCP × WorkBuddy 程序员创意开发大赛参赛作品。 ## ✨ 功能 - 🧾 **多人拼单**：支持大家陆续报单（渐进收集），也能一次性贴入。 - 💰 **AA 分账**：三种策略，输出每人应付明细，合计严格等于实付总额。 - 🛒 **一人下单**：有麦当劳 MCP Token 时由一人统一 `create-order` 支付。 - 📅 **可选预约**：可结合门店预约能力，约同一取餐 / 送达时间。 - 🚫 **零依赖降级**：没 Token 也能本地算分账，纯 Python 标准库，无需联网。 ## 🚀 快速开始（本地演示，无需 Token） ```bash # 1) 拉菜单并编号展示（无 Token 用内置示例菜单；有 Token 时由 WorkBuddy 调 query-meals 拉真实菜单） python scripts/mcd_group_order.py menu --session ./mcd_session.json # 2) 大家按编号接龙点单，零拼写错误

使用方式

通过命令行脚本使用，支持菜单展示、添加点单、结算分账等操作。

查看 README 依据

# 🍔 麦麦拼单官（mcd-group-order） > 聚餐点麦当劳，一群人各自选、一个人下单，自动算清**每个人该付多少钱**。 麦当劳中国 MCP × WorkBuddy 程序员创意开发大赛参赛作品。 ## ✨ 功能 - 🧾 **多人拼单**：支持大家陆续报单（渐进收集），也能一次性贴入。 - 💰 **AA 分账**：三种策略，输出每人应付明细，合计严格等于实付总额。 - 🛒 **一人下单**：有麦当劳 MCP Token 时由一人统一 `create-order` 支付。 - 📅 **可选预约**：可结合门店预约能力，约同一取餐 / 送达时间。 - 🚫 **零依赖降级**：没 Token 也能本地算分账，纯 Python 标准库，无需联网。 ## 🚀 快速开始（本地演示，无需 Token） ```bash # 1) 拉菜单并编号展示（无 Token 用内置示例菜单；有 Token 时由 WorkBuddy 调 query-meals 拉真实菜单） python scripts/mcd_group_order.py menu --session ./mcd_session.json # 2) 大家按编号接龙点单，零拼写错误

python scripts/mcd_group_order.py add --who 张三 --pick "1,3" --session ./mcd_session.json python scripts/mcd_group_order.py add --who 李四 --pick "5" --session ./mcd_session.json python scripts/mcd_group_order.py add --who 王五 --pick "11,17" --session ./mcd_session.json # 3) 结算（整单满100减20，外送6元） python scripts/mcd_group_order.py checkout --coupon 20 --delivery-fee 6 --session ./mcd_session.json ``` 输出示例（接龙链 + 分账）： ``` 📝 接龙：张三[1,3] 李四[5] 王五[11,17] 原价合计 ¥97.00 👤 张三 原价 ¥37.00 分摊优惠 -¥7.63 分摊运费 +¥2.29 ➡️ 应付 ¥31.66 👤 李四 原价 ¥42.00 分摊优惠 -¥8.66 分摊运费 +¥2.60 ➡️ 应付 ¥35.94

部署要求

需要Python环境，使用麦当劳MCP真实下单需申请MCP Token并配置。

查看 README 依据

👤 王五 原价 ¥18.00 分摊优惠 -¥3.71 分摊运费 +¥1.11 ➡️ 应付 ¥15.40 原价合计 ¥97.00 | 整单优惠 -¥20.00 | 运费 +¥6.00 💰 实付总额 ¥83.00 （由下单人统一支付） ``` ## 🍱 分账策略 | 策略 | 说明 | |---|---| | `ratio`（默认） | 优惠 + 运费按每人原价占比分摊，最公平通用 | | `payer_coupon` | 优惠归下单人，其余人仅付原价 + 均摊运费 | | `split` | 提示每人各自用自己券下单，本表仅列原价 + 均摊运费 | ## 🔌 接入麦当劳 MCP（真实下单） 1. 到 [open.mcd.cn/mcp/doc](https://open.mcd.cn/mcp/doc) 申请你的 MCP Token。 2. 在 WorkBuddy 连接器管理页配置 `mcd-order`（地址 `https://mcp.mcd.cn`，Header `Authorization: Bearer <Token>`）并信任。 3. 把本仓库作为 WorkBuddy Skill 安装后，直接对话即可：「聚餐点麦当劳，大家报单，最后算每人多少」。 ## 📦 安装为 WorkBuddy Skill