REA
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
🍟 麦当劳门店派对成团调度 Skill — 把派对从「策划」推进到「办得成」:成团概率雷达 / 包场vs拼团 / 择日黄历 / 儿童营养指数 / 招募卡与邀请函
제작자가 쓴 원문
제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.
[](https://mcp.popnx.com/en/skills/yzg1226-mcd-party-officer)같은 작업에서 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-party-officer | rea | andrej-karpathy-skills | graphify | MoneyPrinterTurbo | |
|---|---|---|---|---|---|
| 제작자 | yzg1226 | morluto | multica-ai | Graphify-Labs | harry0703 |
| Skill 수 | 1 | 1 | 1 | 1 | 1 |
| GitHub 별 | 243 | 468,733 | 234,332 | 150,287 | 144,566 |
| 마지막 코드 변경 | 2026년 10월 11일 | 2026년 11월 19일 | 2026년 4월 20일 | 2026년 11월 18일 | 2026년 11월 18일 |
| 라이선스 | MIT | MIT | – | Apache-2.0 | MIT |
yzg1226의 Skill(지시 묶음) 1개, AI가 읽고 그대로 일해요 · MCP server가 아니에요
MCP = 손
AI를 외부 서비스나 데이터에 연결합니다(예: Notion 읽기, 청구서 만들기). 프로그램이나 서버가 실행 중이어야 합니다.
Skill = 안내서
작업 방법을 AI에게 가르치는 텍스트 파일. 어떤 서비스에도 연결되지 않습니다.
겹치는 경우도 있습니다. 도구를 부르는 스크립트가 있는 Skill도, 지식만 보내는 MCP도 있습니다. 하려는 작업을 기준으로 고르세요.
Claude Code
제작자 README와 repo 폴더 기준
GitHub 계정 yzg1226(개인)은 만든 지 1개월밖에 안 됐습니다. 특히 주의하세요
★ 243개, 아직 사용자가 적습니다 · 코드 마지막 수정 2026년 10월 11일
컴퓨터에서 실행할 수 있는 스크립트가 5개 있습니다: scripts/demo.py, scripts/demo_plus.py, scripts/mcd_client.py, scripts/party_officer.py 그리고 파일 1개 더
인터넷에 접속하는 스크립트: scripts/mcd_client.py
hook이나 컴퓨터 설정을 쓰는 동작을 찾지 못했습니다
저장소 commit f99dec0의 파일을 자동으로 검사했습니다(읽기만 했고 아무것도 실행하지 않았습니다). 안전을 보증하는 것은 아니니, 직접 읽어 보고 판단하세요
먼저: 어떤 AI를 쓰시나요
쓰는 앱을 고르면 그 앱의 설치 방법만 보여 드립니다
설명이 200자를 넘어서(246자) claude.ai에 업로드할 수 없습니다. 대신 "AI가 대신 설치하기"를 사용하세요
이 문장을 복사해 Claude Code 채팅에 붙여 넣으세요
프로젝트 하나에만 설치하려면 그 프로젝트 폴더에서 열려 있는 채팅에 붙여 넣으세요 · AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다
AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다
Claude Code를 다시 열고 /mcd-party-officer를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요
Checked against official docs 2026년 11월 12일 · Source: code.claude.com
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
명령을 확인하는 중 · 확인을 통과하면 복사 버튼이 나타나요
ChatGPT 데스크톱 앱에는 Codex가 들어 있고, Codex는 ~/.agents/skills 폴더에서 Skill을 읽습니다
ChatGPT 데스크톱 앱에서 Codex를 열고 이 문장을 채팅에 붙여 넣으세요
AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다
AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다
mcd-party-officer 폴더를 ~/.agents/skills/mcd-party-officer에 넣으세요
~는 홈 폴더($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 확장 프로그램에서 모두 쓸 수 있습니다
프로젝트 하나에만 설치하려면 그 프로젝트 폴더에서 열려 있는 채팅에 붙여 넣으세요 · AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다
AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다
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 채팅에 붙여 넣으세요
프로젝트 하나에만 설치하려면 그 프로젝트 폴더에서 열려 있는 채팅에 붙여 넣으세요 · AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다
AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다
Cursor Agent 채팅에서 /를 입력하고 mcd-party-officer 선택
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가 쓰는 앱에 맞게 고릅니다 · 이 문장을 복사해서 앱의 채팅에 붙여 넣으세요
프로젝트 하나에만 설치하려면 그 프로젝트 폴더에서 열려 있는 채팅에 붙여 넣으세요 · AI는 설치하기 전에 항상 경로를 먼저 보여 줍니다
AI가 무엇을 할지 먼저 알려 주고 모든 단계에서 허락을 구합니다
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의 지시가 아니에요
6,604자 · GitHub에서 전체 파일 열기
---
name: mcd-party-officer
agent_created: true
description: 麦当劳门店派对/包场/拼团的选址、成团调度与筹备助手。当用户想办生日派对、亲子派对、主题派对、品鉴会、读书会、麦麦体验营,或说「麦当劳派对」「派对拼团」「包场」「生日会怎么办」「哪家店能办派对」「还差几个人成团」「包场还是拼团划算」「帮我写拼团招募文案」「做一张派对邀请函」「孩子派对吃什么不超标」时使用。基于麦当劳官方 MCP(mcp.mcd.cn)的 party 系列工具:扫描全城场次、估算成团概率、对比包场与拼团成本、按官方营销活动日历挑最佳日期、审查儿童餐营养、生成招募卡与邀请函。
---
# 派对拼团官(McDonald's Party Officer)
麦当劳门店派对在 MCP 里是一条**完整但几乎无人使用**的业务线:城市 → 门店 → 可约日期 → 场次(含成团人数与余位)→ 下单,五个工具环环相扣。
本 Skill 不是"帮你订个派对",而是**一整套派对决策系统**。官方规则写着两条关键约束:
- **拼团若未在截止前凑够人数会自动取消并退款**
- **需提前 3 天预订**
于是就产生了四个真实问题,也正是本 Skill 的四大能力:
| 问题 | 能力 | 用户会怎么问 |
|---|---|---|
| 哪家店、哪天、哪场我最可能凑满人? | **成团概率雷达** | "6 个人能办成吗" |
| 包场还是拼团?哪个划算? | **双模式成本对比** | "包场和拼团差多少钱" |
| 未来哪天办最值? | **派对黄历** | "最近哪天办合适" |
| 孩子吃这些会不会钠/热量超标? | **儿童营养安心指数** | "这个搭配健康吗" |
再加上三个**能直接拿去用**的产出物:**拼团招募卡**(发群)、**派对邀请函**(可分享 HTML)、**筹备时间线**(T-7→T 待办 + 预订截止倒计时)。
## When to use
- 选址与成团:「想给孩子办麦当劳生日会」「附近哪家店能办派对」「还差几个人成团」
- 决策:「包场还是拼团」「多少钱」「有没有余位」「最近哪天有活动」
- 健康:「开心乐园餐这套搭配适合小孩吗」「怎么换更健康」
- 传播:「帮我写个拼团招募文案」「做张派对邀请函发群里」
- 其它派对型商品:主题派对、麦麦体验营、品鉴会、读书会、积分兑换活动
## 八大能力总览
| # | 能力 | 函数 | 输入 → 输出 |
|---|---|---|---|
| 1 | 成团调度扫描 | `party_officer.plan` | 城市+商品+人数 → Top N / 最易成团 / 余位告急 |
| 2 | **成团概率雷达** | `party_plus.formation_radar` | 场次+人数 → 成团概率 % + 差几人 + 拉人话术 |
| 3 | **包场 vs 拼团** | `party_plus.compare_modes` | 场次+人数 → 两模式总价、确定性、推荐结论 |
| 4 | **派对黄历** | `party_plus.party_almanac` | 候选日期 → 逐日评分(活动/周末/余位/提前量) |
| 5 | **营养安心指数** | `party_plus.kids_nutrition_audit` | 餐单 → 逐项营养 + 评分 A/B/C + 替换建议 |
| 6 | **筹备时间线** | `party_plus.party_timeline` | 活动日 → T-7→T 待办 + 预订截止倒计时 |
| 7 | 招募卡 / 邀请函 | `render_recruit_card` / `render_invite_html` | 场次 → 可发群文本 / 可分享 HTML |
| 8 | 四宫格比选 | `party_plus.scout_grid` | 候选 → 最优综合/最省/最近/空位最多 |
## 派对业务关键规则(来自官方商品说明,务必向用户复述)
| 规则 | 内容 |
|---|---|
| 成团下限 | 包场 5 人起订;**拼团需超过 5 人**才可举办 |
| 成团上限 | 每场最高 12 人(含) |
| 加价 | 包场每增加 1 人 +¥50(以实际场次 price 字段为准) |
| 时长 | 约 90 分钟 |
| 预订提前量 | **需提前 3 天预订** |
| 拼团风险 | **未成团则预约自动取消并自动退款** |
| 退订 | 需在活动日前 3 天申请,当天缺席不退款 |
| 适用人群 | 多数生日派对商品面向 4–12 岁儿童(不同商品不同) |
> 价格、人数门槛、适用人群**因商品而异**,一律以 `mall-product-detail` 返回的 `note` 与 `skuList[].price` 为准。
## 执行流程
### 第 0 步:确定派对商品(spuId)
```
mall-points-products({"catRuleIds": "1>6>20"}) # 生日类派对
mall-points-products({"catRuleIds": "1>6>21"}) # 主题类派对
mall-points-products({"catRuleIds": "1>6>22"}) # 麦麦体验营
mall-points-products({"catRuleIds": "1>6>25"}) # 品鉴会
mall-points-products({"catRuleIds": "1>6>34"}) # 读书会
mall-points-products({"catRuleIds": "1>6>40"}) # 积分兑换活动
```
拿到 `spuId` 后,用 `mall-product-detail({"spuId": ...})` 读取 `skuList[].skuId`(下单必需)与 `note`。
### 第 1–4 步:扫描场次(核心)
```
query-party-city({"spuId": 1779}) → 城市列表(code / 经纬度)
query-party-store({"code": "330100", → 可承办门店(含 distance / 营业状态)
"spuId": 1779,
"latitude": ..., "longitude": ...})
query-party-store-date({"spuId": 1779, → 可预约日期
"storeCode": "3330206"})
query-party-store-session({"spuId": 1779, → 场次(时间/成团人数/价格/余位)
"storeCode": "3330206",
"dateStr": "2026-10-14"})
```
### 第 5 步:成团调度排序
对每个候选场次打分(`scripts/party_officer.py::score`),五维:成团可行性(硬约束)、余位紧张度、时段匹配、价格、距离。
输出三个视图:**推荐 Top N**、**最易成团**、**余位告急**。
### 第 6 步:下单(必须二次确认)
```
party-order-create({"partyType": 1, # 1=包场,2=拼团
"spuId": 1779, "skuId": 2027,
"storeCode": "3330206", "code": "330100",
"dateStr": "2026-10-14",
"id": 36825489, # 场次 id
"leftNum": 12, "count": 6})
```
**未经用户明确确认,禁止调用下单类工具。**
## 创意增强模块(差异化所在)
> 以下模块全部为**纯算法 + 官方数据**,不依赖模型猜测,结果可复现、可解释。
### ① 成团概率雷达 `formation_radar(date, sess, headcount)`
输出 `prob`(5~95%) / `level` / `gap`(还差几人) / `reasons`(逐条依据) / `pitch`(可直接发群的拉人话术)。
评分依据(透明可查):是否达成团线(基础 68,每差 1 人 −11)/余位是否够用(+8 / +2 / −22)/筹备窗口(3–7 天 +10,≤2 天 −16)/周末 +7 /晚市 +4。
### ② 包场 vs 拼团 `compare_modes(sess, headcount)`
给出两种模式的**总价、确定性、推荐结论**。要点:包场按 `max(人数, 起订数)` 计费换取"确定举办";拼团按实际人数计费但承担未成团退款风险。同价时优先包场。
### ③ 派对黄历 `party_almanac(cli, dates, sessions_by_date, headcount)`
把 `campaign-calendar`(**markdown 文本,需 `raw_text=True` 解析**)的官方活动日与场次余位结合,逐日评分:
有官方活动 +18 /周末 +12 /余位充足 +10 /满足提前 3 天 +8 /不满足 −30。
输出 `宜 / 可 / 忌` 与"当月有活动的日期"清单。
### ④ 儿童营养安心指数 `kids_nutrition_audit(cli, combo)`
数据源 `list-nutrition-foods`(**158 个餐品的表格文本,藏在 JSON 的 `data` 字段里**,需二次解析)。
对一份餐单算合计热量/脂肪/钠/碳水,按**超出参考上限的比例**扣分,给 A/B/C 评级,并自动给出替换建议(如「中薯条→小薯条 = 钠 −45mg、热量 −79kcal」)。
> 参考区间为儿童单餐:热量 400–700 kcal、钠 ≤800 mg、脂肪 ≤26 g。**这是本模块唯一的硬编码标准,需向用户说明是参考值而非官方结论。**
### ⑤ 筹备时间线 `party_timeline(date)`
输出 T-7 → T 日待办与**预订截止倒计时**(截止日 = 活动日 − 3 天),并在 ≤3 天时给出强提醒。
### ⑥ 招募卡 / 邀请函
- `render_recruit_card(...)` → 带余位进度条的群消息文本
- `render_invite_html(...)` → 麦当劳红黄配色的单文件邀请函(浅色、可直接分享)
### ⑦ 四宫格比选 `scout_grid(ranked)`
一屏给出:**最优综合 / 最省人均 / 最近门店 / 空位最多**。
## 输出规范
给用户的最终答复建议为四段:
1. **商品与规则**:派对名称、人均价、成团区间、提前预订天数、适用人群
2. **推荐场次表**:`门店 | 日期 | 时段 | 人均 | 余位 | 成团概率 | 推荐理由`
3. **决策建议**:包场还是拼团 + 最佳日期 + 筹备截止提醒
4. **可复制产出**:招募卡文本(或邀请函文件路径)+ 是否代下单的确认问句
金额一律显示为「元」(接口单位为**分**,需 `/100`)。
## 代码入口
```bash
export MCD_MCP_TOKEN=<your_token> # https://open.mcd.cn/mcp 免费领取
python scripts/demo.py # 基础演示(成团调度)
python scripts/demo_plus.py # 创意增强演示(八大能力全量)
```
```python
from scripts.party_officer import plan
from scripts.party_plus import formation_radar, compare_modes, party_almanac, \
kids_nutrition_audit, party_timeline, render_recruit_card, render_invite_html, scout_grid
res = plan("杭州市", 1779, headcount=6, budget=60, prefer_time="dinner")
top = res["best"][0]
radar = formation_radar(top["date"], top["sess"], 6) # 成团概率
modes = compare_modes(top["sess"], 6) # 包场 vs 拼团
audit = kids_nutrition_audit(cli, ["吉士汉堡包", "中薯条", "可乐中杯"]) # 营养
```
- `scripts/mcd_client.py` —— MCP 通用客户端(35 工具,仅标准库)
- `scripts/party_officer.py` —— 扫描 + 五维成团调度评分
- `scripts/party_plus.py` —— 七个创意增强模块
- `references/party_flow.md` —— 链路详解与字段字典
- `references/tools.md` —— 全量工具速查
## 边界与注意事项
- **只读优先**:除 `party-order-create` 外全部为只读调用,可放心批量扫描。
- **两种响应格式**:多数工具返回 JSON(用 `extract_json` 解析);`campaign-calendar` 与 `list-nutrition-foods` 返回**文本/表格**,需 `raw_text=True` 或取 `data` 字段后二次解析。
- **团餐接口不稳**:`query-meals` / `query-promotions` 依赖门店营业状态,非营业时段会返回「门店可能已关闭或不在营业时间」,不要作为核心链路依赖。
- **城市匹配**:`query-party-city` 返回全国城市,按名称宽松匹配("杭州" 可命中 "杭州市")。
- **门店筛选**:只保留 `businessStatus == 1` 且 `onlineBusinessStatus == true` 的门店。
- **限流**:单 Token 600 请求/分钟;扫描请求数 = 门店数 × 日期数,建议 `max_stores ≤ 8`、`max_dates ≤ 3`。
- **Token 安全**:只从环境变量读取,不要写入代码或提交到仓库。
질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.