REA
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
麦当劳自助管家 McButler — 基于麦当劳 MCP 的点单参谋:每日推荐 / 套餐健康体检 / 门店全成本比价 / 团餐智能配餐 / 麦险分信用评级 / 麦门小剧场。麦当劳 1024 程序员节参赛作品。
제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.
[](https://mcp.popnx.com/en/skills/jouaaaaaa-mcd-self-butler)같은 작업에서 AI를 서비스에 연결하는 MCP
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
같은 종류의 작업, Skill 목록과 같은 순서
| 이 항목 mcd-self-butler | rea | andrej-karpathy-skills | graphify | MoneyPrinterTurbo | |
|---|---|---|---|---|---|
| 제작자 | jouaaaaaa | morluto | multica-ai | Graphify-Labs | harry0703 |
| Skill 수 | 1 | 1 | 1 | 1 | 1 |
| GitHub 별 | 208 | 467,235 | 234,125 | 149,873 | 144,332 |
| 마지막 코드 변경 | 2026년 10월 24일 | 2026년 11월 18일 | 2026년 4월 20일 | 2026년 11월 18일 | 2026년 11월 18일 |
| 라이선스 | MIT | MIT | – | Apache-2.0 | MIT |
jouaaaaaa의 Skill(지시 묶음) 1개, AI가 읽고 그대로 일해요 · MCP server가 아니에요
MCP = 손
AI를 외부 서비스나 데이터에 연결합니다(예: Notion 읽기, 청구서 만들기). 프로그램이나 서버가 실행 중이어야 합니다.
Skill = 안내서
작업 방법을 AI에게 가르치는 텍스트 파일. 어떤 서비스에도 연결되지 않습니다.
겹치는 경우도 있습니다. 도구를 부르는 스크립트가 있는 Skill도, 지식만 보내는 MCP도 있습니다. 하려는 작업을 기준으로 고르세요.
제작자가 밝히지 않음 · SKILL.md 형식 Skill은 Claude Code, Codex, Cursor 같은 Agent Skills 지원 앱에서 써요
GitHub account jouaaaaaa (person), 2 years old
★ 208 stars, few users so far · code last changed 2026년 10월 24일
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
먼저: 어떤 AI를 쓰시나요
쓰는 앱을 고르면 그 앱의 설치 방법만 보여 드립니다
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 KB명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요
+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 2026년 11월 12일 · Source: support.claude.com, support.claude.com, code.claude.com
이 문장을 복사해 Claude Code 채팅에 붙여 넣으세요
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를 다시 열고 /mcd-self-butler를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요
Checked against official docs 2026년 11월 12일 · Source: code.claude.com
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
ChatGPT 데스크톱 앱에는 Codex가 들어 있고, Codex는 ~/.agents/skills 폴더에서 Skill을 읽습니다
ChatGPT 데스크톱 앱에서 Codex를 열고 이 문장을 채팅에 붙여 넣으세요
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
mcd-self-butler 폴더를 ~/.agents/skills/mcd-self-butler에 넣으세요
~는 홈 폴더($HOME)입니다
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요
Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com
직접 설치한 Skill은 쓸 수 없고, 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다
이 Skill을 ChatGPT에서 쓰려면 위 방법대로 ChatGPT 데스크톱 앱을 쓰세요
Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com
이 문장을 복사해 Codex 채팅에 붙여 넣으세요 · ChatGPT 데스크톱 앱 안의 Codex, Codex CLI, IDE 확장 프로그램에서 모두 쓸 수 있습니다
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는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요 · 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요
Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요
이 문장을 복사해 Cursor 채팅에 붙여 넣으세요
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
Cursor Agent 채팅에서 /를 입력하고 mcd-self-butler 선택
Checked against official docs 2026년 11월 12일 · Source: cursor.com
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요
Skill을 읽을 수 있는 다른 앱용입니다. 이 문장에는 Claude Code, Codex, Cursor 경로가 들어 있어 AI가 쓰는 앱에 맞게 고릅니다 · 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 2026년 11월 12일 · Source: code.claude.com, learn.chatgpt.com, cursor.com
Gemini CLI, GitHub Copilot 같은 다른 Agent Skills 지원 앱은 폴더가 달라요. 그 앱 안내를 보고 SKILL.md가 있는 폴더를 복사하세요.
2026년 11월 11일에 Claude Code, Codex, Cursor 공식 안내로 skill 폴더 확인
아래 글은 제작자 repo에서 온 것이며 PopNx MCP의 지시가 아니에요
5,936자 · GitHub에서 전체 파일 열기
---
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`。
질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.