Sam-Hui-dot/mcd-budget-meal

Public

麦麦预算餐:基于麦当劳 MCP 的真实核价、预算比较与餐品替换 Skill

  • Stars1.6k+716 tuần này
  • Forks44
  • Watchers14
  • Issues1
  • Ngày tạo11/10/2026
  • Cập nhật gần nhất24/10/2026
  • Ngôn ngữHTML
  • Giấy phép—
README.md19.3 KBRaw

麦麦预算餐:先核价,再选餐

Python 3.10+ 零第三方依赖 离线预览免Token MCP官方核价 MIT许可

预算你来定,餐单摆出来,多花的钱看明白。

一句话说需求 → 官方核价 → 三份餐单对比。看整单价格,也看差价换来了什么。

先看效果 · 真实案例 · 安装使用 · 如何工作 · 欢迎与支持

欢迎路过,也欢迎常来。愿你今天吃得开心,手头的事情也顺顺利利。
🍔 先体验一下 · 💬 留个建议 · ⭐ 喜欢的话,点颗 Star

先看效果

打开在线体验 → 免安装、免Token,调整预算、查看差价和已核价的饮料版本。页面使用历史核价记录,不实时查价或下单。

打开批量核价报告示例 · 报告使用说明

30元预算的三份历史餐单

这是一次真实核价的脱敏案例,当次没有可用券。门店与核价时段不公开;价格为历史快照,当前购买需要重新查询与核价。

想自己调预算? 下载后双击 脱敏交互报告,可以调整预算、比较组成与差价、复制结果。也保留了 饮料切换预览,可切换当次已核价的饮料版本。两者均免Token、可单文件打开;GitHub文件链接显示源码,需下载后打开。

每次真实核价指定 --records-dir 后,也会自动生成属于你本轮结果的 meal-report.html,不再只依赖固定的示例页面。新一轮真实运行记录

真实案例

一个人,现在到店取餐,预算30元,想吃一个汉堡和一杯饮料,先让我选门店。

麦麦预算餐会查询所选门店的菜单、可用券和套餐详情,对最多三份候选逐一核价,展示整单应付、实际餐品与份数、剩余预算和优惠条件。

那次三份餐单的官方核价分别为 ¥14.90、¥22.90、¥26.90。随后把大堡口福三件套的可乐换成无糖可口可乐,重新核价整个餐单,得到 ¥22.90。查看完整运行记录

还可以这样问 它会处理什么
“不要可乐,汉堡保留” 检查排除项,替换后对完整餐单重新核价
“25元,至少两个汉堡” 检查实际份数;没有预算内方案时明确显示超额
“有券就比较,没有券也行” 核实当前门店可用券;没有券时比较不带券方案

安装使用

需要支持远程MCP的AI客户端,例如WorkBuddy、Cherry Studio或Cursor,以及你自己的麦当劳MCP Token。配套脚本需要Python 3.10及以上,使用标准库,无第三方依赖。

  1. 到麦当劳MCP平台登录、激活Token,按官方指南连接 https://mcp.mcd.cn,协议为Streamable HTTP。Token只填在客户端私有配置中。
  2. 下载并解压仓库。WorkBuddy可在仓库目录运行 ./install.ps1,或让客户端把完整的 skills/mcd-budget-meal 文件夹导入技能目录。已有技能会先备份;安装脚本不读取Token、不修改连接器。
  3. 新开客户端会话,发送:
使用麦麦预算餐技能。一个人,现在到店取餐,预算30元,想吃一个汉堡和一杯饮料。
先让我选门店,再比较最多三份真实核价的餐单。不下单。

客户端没有Skill导入入口时,打开仓库目录,让AI读取 skills/mcd-budget-meal/SKILL.md。只使用原生MCP工具时,脚本可选;WorkBuddy核价若遇到数组校验问题,需要本机Python使用项目直连路径。

详细点击步骤与常见问题 · WorkBuddy兼容说明

如何工作

从需求到餐单建议的流程

AI负责理解需求、查询真实菜单和准备候选;官方 calculate-price 返回整单应付金额;本地脚本按整数分检查预算、份数、排除项、核价时间与重复餐单。

  • 预算以你的输入为准:没有预算内方案时,列出最接近的有效餐单与超出金额。
  • 更换餐品后重新核价:不拿旧报价加减菜单展示价。
  • 接口失败就停止本轮后续调用:保留此前的有效结果,不自动重试。
  • 差价说清楚:分别列出增加、减少与保持不变的餐品和份数;整单差价不当作新增餐品的单独售价。
  • 报告随本轮核价生成:预算筛选、差价和复制使用本轮实际成功报价;失败候选不生成猜测价格。

仅支持同一门店、单人、现在到店取餐,停在餐单建议阶段。比较只覆盖本轮候选,不保证全菜单最低价。营养、配料与过敏原未纳入推荐规则;价格、可售状态和券适用性以官方当前结果为准。

实际工具、参数和业务价值 · 批量餐单计划 · 本地报价格式

验证记录

范围 已记录的验证
真实MCP运行 批量入口完成三份核价、自动生成报告;另行换饮料核价成功。公开摘要已脱敏
Python逻辑 51项纯离线回归,含导出失败保留有效报价、旧比较JSON恢复及原有预算检查
页面逻辑 14组模拟DOM场景通过,含复制回退、旧结果清理、报价过期与历史恢复标注
安装升级 临时配置目录14项检查通过,含去除旧文件、保留私人记录与替换失败恢复旧版

带券分支尚无真实账户案例。安装验收使用隔离的临时配置目录,未安装到用户真实WorkBuddy目录、未验证WorkBuddy自动发现技能。默认15分钟的报价新鲜度是项目自己的展示策略。

Nội dung README thuộc về Sam-Hui-dot và cộng đồng đóng góp, giấy phép Không có giấy phép. Nguồn: github.com/Sam-Hui-dot/mcd-budget-meal