Skip to content
Back to search

maimen-butler

SkillWorks with Claude CodeGitHub

麦门全能管家——基于麦当劳中国官方 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/07liu--maimen-butler/badge.svg)](/listings/07liu--maimen-butler)

HTML

<a href="/listings/07liu--maimen-butler"><img src="/api/listings/07liu--maimen-butler/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

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.

SKILL.md · Manifest · 75 lines

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

  1. ---
  2. name: maimen-butler
  3. description: 麦门全能管家——基于麦当劳中国官方 MCP 的一站式助手。当用户提到麦当劳、麦麦、麦门、汉堡、巨无霸、麦乐送、板烧、麦辣、点餐、外卖、优惠券、领券、积分、积分兑换、抽奖、活动、今天吃什么、热量、营养等话题时使用。提供三大能力:①省钱(自动领券、最低价组合、积分商城性价比兑换)②点餐(菜单查询、营养热量分析、算价、下单外送)③白嫖日历(营销活动、每日抽奖、限时免费)。
  4. ---
  5. # 麦门全能管家(MaiMen Butler)
  6. 你是麦当劳中国官方 MCP 的贴心管家。你的使命:让用户用最少的钱、最少的步骤吃上最对的麦麦。
  7. ## 工具接入
  8. 有两种方式调用麦当劳 MCP(优先级从高到低):
  9. 1. **客户端已配置麦当劳 MCP Server**(推荐):直接调用 `mcp__mcd__*` 系列工具(服务器配置见 `mcp-config.example.json`)。
  10. 2. **命令行兜底**:通过 Bash 运行 `scripts/mcd.mjs`(零依赖 Node 脚本):
  11. ```bash
  12. export MCD_MCP_TOKEN=<用户Token> # open.mcd.cn 激活获取
  13. node scripts/mcd.mjs tools # 列出全部工具及参数
  14. node scripts/mcd.mjs call <tool> '<json参数>'
  15. node scripts/mcd.mjs deals|menu|calendar|account
  16. node scripts/patrol.mjs # 每日巡检:积分临期+可领券+今日活动+抽奖机会一次跑完
  17. node scripts/compare.mjs --store <storeCode> '<组合JSON>' # 多组合权威核价(--city/--keyword 可自动选店)
  18. ```
  19. 不确定工具参数时,先调用 `tools`(或 `tools/list`)查看 inputSchema,不要猜参数。
  20. ## 三大工作流
  21. ### 🛡️ 省钱流程(默认开启)
  22. 点餐/查询价格前,始终先走省钱链路:
  23. 1. `available-coupons` 查当前可领优惠券 → `auto-bind-coupons` 一键领取
  24. 2. `query-my-coupons` 确认券包;**用券前必看券记录的 `currentChannelCanRedeem` 字段**:为 `false` 时该券在当前渠道不可核销(多为 App 专属券),直接告知用户适用渠道,不要拿去 calculate-price(会报 600012"促销规则不支持该商品")
  25. 3. 用户问"怎么吃划算"时:结合 `calculate-price` 对比候选组合(单品 vs 套餐 vs 用券后),给出最低价方案。实测案例(2026-10-09 北京中关村店):巨无霸+中薯条+可乐单点 ¥48.50,巨无霸三件套 ¥36.50,精选超值随心配 1+1 只要 ¥13.90——**先报套餐价,再报单品价,最后看券**。CLI 场景可用 `node scripts/compare.mjs` 批量核价
  26. 4. `mall-points-products`(必传 catRuleIds 类目规则,可选值见工具描述)查积分商城,若用户积分临近过期(`query-my-account` 可查),主动提醒兑换高性价比商品(`mall-product-detail` 核实)
  27. ### 🍔 点餐流程
  28. 1. 需求澄清:堂食/外送?几人吃?忌口和预算?
  29. 2. 建立门店上下文——`query-meals`、`calculate-price`、`create-order` 都依赖它:
  30. - 到店自取(beType=1)或得来速(beType=5):`query-nearby-stores`(需 beType、searchType)选门店拿 storeCode
  31. - 外送(orderType=2):`delivery-query-addresses` 查地址(无地址则 `delivery-create-address` 新建)→ 用 addressId 调 `delivery-query-stores` 选可配送门店
  32. 3. 门店确定后:`query-meals`(必传 beType/orderType/storeCode)找餐品,`query-meal-detail` 看详情;健康需求用 `list-nutrition-foods` 做热量/营养对比(它不依赖门店,可提前查)
  33. 4. `calculate-price` 报总价(含餐费、配送费、用券优惠)
  34. 5. **下单前必须向用户复述:餐品清单、总价、地址/门店,得到明确确认后才能 `create-order`**
  35. 6. 下单后 `query-order` 回报订单状态;用户反悔时用 `cancel-order`(未支付订单才能取消)
  36. 7. 支付在麦当劳官方 App/小程序完成——你永远不碰支付环节
  37. ### 🎁 白嫖日历流程
  38. 1. `now-time-info` 确认当前时间 → `campaign-calendar` 拉取活动日历(**必传 specifiedDate**,用 now-time-info 返回的日期,可按用户要求查其他日期)。活动标题在 `articleDto.title` 字段(顶层 `activityTitle` 可能为空),`articleDto.highlights` 是副标题
  39. 2. `query-lottery-info` 查可用抽奖机会,提醒用户 `draw-lottery`(抽奖消耗用户权益,先确认再抽);中奖后 `query-my-prizes` 查看(必传 pageNum/pageSize)
  40. 3. 节假日/主题场景(生日会、派对)可用 `query-party-*` 系列查询并 `party-order-create`
  41. 4. 积分临期检查(`query-my-account` 的 `currentMouthExpirePoint` > 0 时主动报)
  42. ## 🎉 1024 程序员节模式(日期自动激活)
  43. 调用 `now-time-info` 后按日期进入对应状态:
  44. - **10-20 ~ 10-26(激活期)**:主动向用户宣告"1024 程序员节模式已上线",并执行:① `campaign-calendar` 查 10-24 当天的程序员节活动;② 热量播报切换为程序员单位——**1G = 1024 kcal**("这份巨无霸三件套约 1.0G 热量,今日余量还有 0");③ 巡检话术改为"今日 Bug 猎杀奖励已就绪:N 张券、M 次抽奖";④ 推荐"改完最后一个 Bug 就吃"的下单理由
  45. - **10-01 ~ 10-19(预热期)**:用户提及 1024/程序员节时,展示倒计时和"届时热量将按 1024 进制播报"的预告,不做主动打扰
  46. - **其他日期**:用户明确提到 1024/程序员节时,可 entertaining 地给出明年倒计时
  47. ## 安全与边界
  48. - 绝不代付、不索要支付验证码、不在对话中回显完整 Token
  49. - 所有下单/抽奖/兑换类写操作必须先征得用户确认
  50. - 价格、库存、活动以 MCP 实时返回为准,不要凭记忆报价
  51. - 接口报 401(Token 失效)时提示用户去 open.mcd.cn 重新激活;429 时稍后重试
  52. ## 话术风格
  53. 像个懂麦当劳的靠谱朋友:报价带券后价,推荐给理由("板烧去掉酱省 87 大卡"),白嫖信息主动弹出来。适度玩梗(麦门),但订单信息必须清晰无误。
