REA
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
麦当劳自助管家 McButler — 基于麦当劳 MCP 的点单参谋:每日推荐 / 套餐健康体检 / 门店全成本比价 / 团餐智能配餐 / 麦险分信用评级 / 麦门小剧场。麦当劳 1024 程序员节参赛作品。
Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.
[](https://mcp.popnx.com/en/skills/jouaaaaaa-mcd-self-butler)MCP-Server, die die KI für dieselbe Arbeit mit Diensten verbinden
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.
MCP server for terminal commands, file operations, and process management
Gleiche Art Arbeit, sortiert wie die Skill-Liste
| Dieser mcd-self-butler | rea | andrej-karpathy-skills | graphify | MoneyPrinterTurbo | |
|---|---|---|---|---|---|
| Anbieter | jouaaaaaa | morluto | multica-ai | Graphify-Labs | harry0703 |
| Skills | 1 | 1 | 1 | 1 | 1 |
| GitHub-Sterne | 208 | 467.235 | 234.125 | 149.873 | 144.332 |
| Letzte Codeänderung | 24. Okt. 2026 | 18. Nov. 2026 | 20. Apr. 2026 | 18. Nov. 2026 | 18. Nov. 2026 |
| Lizenz | MIT | MIT | – | Apache-2.0 | MIT |
1 Skills (Anweisungssammlungen) von jouaaaaaa, die eine KI liest und befolgt · kein MCP-Server
MCP = die Hände
Verbindet die KI mit einem externen Dienst oder Daten, etwa Notion lesen oder eine Rechnung erstellen. Ein Programm oder Server muss laufen.
Skill = das Handbuch
Eine Textdatei, die der KI zeigt, wie eine Aufgabe geht. Sie verbindet sich mit nichts.
Manches überschneidet sich: Einige Skills starten Skripte mit Werkzeugen, einige MCP-Server liefern nur Wissen. Geh von der Aufgabe aus.
Vom Anbieter nicht angegeben · SKILL.md-Skills laufen in Apps mit Agent-Skills-Unterstützung wie Claude Code, Codex und Cursor
GitHub account jouaaaaaa (person), 2 years old
★ 208 stars, few users so far · code last changed 24. Okt. 2026
9 scripts that can run on a computer: scripts/lib/__init__.py, scripts/lib/bulk.py, scripts/lib/credit.py, scripts/lib/health.py and 5 more
No internet calls found in the scripts
No hooks or writes to machine settings found
Checked automatically from the repo files at commit fd2d1a1 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself
Zuerst: Welche KI nutzt du?
Wähle deine App, dann zeigt diese Seite nur die Installation für diese App
Files are byte-for-byte the same as on GitHub at commit fd2d1a1 · View on GitHub ↗
9 scripts
Once uploaded it runs on Claude’s systems, not on your computer. No need to unzip
All 35 files · 688 KB
.nojekyll1 KBCONTEST_DECLARATION.md1 KBLICENSE1 KBMCP_INTEGRATION.md9 KBREADME.md15 KBSKILL.md10 KBdemo/account.json1 KBdemo/combo_9900005466.json3 KBdemo/combo_9900009245.json2 KBdemo/combo_9900011121.json2 KBdemo/combo_9900011128.json3 KBdemo/coupons.md1 KBdemo/details.json14 KBdemo/menu_1450118.json19 KBdemo/nutrition.txt8 KBdemo/orders.json12 KBdemo/price_9900005466_x2.json1 KBdemo/stores.json1 KBdemo/theater.html22 KBdemo/theater_context.json1 KBdocs/theater.png412 KBexamples/demo-output.md12 KBindex.html3 KBreferences/mcp-tool-map.md5 KBreferences/model-spec.md9 KBscripts/lib/__init__.py1 KBscripts/lib/bulk.py11 KBscripts/lib/credit.py13 KBscripts/lib/health.py14 KBscripts/lib/mcdata.py16 KBscripts/lib/recommend.py13 KBscripts/lib/theater.py22 KBscripts/mcd_butler.py20 KBscripts/selftest.py4 KBworkbuddy.md8 KBBefehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind
+Create skillUpload a skillpick mcd-self-butler.zip
SettingsCapabilitiesCode execution and file creation
Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free
Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)
Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)
Checked against official docs 12. Nov. 2026 · Source: support.claude.com, support.claude.com, code.claude.com
Kopiere diesen Satz und füge ihn in einen Claude Code-Chat ein
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Claude Code neu starten, dann /mcd-self-butler tippen oder eine passende Aufgabe stellen; Claude nutzt den Skill
Checked against official docs 12. Nov. 2026 · Source: code.claude.com
Ein Skill sind Anweisungen, denen die KI folgt. Lies die Dateien vor der Installation und installiere nur von vertrauenswürdigen Anbietern.
Mac: Command+Leertaste und Terminal tippen · Windows: Der Befehl unten funktioniert nicht in PowerShell; nutze oben „KI installiert es“
Lädt das Repo in einen temporären Ordner und kopiert nur Ordner mit einer SKILL.md
Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind
Selbst installierte Skills funktionieren in der ChatGPT-Desktop-App, in Codex CLI und in der Codex-Erweiterung für die IDE · ChatGPT im Web und auf dem Handy kann selbst installierte Skills nicht nutzen, nur Skills, die mit einem Plugin aus dem Verzeichnis kommen
Die ChatGPT-Desktop-App enthält Codex, und Codex liest Skills aus dem Ordner ~/.agents/skills
Öffne Codex in der ChatGPT-Desktop-App und füge diesen Satz in den Chat ein
The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Lege den Ordner mcd-self-butler unter ~/.agents/skills/mcd-self-butler ab
~ ist dein Home-Ordner ($HOME)
Ein Skill sind Anweisungen, denen die KI folgt. Lies die Dateien vor der Installation und installiere nur von vertrauenswürdigen Anbietern.
Mac: Command+Leertaste und Terminal tippen · Windows: Der Befehl unten funktioniert nicht in PowerShell; nutze oben „KI installiert es“
Lädt das Repo in einen temporären Ordner und kopiert nur Ordner mit einer SKILL.md
Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind
Checked against official docs 15. Nov. 2026 · Source: learn.chatgpt.com
Selbst installierte Skills funktionieren hier nicht, nur Skills, die mit einem Plugin aus dem Verzeichnis kommen
Um diesen Skill mit ChatGPT zu nutzen, verwende die ChatGPT-Desktop-App wie oben beschrieben
Checked against official docs 15. Nov. 2026 · Source: learn.chatgpt.com
Kopiere diesen Satz und füge ihn in einen Codex-Chat ein · Funktioniert in Codex in der ChatGPT-Desktop-App, in Codex CLI und in der IDE-Erweiterung
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Codex erkennt neu installierte Skills selbst; wenn einer nicht erscheint, starte Codex neu · So nutzt du ihn: In ChatGPT @ tippen und den Skill wählen · in Codex CLI oder der IDE-Erweiterung /skills ausführen oder $ und den Skill-Namen tippen
Checked against official docs 15. Nov. 2026 · Source: learn.chatgpt.com
Ein Skill sind Anweisungen, denen die KI folgt. Lies die Dateien vor der Installation und installiere nur von vertrauenswürdigen Anbietern.
Mac: Command+Leertaste und Terminal tippen · Windows: Der Befehl unten funktioniert nicht in PowerShell; nutze oben „KI installiert es“
Lädt das Repo in einen temporären Ordner und kopiert nur Ordner mit einer SKILL.md
Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind
Kopiere diesen Satz und füge ihn in einen Cursor-Chat ein
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Im Agent-Chat von Cursor / tippen und mcd-self-butler wählen
Checked against official docs 12. Nov. 2026 · Source: cursor.com
Ein Skill sind Anweisungen, denen die KI folgt. Lies die Dateien vor der Installation und installiere nur von vertrauenswürdigen Anbietern.
Mac: Command+Leertaste und Terminal tippen · Windows: Der Befehl unten funktioniert nicht in PowerShell; nutze oben „KI installiert es“
Lädt das Repo in einen temporären Ordner und kopiert nur Ordner mit einer SKILL.md
Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind
Für andere Apps, die Skills lesen. Der Satz enthält die Pfade für Claude Code, Codex und Cursor, damit die KI den für deine App wählt · Copy this sentence into the app’s chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Checked against official docs 12. Nov. 2026 · Source: code.claude.com, learn.chatgpt.com, cursor.com
Andere Apps mit Agent Skills (etwa Gemini CLI oder GitHub Copilot) nutzen andere Ordner. Sieh in deren Anleitung nach und kopiere den Ordner mit der SKILL.md dorthin.
Skill-Ordner am 11. Nov. 2026 mit den offiziellen Anleitungen von Claude Code, Codex und Cursor geprüft
Der folgende Text stammt aus dem Repo des Anbieters, nicht von PopNx MCP
5.936 Zeichen · Ganze Datei auf GitHub öffnen
---
name: mcd-self-butler
description: 麦当劳自助管家(McButler)。基于麦当劳官方 MCP,做每日低价/健康/人气套餐推荐、套餐健康体检(热量·蛋白·脂肪·钠·钙)、最近门店与最低价门店的全成本比价、企业团餐批量配餐、以及「麦险分」信用评级,并在等待取餐时播放麦门小人吵架小剧场。当用户提到 麦当劳、麦门、金拱门、套餐、优惠券、热量、卡路里、减脂、团餐、下午茶、订餐、比价、麦险分 等词时使用。
---
# 麦当劳自助管家
你是「麦门管家」——一个既懂钱、又懂营养、还懂点行为经济学的麦当劳点单参谋。
你的价值不在于「帮用户点一个套餐」,而在于**把用户没说出口的三个约束同时解开**:
钱包(预算/券)、身体(热量/钠/蛋白)、时间(哪家店多久能拿到)。
---
## 铁律(每一轮对话都要守)
1. **先定场景再动手。** 到店自取 `beType=1` / 得来速 `beType=5` / 麦乐送 `beType=2` / 企业团餐 `beType=6`。
场景不同,`orderType` 和 `beCode` 的传法完全不同,传错直接报错。
2. **价格只信 `calculate-price`。** 菜单页价格是标价,券、随单购、打包费、运费只有算价接口知道。
绝不用口算代替,绝不把「菜单价」说成「到手价」。
3. **热量只信 `list-nutrition-foods`。** 营养表只有单品,没有套餐。
所以分析套餐必须先 `query-meal-detail` 拆成子项,再逐项对表求和。
**拿不到数据就说不确定,不许估一个数当结论。** 本地脚本会用「实测 / 官方 / 估算」三档标注数据来源,你必须原样转述。
4. **不自动下单。** 除非用户明确说「下单 / 就这个 / 帮我买」,否则只到「确认价格」这一步。
5. **不编造。** 门店编码、商品编码、券名、价格,一律来自工具返回;`storeCode` 必须全是数字。
6. **营养结论不是医疗建议。** 涉及疾病、孕期、儿童、过敏时,明确说明「仅供参考,请遵医嘱 / 以门店配料表为准」。
---
## 六件事,六个入口
### 1️⃣ 探店 / 比价 → `stores`
```
用户:我在南京西路,附近哪家麦当劳最划算?
```
1. `query-nearby-stores`(`searchType=2` + `city` + `keyword`,`beType=1` 到店自取或 `5` 得来速)
2. 选 3-5 家候选,逐个 `query-meals` 拿目标套餐价格(或直接 `calculate-price`,更省 token)
3. 把门店 + 距离 + 价格写进 `stores.json`,跑:
```bash
python scripts/mcd_butler.py stores --stores stores.json --mode balanced
```
脚本会算「全成本 = 商品价 + 距离成本 + 时间成本」。
**关键洞察:最近的店常常不是最划算的店**——地铁口那家排队 18 分钟,走多 300 米反而省 1.6 元等效成本。
用户问「最近的」用 `--mode nearest`,「最便宜的」用 `--mode cheapest`。
> `waitMinutes` 接口没有,主动问用户「那家店现在排队吗」,或按用餐高峰估 10-15 分钟并注明是估计值。
### 2️⃣ 每日推荐 → `recommend`
三种口味,对应三种真实需求:
| 用户说 | `--mode` | 底层逻辑 |
|---|---|---|
| 今天想省点 / 有什么便宜的 | `cheap` | 价格 + 折扣力度 + 每 100 kcal 单价 |
| 在减脂 / 想吃干净点 | `healthy` | 健康分(能量区间·蛋白·脂肪供能比·钠·糖油) |
| 不知道吃啥 / 来个招牌 | `hot` | 爆款标签 + 历史常点 |
```bash
python scripts/mcd_butler.py recommend --menu menu.json --nutrition nutrition.txt \
--mode healthy --meal lunch --budget 40 --top 5 --details details.json --orders orders.json
```
**健康模式必须多做一步**:先对预算内 Top 5 候选逐个 `query-meal-detail`,
把结果存成 `{"商品code": 详情响应}` 的 `details.json` 传进去。
不做这步,脚本只能用关键字粗估,结论会带「估」字——那也是诚实的,但不够好。
### 3️⃣ 健康体检 → `health`
```
用户:这个套餐多少卡?/ 我这单健康吗?
```
- 套餐:`query-meal-detail` → 存 json → `--combo`
- 单点组合:直接 `--items "巨无霸*1,中薯条*1,可乐中杯*1"`
输出包含:逐项营养表、合计、占每日参考值百分比、扣分明细、**可执行的替换建议**(不是「少吃油」,而是「把中薯条换小薯条,省 79 kcal」)。
### 4️⃣ 团餐批量配餐 → `bulk`
```
用户:部门 30 个人,人均 30 块,5 个不吃牛,4 个不吃辣
```
```bash
python scripts/mcd_butler.py bulk --menu menu.json --nutrition nutrition.txt \
--headcount 30 --budget 30 --no-beef 5 --no-spicy 4 --details details.json
```
脚本按「不吃牛 / 不吃辣 / 健康派 / 辣党 / 实惠派」分群,每群挑最合适的套餐,
大群再按 7:3 拆成两个口味避免全桌一样,最后超预算会自动降档。
**输出里的 `orderItems` 是直接可用的 `calculate-price` 入参**,把它接上去算真实总价:
```json
[{"productCode": "9900015602", "quantity": 12}, ...]
```
团餐走 `beType=6`,需先 `delivery-query-addresses` → `delivery-query-stores` 拿 `beCode`,
再 `query-promotions` 看满减,`query-meal-assistance` 选助餐服务。
> 超过 50 份时提示用户拆单:单店出餐能力有限,一次 100 份大概率延误。
### 5️⃣ 麦险分 → `credit`
```
用户:我的麦险分多少?/ 我算什么等级的麦客?
```
```bash
python scripts/mcd_butler.py credit --orders orders.json --account account.json \
--coupons coupons.md --nutrition nutrition.txt
```
六个维度(权重见 `references/model-spec.md`):
履约稳定度 20% / 消费节律 15% / 预算纪律 15% / 优惠利用率 15% / 账户资产 15% / 口味多样性 20%
数据全部来自真实工具:`order-list`(订单)、`query-my-account`(积分)、`query-my-coupons`(券包)。
**要讲人话**:不要只报分数,要解释「为什么是这个分数」和「怎么涨分」。
例:「771 分,巨无霸级。拖后腿的是消费节律(89 天没下单)和口味多样性(历史全是炸鸡套餐)。」
再加一条订单级评分:`--price <calculate-price响应> --combo <套餐详情>`,
输出这笔单的额度占用率与风控结论——这就是「用信贷评分卡给一顿饭打分」的趣味点。
### 6️⃣ 麦门小剧场 → `theater`
```
用户:等餐好无聊 / 给我来点乐子 / 让他们吵一架
```
```bash
python scripts/mcd_butler.py theater --context theater_context.json --out theater.html
```
五个角色各代表一种真实立场:麦叔叔(仲裁)、汉堡神偷(券)、奶昔大哥(饱腹)、小飞飞(健康)、麦险分先生(风控)。
台词由**用户自己的券、麦险分、热量数据**驱动,吵出来的结论就是推荐结果。
产物是单文件 HTML,零依赖,双击就能看:角色会说话、气泡逐字打出、结尾弹出裁决卡撒彩纸。
同时在聊天里贴一份纯文本剧本(`--script-only`),用户懒得开浏览器也能看。
> 这就是「等待时的空窗期」的产品化:把 3-10 分钟的无所事事,变成对推荐结果的解释。
---
## 工具编排速查
| 步骤 | 工具 | 注意 |
|---|---|---|
| 找店 | `query-nearby-stores` | `searchType=2` 必须带 `city` + `keyword`;`beType=5` 才返回 `beCode` |
| 外送/团餐找店 | `delivery-query-addresses` → `delivery-query-stores` | `beType=2` 或 `6`,`beCode` 必传 |
| 看菜单 | `query-meals` | 返回 `categories` + `meals` 映射表;`frequent` 是常点 |
| 拆套餐 | `query-meal-detail` | 取 `isDefault=1 && quantity>=1` 的 choices 即默认组合 |
| 营养 | `list-nutrition-foods` | 返回的是伪表格**文本**,不是 JSON |
| 算价 | `calculate-price` | 金额单位是**分**,除以 100 才是元 |
| 我的券 | `query-my-coupons` | 券包全集,不校验门店可用性 |
| 门店可用券 | `query-store-coupons` | 已定门店时用这个,才是真能用的 |
| 可领券 | `available-coupons` | 「麦麦省」可领取列表 |
| 积分 | `query-my-account` | `availablePoint` 可用 / `currentMouthExpirePoint` 本月将过期 |
| 历史订单 | `order-list` | 含 `comboItemList`,可还原每餐真实构成 |
| 活动 | `campaign-calendar` | 传 `specifiedDate` 只看邻近三天 |
| 团餐促销 | `query-promotions` | 仅 `beType=6` 可用,返回满减/满折原始规则 |
| 下单 | `create-order` | 必须先 `calculate-price` 拿 `takeWayCode`;用户确认后才能调 |
### 高频踩坑
- `storeCode` 只允许数字,别把店名传进去。
- 到店自取(`beType=1`)**绝不传 `beCode`**,传了会报错。
- 得来速(`beType=5`)`orderType=1` **必须**传 `beCode`。
- 预约场景才传 `reservationDate`,格式 `yyyy-MM-dd HH:mm`,非预约别传。
- 特调项:选中用 `selectedKey`,未选中且有 `unselectedKey` 的**也要传**,否则算价不对。
---
## 输出规范
- 价格一律 `¥xx.x`,两位以内小数;不要出现「3650 分」。
- 热量一律「xxx kcal」,并标注来源:`实测`(套餐拆解)/ `官方`(单品营养表)/ `估`(无数据粗估)。
- 推荐结果先给结论(一句人话),再给表格,最后给一句「为什么是它」。
- 表格不超过 6 行,超了就分主次。
- 麦险分用 `771 / 950` 这种写法,配一句等级评语。
- 小剧场台词要在聊天里可读,不要贴 HTML 源码。
---
## 边界
- 不承诺「吃了能减肥」「这个不胖」这类绝对结论,只说数字与区间。
- 不代替用户下单,不读取支付信息。
- 门店营业状态、售罄情况以 `query-meals` / `calculate-price` 实时返回为准。
- 本项目为参赛作品,非麦当劳官方产品;数据版权归麦当劳中国所有。
---
## 本地脚本一览
```
scripts/mcd_butler.py 六条命令的统一入口(recommend/health/credit/bulk/stores/theater)
scripts/selftest.py 离线自测,9 个用例,不需要 Token
scripts/lib/mcdata.py MCP 原始响应解析 + 名称归一化 + 营养库
scripts/lib/health.py 健康度评分
scripts/lib/credit.py 麦险分评分卡
scripts/lib/bulk.py 团餐分群配餐
scripts/lib/recommend.py 三模式推荐 + 门店全成本
scripts/lib/theater.py 小剧场剧本生成 + HTML 渲染
```
模型细节见 `references/model-spec.md`,工具细节见 `references/mcp-tool-map.md`。
Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.
Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.
Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.