SuperBigFatDog/mcd-nearest-deal

选用指南

AI 根据 README 整理 · 2026/10/25 00:26:46

适用场景

适用于在麦当劳点餐时快速找到最近且当前在售所需餐品的门店，并核对券可用性、计算真实到手价、组合搭配方案。

查看 README 依据

# mcd-nearest-deal · 麦当劳最近在售点 > 不问"离我最近的门店是哪家"，只回答"最近一家**有我想要的东西、还用得上我那张券**的门店在哪，要花多少钱"。 麦当劳程序员创意开发大赛参赛作品 · 基于麦当劳中国 MCP 服务开发 --- ## 这个项目解决什么问题 打开麦当劳 App 点餐，通常要经历这么一串折腾： 1. 想吃的巨无霸，家附近三家店，不知道哪家现在有卖 2. 挑了一家点进去，发现早餐档刚过，巨无霸要等到十点半 3. 换成套餐，翻半天券包，不确定这张"满 30 减 8"在这家店能不能用 4. 到结算页才看到配送费 9 块，总价比预想多了十块 5. 放弃，随便点了个别的 四步里每一步都在做信息核对，而且核对的是**分散在不同接口里的三类信息**：门店距离、门店在售状态、门店可用券。 `mcd-nearest-deal` 把这三件事串成一条链路：从最近的店开始，逐家验证"卖不卖"，命中即停；锁店之后再取"门店券 ∩ 我的券"的交集；最后用 MCP 算价接口算出真实到手价，把 2–3 个方案并排给用户。下单是最后一步，且必须用户明确确认。 ### 与常见方案的区别

大多数同类作品做的是"在已有门店里比价"或"在已有菜单里算卡路里"。本项目的落点在**券与库存的交叉验证**：一家店有券但不卖、有货但券不能用，这两种情况在实际点餐里比"哪家便宜两块"更常见，也更影响体验。 ## 目标用户 | 用户 | 场景 | 他真正想知道的 | |---|---|---| | 上班族 | 午休 40 分钟，想快速解决一顿 | 公司楼下哪家店现在能买到，多少钱，几分钟能取 | | 有券的人 | 券包里有十余张券，懒得逐张比 | 我这张券哪家店能用，怎么搭最划算 | | 预算敏感学生 | 一天伙食预算固定 | 25 块以内能吃到什么，含不含配送费 | | 家庭用户 | 一次点多人份 | 附近哪家店品类全，凑单能不能吃到满减 | ## 能做什么 - **最近在售点定位**：给地址或定位，返回最近的、确实在售目标餐品的门店，附距离与替代选项 - **券可用性交叉核对**：门店券与账户券取交集，避免"看着能用结算不行" - **组合搭配**：按预算组 2–3 个方案，单点 / 套餐 / 凑满减各一 - **真实算价**：调 `calculate-price` 得到含配送费、优惠的应付金额，不只报原价 - **多方案比价**：附带脚本做确定性排序，标出差额与"最近≠最便宜"的提示

目标用户

面向上班族、有券的用户、预算敏感的学生和家庭用户等需要快速决策点餐的人群。

查看 README 依据

大多数同类作品做的是"在已有门店里比价"或"在已有菜单里算卡路里"。本项目的落点在**券与库存的交叉验证**：一家店有券但不卖、有货但券不能用，这两种情况在实际点餐里比"哪家便宜两块"更常见，也更影响体验。 ## 目标用户 | 用户 | 场景 | 他真正想知道的 | |---|---|---| | 上班族 | 午休 40 分钟，想快速解决一顿 | 公司楼下哪家店现在能买到，多少钱，几分钟能取 | | 有券的人 | 券包里有十余张券，懒得逐张比 | 我这张券哪家店能用，怎么搭最划算 | | 预算敏感学生 | 一天伙食预算固定 | 25 块以内能吃到什么，含不含配送费 | | 家庭用户 | 一次点多人份 | 附近哪家店品类全，凑单能不能吃到满减 | ## 能做什么 - **最近在售点定位**：给地址或定位，返回最近的、确实在售目标餐品的门店，附距离与替代选项 - **券可用性交叉核对**：门店券与账户券取交集，避免"看着能用结算不行" - **组合搭配**：按预算组 2–3 个方案，单点 / 套餐 / 凑满减各一 - **真实算价**：调 `calculate-price` 得到含配送费、优惠的应付金额，不只报原价 - **多方案比价**：附带脚本做确定性排序，标出差额与"最近≠最便宜"的提示

