Repolode
Ayzzz123

Ayzzz123/mcd-coupon-strategist

基于麦当劳中国 MCP 的点餐助手,算出当前门店最省钱的点法,并提示即将过期的券。

Star
576
Fork
20
未关闭 Issue
0
最近提交
6天前

这是什么?

mcd-coupon-strategist 是一个基于麦当劳中国 MCP 服务的 Python 点餐成本助手。单次点餐时,它会拉取当前门店的菜单和可用优惠券,枚举单品、套餐、券组合和凑单等候选方案,并通过 MCP 的 calculate-price 工具逐一计价,推荐最省钱的组合。如果为了达到满减门槛而加购商品反而更贵,它会主动提醒。

在长期层面,它会读取历史订单和账户券列表,统计即将过期的券面值、客单价以及不同时段的消费结构,同时检查积分余额与有效期,并把活动日期与券的有效期放在一起比对。券的面值在能拿到券码时由 calculate-price 实测,否则从菜单反查原价估算;无法确定的会标注为价值未知,不做猜测。

项目自带的 demo 基于 fixtures 目录中录制的 MCP 响应离线运行,只依赖 Python 标准库,无需 Token 即可体验。若要连接真实服务,则需要申请麦当劳 MCP Token。

核心功能

  • 01对比当前门店的单品、套餐和券组合方案。
  • 02通过 MCP calculate-price 实际计价,而不是估算金额。
  • 03识别凑单后反而更贵的情况并给出提醒。
  • 04统计即将过期券的面值,并区分可用券与持有券。
  • 05按时段和客单价汇总历史订单消费。
  • 06提供离线 demo,使用录制的响应即可运行。

适用场景

  • 在固定预算内,为麦当劳门店选出最省钱的套餐组合。
  • 判断某张满减券是否值得为了凑单而加购商品。
  • 追踪麦当劳账户中即将过期的券和积分。
  • 参考分层适配器设计,学习如何基于 MCP 构建点餐工作流。

快速上手

  1. 1

    克隆仓库

    git clone https://github.com/Ayzzz123/mcd-coupon-strategist.git
  2. 2

    进入项目目录

    cd mcd-coupon-strategist
  3. 3

    运行零配置演示(无需 MCP Token)

    python demo.py

使用前须知

  • 实际使用需要从 open.mcd.cn 申请麦当劳中国 MCP Token。
  • 无法从菜单反查原价的券会被标注为“价值未知”,无法计算其金额。

标签

常见问题

mcd-coupon-strategist 是什么?
基于麦当劳中国 MCP 的点餐助手,算出当前门店最省钱的点法,并提示即将过期的券。 mcd-coupon-strategist 是一个基于麦当劳中国 MCP 服务的 Python 点餐成本助手。单次点餐时,它会拉取当前门店的菜单和可用优惠券,枚举单品、套餐、券组合和凑单等候选方案,并通过 MCP 的 calculate-price 工具逐一计价,推荐最省钱的组合。如果为了达到满减门槛而加购商品反而更贵,它会主动提醒。
mcd-coupon-strategist 可以免费使用吗?用的什么许可证?
mcd-coupon-strategist 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
mcd-coupon-strategist 还在维护吗?
活跃维护中。mcd-coupon-strategist 最近一次提交是在 2026年10月14日。
mcd-coupon-strategist 适合用来做什么?
在固定预算内,为麦当劳门店选出最省钱的套餐组合。 判断某张满减券是否值得为了凑单而加购商品。 追踪麦当劳账户中即将过期的券和积分。 参考分层适配器设计,学习如何基于 MCP 构建点餐工作流。
mcd-coupon-strategist 怎么安装和运行?
克隆仓库: git clone https://github.com/Ayzzz123/mcd-coupon-strategist.git 进入项目目录: cd mcd-coupon-strategist 运行零配置演示(无需 MCP Token): python demo.py
在哪里获取 mcd-coupon-strategist?
源代码和安装说明在 GitHub 上:https://github.com/Ayzzz123/mcd-coupon-strategist

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目