Skip to content

About

基于麦当劳MCP的智能省钱助手

Resources

Stars

349 stars

Watchers

0 watching

Forks

Repository files navigation

麦麦省钱助手(McD Money Saver)

花最少的钱,吃得麦满意。🍔

「麦麦省钱助手」是一个基于麦当劳 MCP 能力构建的智能省钱 Skill,帮助你把散落在各处的优惠券、麦麦省券、积分和套餐组合自动盘清楚,算出每一单最省钱的点法。

本作品为 麦当劳程序员节创意开发大赛 参赛项目,使用腾讯 WorkBuddy 辅助开发。


💡 它解决什么问题

每次点麦当劳,你是不是也纠结过这些问题?

  • 手里攥着好几张券,哪张最划算?能不能叠加?
  • 麦麦省又有新券可以领了,我领没领?
  • 预算只有 30 块,该怎么点才能吃饱又不超支?
  • 想控制热量,又不想错过优惠。

麦麦省钱助手把这些事全包了:先摸清你的券 → 帮你领 → 比价 → 算最优组合 → 给你一个明确的"省了多少钱"的答案。

✨ 核心功能

功能 说明
🎫 智能领券 一键领取麦麦省所有可领优惠券(auto-bind-coupons)
🧾 最优组合 结合优惠券,算出"省钱最多"的套餐/餐品组合
💰 预算点餐 固定预算内,找最省钱又不超支的点法
🔥 热量搭配 控制热量的同时,仍帮你找最优价格
📊 积分查询 查积分余额,结合积分兑换省钱

🧠 工作原理

基于麦当劳 MCP 的多工具编排,流程如下:

查附近门店 → 查我的券/可领券 → 领券 → 查菜单 → calculates-price 比价 → 输出最优方案

详细工具调用说明见 MCP_INTEGRATION.md。

📦 安装方法

前置条件

  1. 申请麦当劳 MCP Token:前往 open.mcd.cn/mcp,手机号登录 → 控制台 → 激活,一键复制 Token。
  2. 一个支持 Streamable HTTP 的 MCP Client(推荐 WorkBuddy)。

接入麦当劳 MCP

在 MCP Client 中添加如下配置(把 YOUR_MCP_TOKEN 换成你的真实 Token):

{
  "mcpServers": {
    "mcd-mcp": {
      "type": "streamablehttp",
      "url": "https://mcp.mcd.cn",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

脱敏示例见 mcp-config.example.json。

安装本 Skill

  • WorkBuddy:将本仓库中的 SKILL.md 放入你的技能目录,或在对话中直接导入。
  • 其他 Client:参考其 MCP Skill 导入方式,将 SKILL.md 作为 Agent 提示词加载。

🚀 使用示例

示例 1:预算内最省钱

用户:我只有 30 块,想吃顿麦当劳。

麦麦省钱助手:附近 3 家门店中,XX 店可用「满 30 减 5」券。推荐「麦辣鸡腿堡套餐」原价 ¥35 → 用券后 ¥30,帮您省了 ¥5,还送一杯可乐。要下单吗?

示例 2:薅羊毛

用户:看看我能领什么券。

麦麦省钱助手:已为您一键领取 3 张麦麦省券:「大薯条买一送一」「早餐卡 5 折」「麦辣鸡翅 8 折」。其中「早餐卡 5 折」用在早餐套餐上最划算。

示例 3:热量可控

用户:控制在 500 大卡以内,能省就省。

麦麦省钱助手:为您搭配「双层吉士汉堡 + 零度可乐」共 480 大卡,叠加「满 20 减 3」券后 ¥19,比单点省了 ¥6。

🎯 目标用户

  • 学生党、打工人:预算有限,想吃饱又别超支
  • 薅羊毛达人:下单前必看有没有券
  • 健身减脂人群:控热量 + 要优惠

📁 项目结构

mcd-money-saver/
├── SKILL.md                  # Skill 定义(核心,省钱逻辑提示词)
├── README.md                 # 项目介绍(本文件)
├── CONTEST_DECLARATION.md    # 参赛声明(官方模板,不可修改)
├── MCP_INTEGRATION.md        # MCP 接入与工具调用说明
├── mcp-config.example.json   # 脱敏配置示例
└── workbuddy.md              # WorkBuddy 开发对话上下文

⚠️ 免责声明

本作品为参赛作品,由参赛者独立开发,非麦当劳官方产品。餐品信息、价格、优惠券及供应状态以麦当劳官方渠道实时结果为准;涉及热量等营养信息仅供参考,不构成医疗或营养建议。

📄 License

仅用于参赛与学习交流,请遵守麦当劳《使用条款》及《MCP 服务规则》。详见 CONTEST_DECLARATION.md。

About

基于麦当劳MCP的智能省钱助手

Resources

Stars

349 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages