麦当劳中国 MCP
这是连接中国大陆麦当劳官方 MCP 服务的非官方个人集成,仅限非商业用途。它可读取门店、菜单、券、积分、营养与订单,也能真实创建订单、兑换积分、领券和写入地址。优先使用已加载的 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 与描述。