mcd-mcp-skills

麦当劳MCP平台集成，提供餐品营养查询、外送点餐、配送地址管理、优惠券管理、积分兑换等20个完整功能；当用户需要查询麦当劳餐品营养、下单外卖、管理地址、查询或领取优惠券、兑换积分商品时使用

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "mcd-mcp-skills" with this command: npx skills add moxin1044/mcd-mcp-skills

麦当劳MCP平台集成

任务目标

  • 本Skill用于：集成麦当劳MCP Server，提供完整的麦当劳服务访问能力
  • 能力包含：餐品营养信息查询、外送点餐全流程、地址管理、优惠券管理、积分账户管理、积分兑换、营销活动查询等20个功能
  • 触发条件：用户询问麦当劳餐品信息、想要点外卖、管理配送地址、查看或使用优惠券、查询或使用积分、了解营销活动等

前置准备

  • 依赖说明：脚本依赖已在运行环境预装，无需额外安装
  • 凭证配置：需要配置麦当劳MCP Token
    • 访问 https://open.mcd.cn 注册并创建应用获取Token
    • 系统已为您创建凭证配置入口，请按提示填写

操作步骤

一、餐品信息查询

1. 查询餐品营养信息

当用户询问麦当劳餐品的热量、营养成分时使用。

调用方式：

python scripts/mcd_mcp_client.py list-nutrition-foods

功能说明：

  • 获取麦当劳常见餐品的营养成分数据
  • 包括能量、蛋白质、脂肪、碳水化合物、钠、钙等信息
  • 可用于帮助用户搭配指定热量的套餐

2. 查询门店可售餐品列表

当用户想了解某个门店有哪些餐品时使用。

调用方式：

python scripts/mcd_mcp_client.py query-meals --store-code <门店编码> --be-code <BE编码>

必需参数：

  • --store-code: 门店编码（从配送地址查询获取）
  • --be-code: BE编码（从配送地址查询获取）

功能说明：

  • 查询指定门店可售卖的餐品菜单
  • 返回分类、餐品编码、标签等信息

3. 查询餐品详情

当用户想了解某个餐品的详细组成时使用。

调用方式：

python scripts/mcd_mcp_client.py query-meal-detail --meal-code <餐品编码>

必需参数：

  • --meal-code: 餐品编码（从餐品列表查询获取）

功能说明：

  • 查询餐品的详细信息
  • 包括套餐组成、默认选择等

二、配送地址管理

4. 查询用户配送地址列表

当用户需要查看或选择配送地址时使用。

调用方式：

python scripts/mcd_mcp_client.py delivery-query-addresses

功能说明：

  • 查询用户已创建的配送地址列表
  • 返回地址信息及对应门店信息（storeCode、beCode）
  • 用于后续点餐选择配送地址

5. 新增配送地址

当用户需要添加新的配送地址时使用。

调用方式：

python scripts/mcd_mcp_client.py delivery-create-address \
  --address "详细地址" \
  --lat "纬度" \
  --lng "经度" \
  --contact "联系人" \
  --phone "联系电话"

必需参数：

  • --address: 详细地址
  • --lat: 纬度
  • --lng: 经度
  • --contact: 联系人姓名
  • --phone: 联系电话

三、外送点餐流程

6. 查询门店可用优惠券

当用户点餐前想查看可用优惠时使用。

调用方式：

python scripts/mcd_mcp_client.py query-store-coupons --store-code <门店编码>

必需参数：

  • --store-code: 门店编码

功能说明：

  • 查询用户在当前门店下可使用的优惠券列表
  • 用于点餐时选择可用优惠

7. 商品价格计算

当用户选择商品后需要计算总价时使用。

调用方式：

python scripts/mcd_mcp_client.py calculate-price \
  --store-code <门店编码> \
  --be-code <BE编码> \
  --items '[{"mealCode":"餐品编码","quantity":1}]' \
  --coupons '["优惠券ID"]'

必需参数：

  • --store-code: 门店编码
  • --be-code: BE编码
  • --items: 商品列表（JSON格式）

