mcd-party-planner

麦麦派对策划团 · McD Party Planner

基于麦当劳 MCP 的儿童派对策划专家团。说一句「给 6 岁女儿办个生日会，预算 1000 元，在上海市中心」，拿到一份可以直接下单的派对方案。

问题：想给孩子办麦当劳生日会，家长现在的做法是打一圈电话——哪家店能办、哪天有空、几点、能坐几个孩子、多少钱、包场还是和人拼？信息全在门店端，无法自助比价。

方案：麦当劳 MCP 把这套能力开放成了接口，但接口不是产品——六级依赖链、单位不一致、滚动窗口、成团人数约束，任何一环理解错都会得到无效方案。本项目把这条链产品化，让一句话变成一份可下单的方案。

---

演示

输入：

帮我给 6 岁女儿办一场麦当劳生日会，预算 1000 元，在上海市中心，希望周六下午

输出（节选）：

【方案摘要】
迪士尼疯狂动物城主题生日派对 · 上海黄浦华旭国际大厦餐厅（距市中心 415m）
10-11（周六）18:30–20:00 · 8 人成团 · 预计 ¥612 · 落在 1000 元预算内 ✓

【主题与玩法】 蔡有趣 · 派对主题设计师
┌ 麦当劳狂欢生日派对 迪士尼疯狂动物城主题        ¥58/人   spuId=5224
│  小朋友变身喜爱的动物角色，为寿星庆生，迪士尼 IP 联动，适合 4–8 岁
└ 备选：四小福永远好朋友派对常规版                ¥58/人   spuId=3089

【门店与档期】 谭佳期 · 门店档期顾问
门店      麦当劳上海黄浦华旭国际大厦餐厅（西藏中路336号）
距离      415m  ·  storeCode=1450713
可约窗口  2026-10-09 ~ 2026-10-18（滚动 10 天）
推荐场次  10-11 周六  18:30–20:00   场次id=36735419
          成团 5–12 人 · 余位 12 · ¥58/人
⚠ 同店 10-11 12:00–13:30 场次亦可（场次id=36730453），但午后时段对 6 岁儿童偏热

【预算明细】 廉子惠 · 派对预算管家
场次费用    ¥58 × 8 人        ¥464
加餐        开心乐园餐 ¥25 × 8 ¥200   （含玩具，派对场景首选）
饮品        纯牛奶 ¥10.5 × 8   ¥84
优惠抵扣    —                 —
─────────────────────────────────
合计 ¥748 · 人均 ¥94 · 预算 1000 元 ✓ 结余 ¥252

【餐食建议】 甘知味 · 派对餐食顾问
主食选开心乐园餐系列（¥23.5–25，自带玩具），份量按儿童食量 0.6–0.7 份计
⚠ 过敏原：含麸质、乳制品、大豆，以门店实际配料表为准
⚠ 已为儿童剔除全部含咖啡因饮品

【下单参数卡】
spuId=5224 · skuId=待补充 · partyType=待确认(1包场/2拼团)
code=310100 · storeCode=1450713 · dateStr=2026-10-11
id=36735419 · timeStart=18:30 · timeEnd=20:00
leftNum=12 · count=8

完整对话记录见 docs/demo-transcript.md。

---

团队成员

角色	名字	职责
🎪 主理人	贺喜来派对统筹总监	编排四阶段 SOP，汇总成案，输出下单参数卡
🎨 成员	蔡有趣派对主题设计师	从派对商品池按年龄与预算筛主题，交付 spuId
📍 成员	谭佳期门店档期顾问	打通城市 → 门店 → 日期 → 场次，报余位与成团可行性
💰 成员	廉子惠派对预算管家	算总价与人均，找优惠与积分，判断预算达标
🍟 成员	甘知味派对餐食顾问	儿童餐食与甜品搭配、份量估算、过敏原提示

---

它是怎么工作的

麦当劳派对的六级依赖链——每一级的入参都来自上一级的返回值，这是本项目的核心工程约束：

① mall-points-products      派对商品池            → spuId
        ↓
② query-party-city          可预约城市 + 经纬度    → code / lat / lng
        ↓
③ query-party-store         可办派对门店          → storeCode
        ↓
④ query-party-store-date    可预约日期（滚动10天） → dateStr
        ↓
⑤ query-party-store-session 场次/成团人数/余位/价格 → 场次 id
        ↓
⑥ party-order-create        下单（包场 / 拼团）

专家团按这个依赖关系编排协作：

Phase 1  蔡有趣 ── 主题定调 ──────→ spuId
                                      ↓
Phase 2  谭佳期 ── 场地档期 ──────→ 门店 + 场次 + 余位        【串行】
                                      ↓
Phase 3  廉子惠 ── 预算测算 ──┐
         甘知味 ── 餐食搭配 ──┘                                【并行】
                                      ↓
Phase 4  贺喜来 ── 汇编 ─────────→ 派对方案 + 下单参数卡

前半段串行、后半段并行——这个编排是被 MCP 的数据结构倒逼出来的，不是形式上的多角色。

---

快速开始

1. 申请麦当劳 MCP Token

前往麦当劳 MCP 控制台，用手机号登录后在控制台申请 Token。

2. 配置连接器

在 WorkBuddy 左侧边栏【专家·技能·连接器】→【连接器】→ 右上角【自定义连接器】→【配置 MCP】，填入：

