Skip to content
Back to search

mcd-daily-saver

用麦当劳官方 MCP 每天算一次「今天怎么买最省」:首屏三张卡、一键领券、点餐链路、自家买法比价。麦当劳程序员节创意开发大赛参赛作品。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/cesare-n--mcd-daily-saver/badge.svg)](/listings/cesare-n--mcd-daily-saver)

HTML

<a href="/listings/cesare-n--mcd-daily-saver"><img src="/api/listings/cesare-n--mcd-daily-saver/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

git clone https://github.com/<你的账号>/mcd-daily-saver.git
cd mcd-daily-saver
cp .env.example .env
# 编辑 .env,把 MCD_MCP_TOKEN 换成你自己的 Token

项目零第三方运行时依赖,**不需要 `npm install`**。

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 246 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 麦麦今日省钱卡 · mcd-daily-saver
  2. <p>
  3. <a href="https://github.com/Cesare-N/mcd-daily-saver/stargazers"><img alt="Stars" src="https://img.shields.io/github/stars/Cesare-N/mcd-daily-saver?style=flat-square&color=FFC72C&labelColor=DA291C&label=Star&logo=github&logoColor=white"></a>
  4. <a href="https://github.com/M-China/mcd-developer-innovation-challenge"><img alt="M-CODE" src="https://img.shields.io/badge/%E5%8F%82%E8%B5%9B-M--CODE%20%E9%BA%A6%E5%BD%93%E5%8A%B3%E7%A8%8B%E5%BA%8F%E5%91%98%E8%8A%82%E5%88%9B%E6%84%8F%E5%BC%80%E5%8F%91%E5%A4%A7%E8%B5%9B-FFC72C?style=flat-square&labelColor=2A1A12"></a>
  5. </p>
  6. > 用麦当劳官方 MCP,每天早上 10 秒告诉你三件事:**今天有什么活动、能领什么券、这一单怎么买最省。**
  7. <p>
  8. ⭐ <strong>如果这个项目帮你省下过几块钱,欢迎点个 Star。</strong>
  9. 比赛按 Star 数排名,你的一个 Star 就是实实在在的支持 —— 点右上角的 ⭐ <code>Star</code> 就行。
  10. </p>
  11. 麦当劳程序员节创意开发大赛(M-CODE)参赛作品。
  12. 本项目**不包含任何人的 Token 或密钥**——每个人用自己的 Token 跑,数据只在自己机器上流转。
  13. ---
  14. ## 它解决什么问题
  15. 麦当劳 App 里券、活动、积分、门店规则分散在好几个页面:想知道"今天中午这顿怎么点最划算",得在券包、活动页、结算页之间来回翻。
  16. 这个工具把这件事变成**一页纸**:打开就看到结论,不用翻。
  17. **一句话**:把「今天怎么吃麦当劳最省」变成一个 10 秒能看完的页面。
  18. ---
  19. ## 展示截图
  20. | 首屏三张卡(左右滑动切换) | 比一比哪个买法最省 |
  21. |---|---|
  22. | ![首屏省钱卡](docs/screenshots/02-cards.png) | ![比价](docs/screenshots/03-compare.png) |
  23. | 你自己的 Token,自己填 | 只读版整页(可离线打开、可分享) |
  24. |---|---|
  25. | ![凭证页](docs/screenshots/01-token-gate.png) | ![只读版](docs/screenshots/04-readonly.png) |
  26. > 截图均为真实运行结果(数据来自麦当劳 MCP 实时查询)。
  27. ---
  28. ## 三种卡片,三个角度
  29. 首屏是三张可滑动的卡,不是同一件事复制三份:
  30. 1. **今天这么点最划算**(麦红)——今天可用券里券后价最低的一张,含有效期
  31. 2. **别浪费**(黄金)——今天到期的券,提醒你别作废
  32. 3. **还有**(深棕)——今天能用几张券
  33. ---
  34. ## 它真的能比价吗?——能比的与不能比的
  35. **能自动比的(麦当劳自家买法)**
  36. - **取餐方式**:堂食 / 外带 / 得来速(该门店支持哪些就比哪些)
  37. - **可用券**:查该门店当前可用券,算券后价
  38. - **门店规则**:门店级满减 / 满折
  39. **不能比的(诚实说明)**
  40. - **美团、饿了么、淘宝闪购的价格拿不到。** 麦当劳 MCP 只覆盖麦当劳自家业务,本项目**不做也不猜测**其他平台价格。
  41. - **麦乐送 / 得来速在部分门店比不了**:需要门店返回 `beCode`,拿不到时页面会明确写「该门店未返回 beCode,无法计算」,**不会用假数字凑**。
  42. 宁可少显示,不给你错数字。
  43. ---
  44. ## 目标用户
  45. - **每天吃麦当劳、想少花几块的上班族**:早上看一眼今天哪张券最值。
  46. - **手里券多但记不住有效期的人**:到期提醒 + 一键领取。
  47. - **想了解麦当劳 MCP 能做什么的开发者**:一份完整、可跑通、不吹牛的示例工程。
  48. ---
  49. ## 你需要准备什么
  50. | 需要 | 说明 |
  51. |---|---|
  52. | **Node.js ≥ 18** | 项目零运行时依赖,只用 Node 内置能力 |
  53. | **你自己的麦当劳 MCP Token** | 免费申请,见下方 |
  54. **申请 Token 的步骤**
  55. 1. 打开 <https://open.mcd.cn/mcp>
  56. 2. 右上角「登录」,用手机号验证
  57. 3. 登录后点右上角「控制台」→ 点「激活」→ 同意服务协议
  58. 4. 复制得到的 Token(形如 `xxxxxxxxxxxxxxxxxxxxxxxx`)
  59. > ⚠️ Token 等于你的账号访问凭证,**不要提交到任何仓库、不要发给别人**。
  60. ---
  61. ## 安装
  62. ```bash
  63. git clone https://github.com/<你的账号>/mcd-daily-saver.git
  64. cd mcd-daily-saver
  65. cp .env.example .env
  66. # 编辑 .env,把 MCD_MCP_TOKEN 换成你自己的 Token
  67. ```
  68. 项目零第三方运行时依赖,**不需要 `npm install`**。
  69. ---
  70. ## 使用示例
  71. ### 方式一:生成的只读页(可离线打开、可分享)
  72. ```bash
  73. export MCD_MCP_TOKEN=你的Token # 或写进 .env
  74. npm run build # 生成 dist/index.html
  75. ```
  76. 打开 `dist/index.html`,数据已内联,**可离线查看、可直接发给朋友**。
  77. 命令行会同时打印一份摘要:
  78. ```text
  79. 服务器时间 2026-10-10 09:12:03 周六
  80. 今日结论 9.9元中杯冰美式 券后 ¥9.9
  81. 可用券 3 张(其中 2 张此刻可用)
  82. 今天到期 1 张
  83. 活动条数 30 条
  84. 积分 217.8 可用 / 1233.8 累计
  85. ```
  86. ### 方式二:本地交互版(能真领券、能算价、能下单)
  87. ```bash
  88. npm run app # 生成交互版页面
  89. npm run serve # 启动本地服务 → http://127.0.0.1:8787
  90. ```
  91. 打开页面后:
  92. 1. **在页面里填你自己的 Token**(不进命令行、不进文件、不进日志)
  93. 2. 点「连接」→ 看到今日省钱卡
  94. 3. 点「一键领取今天的券」→ 真实领取到你的麦当劳账户
  95. 4. 「点餐」区按 5 步走:**门店 → 菜单 → 套餐内容/可换项 → 算价 → 下单**
  96. 5. 「④b 比一比哪个买法最省」→ 看各买法到手价
  97. > **下单会产生真实扣款。** 提交前页面会弹二次确认,确认后才发起。
  98. ### 方式三:只验连通性
  99. ```bash
  100. npm run probe
  101. # ✅ MCP 连通,可用工具 35 个:list-nutrition-foods, create-order, ...
  102. ```
  103. ---
  104. ## 用到了哪些麦当劳 MCP 工具
  105. | 工具 | 用途 |
  106. |---|---|
  107. | `now-time-info` | 服务器时间(一律以官方时间为准,不用本机时间) |
  108. | `campaign-calendar` | 活动日历:进行中 / 往期 / 未来 |
  109. | `query-my-coupons` | 我的券包(含券后价、有效期、标签) |
  110. | `available-coupons` | 麦麦省可领券列表 |
  111. | `auto-bind-coupons` | **一键领取**当前可领的券 |
  112. | `query-my-account` | 积分账户 |
  113. | `query-nearby-stores` | 搜索附近 / 收藏门店 |
  114. | `query-meals` | 门店菜单 |
  115. | `query-meal-detail` | 套餐组成与**可替换项** |
  116. | `calculate-price` | 算价(含优惠、取餐方式) |
  117. | `query-store-coupons` | 该门店可用券 |
  118. | `query-promotions` | 门店满减 / 满折规则 |
  119. | `create-order` | 创建订单(返回支付链接) |
  120. 完整的调用流程、时序与业务价值见 **[MCP_INTEGRATION.md](MCP_INTEGRATION.md)**。
  121. ---
  122. ## 隐私与安全
  123. 这个项目在凭证处理上做了三件事,你可以自己验证:
  124. 1. **代码里没有任何 Token。** 全仓库不含账号、密钥、密码;`.env` 与 `dist/` 都在 `.gitignore` 里。
  125. 2. **本地服务只监听 `127.0.0.1`。** 同一局域网的其他设备也访问不到;Token 只从请求头读取,**不写日志、不落盘**。
  126. 3. **Token 只存在内存里。** 页面刷新即失效,另有一键「断开并清除 Token」。
  127. 配套措施:接口只放行**工具白名单**、请求体限 512KB、路径防目录穿越、错误信息自动遮蔽疑似凭证。
  128. ---
  129. ## 常见问题
  130. **Q:会用到我的账号花钱吗?**
  131. 只有你点「生成订单」并确认后才会创建订单,而且**付款要在麦当劳官方渠道完成**。其余操作(查数据、领免费券)不产生费用。
  132. **Q:为什么领券按钮点了显示"今天已经领取过了"?**
  133. 麦当劳麦麦省每天限领一次,属正常限制,不是报错。
  134. **Q:为什么麦乐送比不了价?**
  135. 部分门店不返回 `beCode`,麦当劳接口在 `beType=2/5` 时强制要求它。拿不到就如实标注,不用假数据填。
  136. **Q:数据是实时的吗?**
  137. 是。每次运行都现场调 MCP,页面底部会显示查询时刻。项目**不内置任何离线或模拟数据**;没有 Token 时会明确报错退出,不会拿本地数据冒充结果。
  138. ---
  139. ## 开发
  140. ```bash
  141. npm test # 单元测试(解析器 / 推荐引擎 / 比价)
  142. npm run build # 生成只读版
  143. npm run app # 生成交互版
  144. npm run serve # 本地服务
  145. ```
  146. 目录结构:
  147. ```
  148. src/
  149. mcp.mjs MCP 客户端(Token 逐次传入,不读全局默认值)
  150. parse.mjs 把 MCP 的 Markdown 返回解析成结构化数据
  151. plan.mjs 推荐引擎:今天这么点最划算 + 三张卡
  152. compare.mjs 比价引擎:自家买法对比
  153. render.mjs 只读版页面生成
  154. render-app.mjs 交互版页面生成
  155. index.mjs CLI 入口
  156. server.mjs 本地服务(仅 127.0.0.1)
  157. test/ 单元测试(用实测真实返回做 fixture)
  158. docs/plans/ 设计稿
  159. mcp-config.example.json 脱敏 MCP 配置示例(仅环境变量占位符)
  160. scripts/ 参赛规则自检脚本
  161. ```
  162. ---
  163. ## 免责声明
  164. 本项目为**麦当劳程序员节创意开发大赛参赛作品**,由参赛者独立开发,**非麦当劳官方产品**。
  165. 项目输出仅供参考,不构成医疗、营养或其他专业建议;餐品信息、价格及供应状态以麦当劳官方渠道的实时结果为准。
  166. 参赛声明见 [CONTEST_DECLARATION.md](CONTEST_DECLARATION.md)。
  167. ## 许可证
  168. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.