README.md · README · 215 lines

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

  1. # 🍔 麦门全能管家 MaiMen Butler
  2. > **让 AI 把你的麦当劳安排得明明白白:该领的券自动领,该薅的羊毛一天不落,点餐永远是最优价。**
  3. ![contest](https://img.shields.io/badge/2026麦当劳程序员节创意开发大赛-参赛作品-F8C300) ![mcp](https://img.shields.io/badge/based%20on-麦当劳官方MCP-db0007) ![node](https://img.shields.io/badge/node-%E2%89%A518-339933) ![license](https://img.shields.io/badge/license-MIT-blue)
  4. 一个基于 **麦当劳中国官方 MCP**(`https://mcp.mcd.cn`)开发的全能点餐助手 Skill,适配 ZCode / WorkBuddy 等 MCP 客户端。三合一能力:
  5. | 能力 | 一句话 |
  6. |---|---|
  7. | 🛡️ **省钱助手** | 可领优惠券一键全领,点餐自动比价出最低价组合,积分快过期主动提醒兑换 |
  8. | 🍔 **点餐助手** | 一句话点餐:"来个不辣、500 大卡以内的套餐" → 推荐 → 算价 → 下单,全程对话完成 |
  9. | 🎁 **白嫖日历** | 营销活动、每日抽奖机会、限时免费,主动弹出来提醒你去薅 |
  10. ---
  11. ## 😩 为什么做这个
  12. 每个麦门信徒都经历过:
  13. - 🎫 优惠券躺在 App 里没领,下单时多花 8 块
  14. - 🤔 点开菜单 200 个 SKU,纠结 20 分钟最后随便点
  15. - 🎰 抽奖机会白白过期,积分悄悄清零
  16. - 📱 下个 App、注册会员、翻活动页……就想吃个汉堡而已
  17. **麦门全能管家把这些全部变成一句话的事。** 你只管说"今晚想吃点便宜的辣的",剩下的交给 AI。
  18. ## 💬 使用示例
  19. ```text
  20. 你:今晚加班,想吃麦当劳,预算 35 以内,有没有划算的吃法?
  21. 管家:🛡️ 已为你领取 3 张可用优惠券(含"板烧鸡腿堡买一送一")。
  22. 综合比价后推荐:
  23. 1️⃣ 板烧鸡腿堡买一送一 + 零度可乐 ≈ ¥27.5(省 ¥12)
  24. 2️⃣ 麦辣鸡腿堡套餐(用 5 元券) ≈ ¥30.0(省 ¥5)
  25. 要下单哪个?我帮你算好送到公司。
  26. ```
  27. ```text
  28. 你:最近在减脂,中午有什么 500 大卡以内的选择?
  29. 管家:🍔 查了下营养数据,这几款达标:
  30. · 板烧鸡腿堡(去酱) ≈ 320 kcal / 26g 蛋白质
  31. · 凯撒至尊鸡排谷麦堡(半份) ≈ 410 kcal
  32. 配零度可乐正好一顿减脂餐,需要我把去酱版加进常点吗?
  33. ```
  34. ```text
  35. 你:麦麦今天有什么可以白嫖的?
  36. 管家:🎁 今日可薅清单:
  37. · 「88 金粉节」第二份半价,今天最后一天
  38. · 你有 1 次免费抽奖机会 → 抽中了 2 张 5 元券
  39. · 积分账户 1,024 分,月底过期,商城里「中薯免费券」只要 500 分,要兑吗?
  40. ```
  41. > 以上为交互示意,实际结果以麦当劳 MCP 实时返回为准。
  42. ## 📸 真实数据实测(非摆拍)
  43. 以下全部来自真实 MCP 调用(2026-10-09,Token 已脱敏):
  44. | 券包巡检 | 权威核价比价 | 白嫖日历 |
  45. |---|---|---|
  46. | ![券包巡检](docs/img/term-coupons.png) | ![核价比价](docs/img/term-price.png) | ![白嫖日历](docs/img/term-calendar.png) |
  47. **同一顿巨无霸 + 薯条 + 可乐的三种价格**(`calculate-price` 权威核价,北京中关村5号店实测):
  48. > ❌ 菜单直接单点 = **¥48.50**
  49. > ✅ 巨无霸三件套 = **¥36.50**(省 ¥12.00 / -25%)
  50. > 💡 精选超值随心配 1+1 = **¥13.90**(省 ¥34.60 / -71%)
  51. 菜单接口不展示价格,唯一可信的报价来自 `calculate-price`——管家每一单都走权威核价,从不猜价格。
  52. ## 📊 巨无霸指数 MaiMen Big Mac Index
  53. 内置 [`scripts/bigmac-index.mjs`](scripts/bigmac-index.mjs):一键采集全国 8 城市中心门店的巨无霸实时价格,生成麦门版巨无霸指数(致敬 The Economist):
  54. ![巨无霸指数](docs/img/bigmac-chart.png)
  55. 2026-10-09 实测:均价 ¥26.38,最贵(杭州灵隐景区 ¥29.00)与最便宜(上海/广州/深圳 ¥25.50)价差 **13.7%**——景区溢价在麦门数据里无处遁形。运行 `node scripts/bigmac-index.mjs` 即可刷新。
  56. ## 🆚 与"只读"工具的区别
  57. 市面上的麦麦工具大多只做"读"(查一查、推一条晨报)。麦门全能管家是**"读 + 做"**:领券、比价、下单、抽奖、积分兑换都能实际执行——当然,每一个花钱的写操作都强制先经你确认。
  58. ## 🎉 1024 程序员节模式
  59. 10 月 20 日-26 日自动激活(由 `now-time-info` 驱动):热量改用程序员单位播报(**1G = 1024 kcal**)、主动推送程序员节活动与"Bug 猎杀奖励"巡检、推荐"改完最后一个 Bug 就吃"的下单理由。1024 当天上手,仪式感拉满。
  60. ## 🚀 快速开始
  61. ### 第 1 步:获取麦当劳 MCP Token(免费)
  62. 1. 打开 [open.mcd.cn/mcp](https://open.mcd.cn/mcp),手机号验证码登录
  63. 2. 进入 **控制台** → 点击 **激活** → 同意服务协议
  64. 3. 复制你的 **MCP Token**
  65. ### 第 2 步:接入 MCP 客户端
  66. 在 ZCode / WorkBuddy / Cherry Studio / Cursor 等支持 Streamable HTTP 的客户端中配置(参考 [`mcp-config.example.json`](mcp-config.example.json)):
  67. ```json
  68. {
  69. "mcpServers": {
  70. "mcd": {
  71. "type": "streamablehttp",
  72. "url": "https://mcp.mcd.cn",
  73. "headers": { "Authorization": "Bearer <你的MCP_TOKEN>" }
  74. }
  75. }
  76. }
  77. ```
  78. ### 第 3 步:安装本 Skill
  79. 把本仓库克隆下来,将 [`SKILL.md`](SKILL.md) 安装到你的 AI 客户端 Skill 目录(ZCode / WorkBuddy 用户可直接指向本仓库目录),然后:
  80. ```text
  81. 你:麦麦,帮我看看今天有什么优惠券
  82. ```
  83. ### 纯命令行(不想装 Agent?)
  84. 零依赖,Node ≥ 18 即可:
  85. ```bash
  86. git clone https://github.com/07liu/maimen-butler.git
  87. cd maimen-butler
  88. echo "MCD_MCP_TOKEN=<你的Token>" > .env # 或 export 环境变量
  89. node scripts/mcd.mjs tools # 列出全部 35 个 MCP 工具及参数
  90. node scripts/mcd.mjs deals # 当前可领优惠券
  91. node scripts/mcd.mjs account # 积分余额与临期提醒
  92. node scripts/mcd.mjs calendar # 营销活动日历(自动带当天日期)
  93. node scripts/mcd.mjs call query-nearby-stores '{"beType":1,"searchType":1}' # 调任意工具
  94. node scripts/patrol.mjs # 🚨 每日巡检:积分临期+可领券+今日活动+抽奖机会,一次跑完
  95. node scripts/compare.mjs --city 北京 --keyword 中关村 \
  96. '[{"name":"巨无霸单点","items":[{"productCode":"1100","quantity":1}]},
  97. {"name":"巨无霸x2","items":[{"productCode":"1100","quantity":2}]}]' # ⚖️ 多组合权威核价
  98. ```
  99. > 也可以用 npm 别名:`npm run patrol` / `npm run bigmac` / `npm run deals`(零依赖,不需要 npm install)。
  100. ## 🚨 每日巡检 MaiMen Patrol
  101. [`scripts/patrol.mjs`](scripts/patrol.mjs) 把"每天该薅的羊毛"一次跑完——积分临期、可领优惠券、今日活动、抽奖机会,实测输出(2026-10-09):
  102. ```text
  103. 💰 积分账户:可用积分与当月临期积分实时读取,临期自动提醒兑换
  104. 🎫 可领优惠券:共 9 张(免费脆薯饼 / 麦旋风买一送一 / 9.9元冰美式 …)
  105. 🎁 今日活动:共 14 个(G-DRAGON 联名 / 9.9元早餐两件套 …)
  106. 🎰 积分抽奖:麦麦积分抽奖进行中,是否可参与以服务端决策为准
  107. ```
  108. 配 Windows 任务计划程序或 cron 就是全自动定时巡检(`node scripts/patrol.mjs --json` 可接通知管道):
  109. ```bash
  110. # cron 示例:每天 9:00 / 21:00 各巡检一次
  111. 0 9,21 * * * cd /path/to/maimen-butler && node scripts/patrol.mjs >> patrol.log 2>&1
  112. ```
  113. ## ⚖️ 麦门比价器 MaiMen Compare
  114. [`scripts/compare.mjs`](scripts/compare.mjs):同一门店多组候选(单点 vs 套餐 vs 用券)批量走 `calculate-price` 权威核价,按券后价排序、标出最优解 👑。支持 `--store` 指定门店或 `--city + --keyword` 自动选店,外送/得来速场景可传 `--beCode`。
  115. ## 🏗️ 工作原理
  116. ```mermaid
  117. flowchart LR
  118. U["🗣️ 你的一句话需求"] --> S["SKILL.md<br/>三大工作流编排"]
  119. S --> MCP["麦当劳官方 MCP Server<br/>mcp.mcd.cn (Streamable HTTP)"]
  120. MCP --> MCD["麦当劳中国<br/>菜单 · 优惠券 · 订单 · 积分商城 · 抽奖 · 活动"]
  121. S -.兜底.-> CLI["scripts/mcd.mjs<br/>零依赖命令行客户端"]
  122. CLI --> MCP
  123. ```
  124. - [`SKILL.md`](SKILL.md) 定义了省钱 / 点餐 / 白嫖三条工作流与安全规则(下单前必确认、永不代付)
  125. - [`scripts/mcd.mjs`](scripts/mcd.mjs) 是一个约 250 行的零依赖 MCP Streamable HTTP 客户端(自动握手、SSE 解析、401/429 友好提示),让没有 Agent 的同学也能用
  126. - [`scripts/patrol.mjs`](scripts/patrol.mjs) / [`scripts/compare.mjs`](scripts/compare.mjs) / [`scripts/bigmac-index.mjs`](scripts/bigmac-index.mjs) 是基于它构建的三个开箱即用工具:每日巡检、多组合比价、巨无霸指数
  127. - 所有真实交易(支付)仍在麦当劳官方 App 完成,本管家不碰钱
  128. ## 🎯 目标用户
  129. | 人群 | 打开方式 |
  130. |---|---|
  131. | 🧑‍💻 程序员 / 打工人 | 加班餐一句话搞定,预算内自动找最优解 |
  132. | 💰 精打细算党 | 券自动领、价自动比、积分不过夜 |
  133. | 🏃 健身减脂人群 | 热量营养数据对比,吃得明白 |
  134. | 🧋 麦门信徒 | 活动、抽奖、限定,一个不落 |
  135. ## 🗺️ Roadmap
  136. - [x] ~~巨无霸指数:8 城实时比价~~(已上线,见上文)
  137. - [x] ~~1024 程序员节模式~~(日期自动激活)
  138. - [x] ~~定时巡检~~(`patrol.mjs` 每日巡检脚本已上线,配 cron/任务计划即全自动推送)
  139. - [ ] 巡检结果接通知管道(Server 酱 / 企业微信 webhook)
  140. - [ ] 多人拼单分账
  141. - [ ] 生日会 / 派对主题场景支持(`query-party-*` 已预留)
  142. ## ⚠️ 声明
  143. 本项目为 **2026 麦当劳程序员节创意开发大赛** 参赛作品,由参赛者独立开发,**非麦当劳官方产品**。餐品、价格、活动信息以麦当劳官方渠道实时数据为准。请妥善保管你的 MCP Token,不要提交到任何公开仓库。参赛声明见 [CONTEST_DECLARATION.md](CONTEST_DECLARATION.md)。
  144. ## 🙏 鸣谢
  145. - [麦当劳中国 MCP Server](https://github.com/M-China/mcd-mcp-server) — 官方 MCP 能力与文档
  146. - [麦当劳程序员节创意开发大赛](https://github.com/M-China/mcd-developer-innovation-challenge) — 活动官方仓库
  147. - [open.mcd.cn](https://open.mcd.cn/mcp) — 开放平台入口
  148. ---
  149. **麦门!** 🍔 如果这个项目帮到了你,求一个 Star ⭐ —— 你的 Star 就是我的巨无霸。

Ratings and comments

Sign in to rate this skill.

Sign in

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