{
  "mcpServers": {
    "mcd-mcp": {
      "type": "streamablehttp",
      "url": "https://mcp.mcd.cn",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

完整的脱敏配置见 mcp-config.example.json。仓库内不含任何真实 Token。

3. 安装专家团

方式 A —— 直接使用打包文件（推荐）

将 mcd-party-planner.zip 解压到专家目录：

$WORKBUDDY_CONFIG_DIR/plugins/marketplaces/my-experts/plugins/mcd-party-planner/

方式 B —— 从源码安装

把仓库内 expert/ 目录整体复制到上述专家目录，然后注册：

python3 <expert-manager>/scripts/register_expert.py <expert-dir>

4. 开始对话

在 WorkBuddy 中选择「麦麦派对策划团」专家团，输入：

帮我给 6 岁女儿办一场麦当劳生日会，预算 1000 元，在上海市中心

5. （可选）独立验证 MCP 链路

不依赖 WorkBuddy，直接用脚本验证六级链路是否可用：

export MCD_MCP_TOKEN="your_token"
python3 tools/verify_chain.py --city 上海市 --spuId 5224

脚本仅使用 Python 标准库，无需安装任何依赖，且不会打印或写入 Token。

---

使用示例

你的问题	谁来答
帮我给 6 岁女儿办个麦当劳生日会，预算 1000 元，上海	全队（Workflow A）
本周六下午上海哪些门店能办迪士尼主题派对？还剩几个位子？	谭佳期（+ 蔡有趣定 spuId）
有哪些主题派对？适合 4 岁的有什么？	蔡有趣
8 个小朋友一共多少钱？人均多少？	廉子惠
包场和拼团哪个更划算？	廉子惠
派对吃什么？要不要加蛋糕？有过敏原吗？	甘知味

---

项目结构

.
├── README.md                    项目说明（本文件）
├── CONTEST_DECLARATION.md       参赛声明（官方原文，未改动）
├── MCP_INTEGRATION.md           MCP Server / Tools / 调用流程 / 业务价值
├── mcp-config.example.json      脱敏 MCP 配置示例（仅环境变量占位符）
├── workbuddy.md                 WorkBuddy 开发对话上下文
├── mcd-party-planner.zip        专家团打包文件（可直接安装）
├── expert/                      专家团源码
│   ├── .codebuddy-plugin/plugin.json
│   ├── settings.json
│   ├── agents/
│   │   ├── mcd-party-planner-team-lead.md   主理人 · 贺喜来
│   │   ├── party-theme-designer.md          蔡有趣
│   │   ├── party-venue-scout.md             谭佳期
│   │   ├── party-budget-keeper.md           廉子惠
│   │   └── party-feast-consultant.md        甘知味
│   ├── skills/mcd-party-booking/SKILL.md    派对预订业务参考（可复用）
│   └── avatars/                             角色头像
├── tools/
│   └── verify_chain.py          MCP 链路端到端验证脚本（纯标准库）
└── docs/
    └── demo-transcript.md       完整演示对话

---

实测数据（可复现）

以 spuId=5224（迪士尼疯狂动物城主题生日派对）为例，真实调用结果：

环节	实测值
派对商品	price="58" 元 · catName="生日类派对" · shopId=5 · status=2
可预约城市	281 个，上海市 code=310100
可办派对门店	上海市 189 家，最近 415m
可预约窗口	滚动 10 天（2026-10-09 ~ 2026-10-18）
场次	id=36730453 12:00–13:30 / id=36735419 18:30–20:00，成团 5–12 人，余位 12，price=5800（分）

四条工程约束

开发中实际踩到并沉淀进 mcd-party-booking Skill 的约束：

1. 价格单位不统一 —— 场次 price 是分（5800 = ¥58），商品 price 是元（"58"），混用直接算错预算
2. 日期是滚动窗口 —— 实测约未来 10 天，窗口外无数据
3. 成团人数是硬约束 —— partyMin–partyMax（实测 5–12 人），不足无法成团
4. 下单仅支持 shopId=5 —— 选址阶段就必须核对

---

目标用户

• 3–12 岁孩子的家长 —— 想办生日会但不想逐个门店打电话问档期
• 班级 / 幼儿园家委会 —— 组织集体生日会或主题活动
• 企业 HR / 工会 —— 组织员工子女的麦麦体验营、亲子活动、团建派对
• 麦当劳门店与开发者生态 —— 可作为派对业务的参考实现与链路文档

---

边界与免责

• 本项目为麦当劳程序员创意开发大赛参赛作品，由参赛者独立开发，非麦当劳官方产品
• 项目输出仅供参考，不构成医疗、营养或其他专业建议
• 餐品信息、价格及供应状态以麦当劳官方渠道的实时结果为准
• 优惠券与积分对派对类订单的实际抵扣效果，以下单页结算为准
• 所有推荐商品均来自该门店的真实菜单返回，不包含编造内容

---

参赛信息

• 赛事：麦当劳程序员创意开发大赛
• 活动仓库：https://github.com/M-China/mcd-developer-innovation-challenge
• 开发工具：腾讯 WorkBuddy（官方合作伙伴）
• MCP Server：麦当劳中国 MCP Server（https://mcp.mcd.cn）

License

MIT