使用方式

作为WorkBuddy技能使用，将仓库放入技能目录后，通过对话交互调用。

查看 README 依据

本仓库**根目录即技能目录**：`SKILL.md` 在根目录，`references/`、`scripts/` 也在根目录下。安装就是把整个仓库放进 WorkBuddy 的技能目录，并且**目录名必须是 `mcd-nearest-deal`**（与 `SKILL.md` 里 `name` 字段一致）： ```bash # macOS / Linux git clone https://github.com/<你的账号>/mcd-nearest-deal.git ~/.workbuddy/skills/mcd-nearest-deal # Windows (PowerShell) git clone https://github.com/<你的账号>/mcd-nearest-deal.git "$env:USERPROFILE\.workbuddy\skills\mcd-nearest-deal" ``` 若从 GitHub 下载 zip：解压得到 `mcd-nearest-deal-main/`，重命名为 `mcd-nearest-deal` 后放进 `~/.workbuddy/skills/`。目录名不一致时技能可能不被识别。 重启 WorkBuddy，在【技能】列表中应能看到「麦当劳最近在售点」。 ### 第三步：验证 在对话框里说一句： ```

部署要求

需要麦当劳中国MCP Token和一个支持Streamable HTTP的MCP客户端（推荐WorkBuddy）。

查看 README 依据

- **确认后下单**：复述门店、餐品、就餐方式、券、应付五项后，用户确认才创建订单 - **订单查询与取消**：查进度、查历史、取消未支付订单 ## 不能做什么 明确划清边界，避免预期错位： - **不代付**。订单支付链接由用户本人打开完成付款。项目不接触任何支付凭证。 - **不推荐"最省"**。只给"当前可查到的券与门店条件下"的较优解，不承诺全局最优。 - **不做营养建议**。营养数据可作为参考展示，但不构成医疗或膳食指导。 - **不缓存个人数据**。地址、手机号、券码、订单内容仅在单次任务内使用，不落盘。 - **不覆盖非点餐场景**。积分抽奖、商城兑换、活动预约虽在 MCP 能力范围内，但不是本技能主线，仅在用户明确要求时按对应工具处理。 ## 安装 ### 前置条件 1. 一个麦当劳中国 MCP Token - 访问 https://open.mcd.cn/mcp - 右上角【登录】，手机号验证 - 点【控制台】→【激活】→ 同意服务协议 - 复制生成的 Token 2. 一个支持 Streamable HTTP 的 MCP 客户端。推荐 [WorkBuddy](https://www.workbuddy.cn/)——本项目的开发与验证环境。 ### 第一步：配置麦当劳 MCP

已知限制

不代付、不推荐最省方案、不做营养建议、不缓存个人数据、不覆盖非点餐场景。

查看 README 依据

- **确认后下单**：复述门店、餐品、就餐方式、券、应付五项后，用户确认才创建订单 - **订单查询与取消**：查进度、查历史、取消未支付订单 ## 不能做什么 明确划清边界，避免预期错位： - **不代付**。订单支付链接由用户本人打开完成付款。项目不接触任何支付凭证。 - **不推荐"最省"**。只给"当前可查到的券与门店条件下"的较优解，不承诺全局最优。 - **不做营养建议**。营养数据可作为参考展示，但不构成医疗或膳食指导。 - **不缓存个人数据**。地址、手机号、券码、订单内容仅在单次任务内使用，不落盘。 - **不覆盖非点餐场景**。积分抽奖、商城兑换、活动预约虽在 MCP 能力范围内，但不是本技能主线，仅在用户明确要求时按对应工具处理。 ## 安装 ### 前置条件 1. 一个麦当劳中国 MCP Token - 访问 https://open.mcd.cn/mcp - 右上角【登录】，手机号验证 - 点【控制台】→【激活】→ 同意服务协议 - 复制生成的 Token 2. 一个支持 Streamable HTTP 的 MCP 客户端。推荐 [WorkBuddy](https://www.workbuddy.cn/)——本项目的开发与验证环境。 ### 第一步：配置麦当劳 MCP