McOmni — скилл

---
name: mcdonalds
description: 麦当劳中国官方 MCP 全能助手。当用户提到麦当劳、麦乐送、开心乐园餐、麦麦省优惠券、领券、点麦当劳、外送到家、得来速、麦当劳积分、积分抽奖、积分商城兑换、麦当劳餐品热量/营养、麦当劳订单查询或取消、麦当劳周边玩具与活动时使用。覆盖官方 35 个工具的全部能力，内置领券、到店点餐、外送、玩具雷达、积分抽奖、热量计算、优惠计算器七大工作流。
agent_created: true
---

# 麦当劳 MCP 全能助手

通过麦当劳中国官方 MCP Server（`mcd-mcp` @ `https://mcp.mcd.cn`）为用户完成从领券、比价、点餐、外送到积分抽奖、营养计算的全流程。共 **35 个工具**，全部能力见 `references/tools.md`。

## 前置条件

1. `~/.workbuddy/mcp.json` 中需存在 `mcpServers.mcd-mcp`（含 `Authorization: Bearer <token>`）。Token 获取：https://open.mcd.cn/mcp
2. 该 MCP 需在「连接器管理」中点击**信任**后，工具才会出现在可用工具列表里。

## 两种调用通道

| 通道 | 适用 | 说明 |
|---|---|---|
| **A. 直接调用 MCP 工具**（首选） | MCP 已被信任 | 直接调用工具名，如 `query-meals`。参数严格按 `references/tools.md` |
| **B. 命令行脚本**（备选/排障） | MCP 未信任、或需在终端验证 | `python scripts/mcd_cli.py call <工具名> '<json>'`；`list` 列工具、`desc` 查参数 |

通道 B 示例：

```bash
python scripts/mcd_cli.py list 优惠
python scripts/mcd_cli.py call auto-bind-coupons
python scripts/mcd_cli.py call query-nearby-stores '{"beType":1,"searchType":1,"city":"北京"}'
```

## 通用铁律（违反会直接报错或下错单）

1. **`beType` 决定一切**：`1`=到店自取、`2`=麦乐送外送、`5`=得来速、`6`=企业团餐。
2. **`orderType`**：到店类（含自取 + 得来速）= `1`；外送类（含麦乐送 + 团餐）= `2`。
3. **`beCode` 与 `storeCode` 配对**：到店自取(`beType=1`)**不传** `beCode`；得来速从 `query-nearby-stores` 取；麦乐送/团餐从 `delivery-query-stores` 取。传错会报错。
4. **`query-nearby-stores.searchType` 必须传对**（实测坑）：
   - `searchType=1` 查**收藏餐厅**；该 `beType` 无收藏时返回 `600050 收藏餐厅列表为空`。到店自取(beType=1)通常有收藏店，得来速(beType=5)常为空。
   - `searchType=2` 按位置搜索，**必须 `city` 与 `keyword` 同时传**；只传其一必报 `600058 城市名或者关键词不能为空`。
   - 稳妥路径：先试 `searchType=1`，报 600050 则改用 `searchType=2` + `city` + `keyword`。
5. **菜单编码路径**：`query-meals` 的餐品编码在 **`data.categories[].meals[].code`**，详情在 `data.meals.{code}`（含 `name`/`currentPrice`/`originalPrice`）。
   ⚠️ **不要误取响应外层的 `code`**——那是业务状态码（`200`），不是餐品编码。
6. **绝不臆造编码**：`storeCode`、`beCode`、`addressId`、`productCode`、`couponId`、`skuId` 都必须来自上游工具返回，不得凭空生成。
7. **`reservationDate` 仅预约场景传**（格式 `yyyy-MM-dd HH:mm`），非预约**不要传**。门店返回 `reservation=true` 时，其 `reservationTimeOptions` 必须**完整展示**，缺项会导致用户无法预约。
8. **下单前必须 `calculate-price`**，把明细与总价展示给用户并取得明确确认，再调 `create-order`。禁止跳过算价直接下单。
9. **到店场景（`orderType=1`）下单必传 `takeWayCode`**，取值只能来自 `calculate-price` 返回的 `data.takeWayList[].code`（实测取值：`eat-in` / `take-in-store`）；外送/团餐（`orderType=2`）**不要传**（其算价返回**不含** `takeWayList`）。
10. **抽奖必须两段式**：先 `query-lottery-info` 展示 `drawDecision.nextConsumption`，用户明确确认后才可 `draw-lottery`。禁止试抽、自动抽、连续抽。
11. **业务成败看 `success` 字段**（仅适用于结构化返回）：工具调用不报错 ≠ 业务成功。响应 JSON 中 `success=false` 即失败（如 `60006 商品已售罄`、`600058 城市名为空`），须如实转述 `message`，不得改写或掩盖。
12. **返回有两种形态，别搞混**：
    - **结构化返回**（多数工具）：字段说明 + 原始 JSON，按字段取值。
    - **服务端已渲染的 Markdown**（实测 `available-coupons`、`query-my-coupons`、`campaign-calendar`）：**直接原样展示给用户**，不要试图解析字段、也没有 `success` 可判。空文本即视为无数据。