用途
这是连接中国大陆麦当劳官方 MCP 服务（mcd-mcp，https://mcp.mcd.cn）的非官方个人集成，仅限非商业用途。它可读取门店、菜单、券、积分、营养与订单，也能真实创建订单、兑换积分、领券和写入地址。优先使用已加载的 mcd-mcp 工具；若 MCP 被禁用、未加载或共享后端未继承环境变量，直接使用本技能的 CLI 回退。使用前先判断操作是否会产生外部状态变化。
主要能力
- 查询活动日历、麦麦省领券、我的券/积分、餐品营养热量、附近门店。
- 点餐全链路：选址→选店→菜单→算价→下单→查订单，覆盖麦乐送、到店自取、得来速、企业团餐。
- 麦麦商城积分兑换餐品券与实物商品及其订单查询。
使用方式
可选的全局 mcd 命令可从任意目录执行。命令只从环境变量 MCD_MCP_TOKEN 读取 Bearer token，不显示或保存它。若未创建全局软链接或 PATH 不可用，请在含有本 SKILL.md 的 Skill 目录使用规范相对回退路径 ./scripts/mcd，或使用该文件的完整路径。
常用命令：
mcd doctor
mcd tools
mcd schema query-meals
mcd call now-time-info --json
tools 默认读随 Skill 保存的实时快照；--live 查线上；--check 比较快照与线上；--sync 只会在线上仍是同一批准的 24 个工具名时原子更新快照。工具新增、删除或改名会拒绝同步，需先审查并更新本地批准集。schema TOOL [--live] 输出完整工具契约。call TOOL [JSON_ARGS] 默认展示服务原始 Markdown 信封，--json 提取其中的结构化业务 JSON。
安全边界
create-order、mall-create-order、auto-bind-coupons、delivery-create-address 都是写操作。仅在用户明确确认后才可追加 --confirm-write，否则命令必须在联网前拒绝。
创建点餐订单前，先执行 calculate-price；向用户逐项复述门店、餐品、数量、所用券和应付金额，获得一次明确确认后才可运行 create-order --confirm-write。
不臆造 storeCode、beCode、productCode、couponId、takeWayCode 或 gmServiceCode；它们必须来自上一步返回。
地址、手机号、券码和支付链接只在当前会话使用，不写入文件、Vault 或日志。
HTTP 200 不代表业务成功。响应内 success:false 仍是失败，命令会返回非零状态。
关键约定
| 场景 | beType | orderType | beCode | 还需传入 |
|---|---|---|---|---|
| 到店自取 | 1 | 1 | 不传 | takeWayCode |
| 麦乐送 | 2 | 2 | 必传 | addressId |
| 得来速 | 5 | 1 | 必传 | takeWayCode |
| 企业团餐 | 6 | 2 | 必传 | addressId、gmServiceCode |
预约才传 reservationDate（yyyy-MM-dd HH:mm），且后续菜单、餐品详情、可用券、算价、下单必须使用同一个值。calculate-price 的金额为分，向用户展示时除以 100；订单查询和创建订单的金额为元字符串。套餐或单品特制的 selectedKey / unselectedKey 规则见 tools.md。
最短业务流程
- 到店自取：query-nearby-stores → query-meals → calculate-price → 确认 → create-order → 交付 payH5Url。
- 麦乐送：delivery-query-addresses → delivery-query-stores → query-meals → calculate-price → 确认 → create-order → 交付 payH5Url。
- 得来速：按到店自取流程，但从门店返回开始持续携带 beCode。
- 企业团餐：按麦乐送流程，算价前加 query-meal-assistance，将选择的 gmServiceCode 传给算价和下单。
- 积分兑换：query-my-account → mall-points-products → mall-product-detail → 确认 → mall-create-order；每个商品单独创建并等待前一笔响应。
参考文档
- onboarding.md：申请 token、临时注入、密码管理器与 MCP 不可用时的处理。
- workflows.md：所有 24 个工具的用途和完整业务流程。
- tools.md：参数传递、金额、特制和展示规则。
- troubleshooting.md：鉴权、协议、限流和业务失败诊断。
- tools.json：来自实时 tools/list 的完整输入/输出 schema 与描述。
适用场景与限制
适用于中国大陆麦当劳的查询与点餐、积分兑换等操作。仅限非商业用途，属非官方个人集成。写操作必须经用户明确确认；敏感信息仅在当前会话使用。具体收费、价格、平台支持范围等资料未提供。