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 による 1 個の Skill(指示セット)。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`。
質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。