可选参数：

  • --coupons: 优惠券ID列表（JSON格式）

功能说明：

  • 根据选购商品和优惠券计算价格
  • 返回商品金额、配送费、优惠金额及应付总价

8. 创建外送订单

当用户确认下单时使用。

调用方式：

python scripts/mcd_mcp_client.py create-order \
  --store-code <门店编码> \
  --be-code <BE编码> \
  --address-id <地址ID> \
  --items '[{"mealCode":"餐品编码","quantity":1}]' \
  --coupons '["优惠券ID"]'

必需参数：

  • --store-code: 门店编码
  • --be-code: BE编码
  • --address-id: 配送地址ID
  • --items: 商品列表（JSON格式）

可选参数：

  • --coupons: 优惠券ID列表

功能说明：

  • 创建外送订单
  • 返回订单详情与支付链接

9. 查询订单详情

当用户需要查看订单状态时使用。

调用方式：

python scripts/mcd_mcp_client.py query-order --order-id <订单ID>

必需参数：

  • --order-id: 订单ID

功能说明：

  • 查询订单状态、订单内容、配送信息等
  • 用于查看订单进度或确认订单信息

四、优惠券管理

10. 麦麦省券列表查询

当用户想查看当前可领取的优惠券时使用。

调用方式：

python scripts/mcd_mcp_client.py available-coupons

功能说明：

  • 查询麦麦省当前可领取的优惠券列表

11. 麦麦省一键领券

当用户想一次性领取所有可用优惠券时使用。

调用方式：

python scripts/mcd_mcp_client.py auto-bind-coupons

功能说明：

  • 自动领取麦麦省所有当前可用的麦当劳优惠券
  • 无需指定具体优惠券，系统自动领取所有可领的券

12. 我的优惠券查询

当用户想查看自己已有的优惠券时使用。

调用方式：

python scripts/mcd_mcp_client.py query-my-coupons

功能说明：

  • 查询用户可用的优惠券列表
  • 类似打开麦当劳App的"我的优惠券"页面
  • 显示所有可以用来点餐的优惠券

五、积分账户管理

13. 我的积分查询

当用户想查询积分余额时使用。

调用方式：

python scripts/mcd_mcp_client.py query-my-account

功能说明：

  • 查询用户积分账户信息
  • 包括可用积分、累计积分、冻结积分、即将过期积分等

六、积分商城兑换

14. 积分兑换商品列表

当用户想用积分兑换商品时使用。

调用方式：

python scripts/mcd_mcp_client.py mall-points-products

功能说明：

  • 查询麦麦商城内可用积分兑换的餐品券
  • 不包含积分兑换的实物或第三方码

15. 积分兑换商品详情

当用户想了解某个积分商品的详细信息时使用。

调用方式：

python scripts/mcd_mcp_client.py mall-product-detail --product-id <商品ID>

必需参数：

  • --product-id: 商品ID

功能说明：

  • 查询指定积分兑换商品券的详细信息
  • 包括图片、积分、有效期、说明、详情等

16. 积分兑换商品下单

当用户确认用积分兑换商品时使用。

调用方式：

python scripts/mcd_mcp_client.py mall-create-order --product-id <商品ID>

必需参数：

  • --product-id: 商品ID

功能说明：

  • 使用积分兑换指定餐品券
  • 完成积分扣减并发放券码
  • 返回兑换订单号与券码信息

七、营销活动

17. 活动日历查询

当用户想了解麦当劳的营销活动时使用。

调用方式：

python scripts/mcd_mcp_client.py campaign-calendar

功能说明：

  • 查询麦当劳中国当月的营销活动日历
  • 返回进行中、往期和未来日期的活动

八、工具辅助

18. 获取当前时间信息

获取当前时间，用于确定活动有效期、订单时间等。

调用方式：

python scripts/mcd_mcp_client.py now-time-info

功能说明：

  • 返回当前的完整时间信息
  • 用于了解当前时间和日期

资源索引

