zengshuangzi/mcd-money-saver

它是什么

麦麦省钱助手 (McD Money Saver) 是一个智能助手，帮助您在麦当劳花费更少。它连接到麦当劳官方MCP服务（一种让应用与麦当劳系统通信的方式），自动收集您的优惠券、检查积分、比较价格，并告诉您最便宜的订购方式——全部集中在一个地方。

它是为麦当劳程序员日创意开发竞赛而构建的，并借助了腾讯的WorkBuddy工具。

它解决的问题

README列出了它解决的四个常见痛点：

• 您有几张优惠券，但不知道哪张最好或是否可以组合使用。
• 您不确定是否已领取所有可用的“麦麦省”优惠券。
• 您的预算紧张（例如30元），需要一顿能吃饱且不超支的餐。
• 您想控制卡路里，但仍想抓住最佳优惠。

核心功能

功能	作用
智能领券	一键领取所有可用的麦麦省优惠券（通过名为auto-bind-coupons的工具）。
最佳套餐查找器	使用您的优惠券计算哪种餐食/食物组合最省钱。
预算点餐	在固定预算内找到最便宜的订购方式。
卡路里感知优惠	在保持卡路里低于目标的同时找到最佳价格。
积分查询	检查您的积分余额，并考虑积分兑换以节省更多。

工作原理

助手按顺序串联多个麦当劳MCP工具：

1. 查找附近的麦当劳门店
2. 检查您的优惠券以及哪些可领取
3. 领取可用优惠券
4. 查看菜单
5. 使用calculates-price工具比较价格
6. 输出最佳方案

所以它本质上是一个多步骤管道：定位 → 检查 → 领取 → 比较 → 推荐。

如何安装和使用

前提条件：

• 麦当劳MCP令牌（在open.mcd.cn/mcp登录并激活即可免费获得）。
• 支持Streamable HTTP的MCP客户端（README推荐腾讯WorkBuddy）。

设置：

• 将麦当劳MCP服务器配置（URL https://mcp.mcd.cn，使用您的令牌作为Bearer头）添加到您的客户端。
• 将本仓库中的SKILL.md文件加载到您的客户端——在WorkBuddy中，将其放入技能目录；在其他客户端中，将其作为代理提示加载。

README中的示例交互：

• “我只有30元，想吃麦当劳。” → 助手找到附近有“满30减5”优惠券的门店，推荐折扣后正好30元的餐，并告诉您节省了多少。
• “我可以领取哪些优惠券？” → 它为您领取3张优惠券，并告诉您哪张最划算。
• “控制在500卡路里以内，能省则省。” → 它建议一个480卡路里且有折扣的套餐，为您节省6元。

适用人群

• 预算有限的学生和上班族，希望吃得好而不超支。
• 总是下单前检查优惠券的优惠猎人。
• 关注卡路里但仍想享受折扣的人。

重要注意事项

• 这是一个竞赛作品，不是麦当劳的官方产品。
• 所有价格、优惠券和可用性均来自麦当劳官方渠道的实时数据——助手不会虚构。
• 营养信息仅供参考，不构成医疗或饮食建议。
• 使用仅限于竞赛和学习目的，必须遵守麦当劳的使用条款和MCP服务规则。

项目内容

• SKILL.md — 核心技能定义（省钱逻辑作为提示）
• README.md — 本介绍
• CONTEST_DECLARATION.md — 官方竞赛声明（不可修改）
• MCP_INTEGRATION.md — MCP设置和工具调用的详细信息
• mcp-config.example.json — 示例（脱敏）配置
• workbuddy.md — WorkBuddy会话的开发上下文

---

注意：README为中文；本说明是其内容的忠实翻译，未添加任何功能或声明。