注意事项

  • 所有API调用需要有效的MCP Token，请确保凭证已正确配置
  • 门店编码（storeCode）和BE编码（beCode）需要从配送地址查询接口获取
  • 餐品编码（mealCode）需要从餐品列表查询接口获取
  • 创建订单前需要先查询配送地址、餐品列表、计算价格
  • 积分兑换会扣减积分，请提示用户确认后再操作
  • 所有JSON参数需使用单引号包裹，如：--items '[{"mealCode":"XXX","quantity":1}]'

使用示例

示例1：查询餐品营养信息

用户："帮我查一下麦当劳有哪些餐品的营养信息"

执行步骤：

  1. 调用营养信息查询工具
python scripts/mcd_mcp_client.py list-nutrition-foods
  1. 向用户展示营养数据，帮助用户了解各餐品的热量和营养成分

示例2：完成一次外送点餐

用户："我想在麦当劳点一个巨无霸套餐送到家"

执行步骤：

  1. 查询配送地址
python scripts/mcd_mcp_client.py delivery-query-addresses
  1. 查询门店可售餐品
python scripts/mcd_mcp_client.py query-meals --store-code XXX --be-code XXX
  1. 查询餐品详情（获取巨无霸套餐编码）
python scripts/mcd_mcp_client.py query-meal-detail --meal-code XXX
  1. 查询可用优惠券
python scripts/mcd_mcp_client.py query-store-coupons --store-code XXX
  1. 计算价格
python scripts/mcd_mcp_client.py calculate-price --store-code XXX --be-code XXX --items '[{"mealCode":"XXX","quantity":1}]'
  1. 创建订单
python scripts/mcd_mcp_client.py create-order --store-code XXX --be-code XXX --address-id XXX --items '[{"mealCode":"XXX","quantity":1}]'
  1. 向用户提供支付链接

示例3：领取并使用优惠券

用户："帮我领一下麦当劳的优惠券，然后看看我有哪些券"

执行步骤：

  1. 一键领取麦麦省优惠券
python scripts/mcd_mcp_client.py auto-bind-coupons
  1. 查询我的优惠券
python scripts/mcd_mcp_client.py query-my-coupons
  1. 向用户展示已领取的优惠券列表

示例4：积分兑换商品

用户："我想用积分兑换一个麦辣鸡腿堡，帮我看看需要多少积分"

执行步骤：

  1. 查询积分余额
python scripts/mcd_mcp_client.py query-my-account
  1. 查询积分兑换商品列表
python scripts/mcd_mcp_client.py mall-points-products
  1. 找到麦辣鸡腿堡对应的商品ID，查询详情
python scripts/mcd_mcp_client.py mall-product-detail --product-id XXX
  1. 向用户展示所需积分和商品详情
  2. 用户确认后，执行兑换
python scripts/mcd_mcp_client.py mall-create-order --product-id XXX

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Open Registry RecordOpen in ClawHub

Related Skills

Related by shared tags or category signals.

General

通义晓蜜 - 智能外呼

触发阿里云晓蜜外呼机器人任务，自动批量拨打电话。适用于批量外呼、客户回访、满意度调查、简历筛查约面试等场景。可从前置工具或节点获取外呼名单。

Registry SourceRecently Updated
2K0raven-xia
General

Letterboxd Watchlist

Scrape a public Letterboxd user's watchlist into a CSV/JSONL list of titles and film URLs without logging in. Use when a user asks to export, scrape, or mirror a Letterboxd watchlist, or to build watch-next queues.

Registry SourceRecently Updated
1.2K00xnuminous
General

Seedance Video Generation

Generate AI videos using ByteDance Seedance. Use when the user wants to: (1) generate videos from text prompts, (2) generate videos from images (first frame, first+last frame, reference images), or (3) query/manage video generation tasks. Supports Seedance 1.5 Pro (with audio), 1.0 Pro, 1.0 Pro Fast, and 1.0 Lite models.

Registry SourceRecently Updated
4.2K17jackycser
General

Universal Skills Manager

The master coordinator for AI skills. Discovers skills from multiple sources (SkillsMP.com, SkillHub, and ClawHub), manages installation, and synchronization...

Registry SourceRecently Updated
1.6K0jacob-bd