mcd-mcp-skills

# 麦当劳MCP平台集成 ## 任务目标 - 本Skill用于：集成麦当劳MCP Server，提供完整的麦当劳服务访问能力 - 能力包含：餐品营养信息查询、外送点餐全流程、地址管理、优惠券管理、积分账户管理、积分兑换、营销活动查询等20个功能 - 触发条件：用户询问麦当劳餐品信息、想要点外卖、管理配送地址、查看或使用优惠券、查询或使用积分、了解营销活动等 ## 前置准备 - 依赖说明：脚本依赖已在运行环境预装，无需额外安装 - 凭证配置：需要配置麦当劳MCP Token - 访问 https://open.mcd.cn 注册并创建应用获取Token - 系统已为您创建凭证配置入口，请按提示填写 ## 操作步骤 ### 一、餐品信息查询 #### 1. 查询餐品营养信息 当用户询问麦当劳餐品的热量、营养成分时使用。 **调用方式：** ```python python scripts/mcd_mcp_client.py list-nutrition-foods ``` **功能说明：** - 获取麦当劳常见餐品的营养成分数据 - 包括能量、蛋白质、脂肪、碳水化合物、钠、钙等信息 - 可用于帮助用户搭配指定热量的套餐 #### 2. 查询门店可售餐品列表 当用户想了解某个门店有哪些餐品时使用。 **调用方式：** ```python python scripts/mcd_mcp_client.py query-meals --store-code <门店编码> --be-code <BE编码> ``` **必需参数：** - `--store-code`: 门店编码（从配送地址查询获取） - `--be-code`: BE编码（从配送地址查询获取） **功能说明：** - 查询指定门店可售卖的餐品菜单 - 返回分类、餐品编码、标签等信息 #### 3. 查询餐品详情 当用户想了解某个餐品的详细组成时使用。 **调用方式：** ```python python scripts/mcd_mcp_client.py query-meal-detail --meal-code <餐品编码> ``` **必需参数：** - `--meal-code`: 餐品编码（从餐品列表查询获取） **功能说明：** - 查询餐品的详细信息 - 包括套餐组成、默认选择等 ### 二、配送地址管理 #### 4. 查询用户配送地址列表 当用户需要查看或选择配送地址时使用。 **调用方式：** ```python python scripts/mcd_mcp_client.py delivery-query-addresses ``` **功能说明：** - 查询用户已创建的配送地址列表 - 返回地址信息及对应门店信息（storeCode、beCode） - 用于后续点餐选择配送地址 #### 5. 新增配送地址 当用户需要添加新的配送地址时使用。 **调用方式：** ```python python scripts/mcd_mcp_client.py delivery-create-address \ --address "详细地址" \ --lat "纬度" \ --lng "经度" \ --contact "联系人" \ --phone "联系电话" ``` **必需参数：** - `--address`: 详细地址 - `--lat`: 纬度 - `--lng`: 经度 - `--contact`: 联系人姓名 - `--phone`: 联系电话 ### 三、外送点餐流程 #### 6. 查询门店可用优惠券 当用户点餐前想查看可用优惠时使用。 **调用方式：** ```python python scripts/mcd_mcp_client.py query-store-coupons --store-code <门店编码> ``` **必需参数：** - `--store-code`: 门店编码 **功能说明：** - 查询用户在当前门店下可使用的优惠券列表 - 用于点餐时选择可用优惠 #### 7. 商品价格计算 当用户选择商品后需要计算总价时使用。 **调用方式：** ```python 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 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 python scripts/mcd_mcp_client.py query-order --order-id <订单ID> ``` **必需参数：** - `--order-id`: 订单ID **功能说明：** - 查询订单状态、订单内容、配送信息等 - 用于查看订单进度或确认订单信息 ### 四、优惠券管理 #### 10. 麦麦省券列表查询 当用户想查看当前可领取的优惠券时使用。 **调用方式：** ```python python scripts/mcd_mcp_client.py available-coupons ``` **功能说明：** - 查询麦麦省当前可领取的优惠券列表 #### 11. 麦麦省一键领券 当用户想一次性领取所有可用优惠券时使用。 **调用方式：** ```python python scripts/mcd_mcp_client.py auto-bind-coupons ``` **功能说明：** - 自动领取麦麦省所有当前可用的麦当劳优惠券 - 无需指定具体优惠券，系统自动领取所有可领的券 #### 12. 我的优惠券查询 当用户想查看自己已有的优惠券时使用。 **调用方式：** ```python python scripts/mcd_mcp_client.py query-my-coupons ``` **功能说明：** - 查询用户可用的优惠券列表 - 类似打开麦当劳App的"我的优惠券"页面 - 显示所有可以用来点餐的优惠券 ### 五、积分账户管理 #### 13. 我的积分查询 当用户想查询积分余额时使用。 **调用方式：** ```python python scripts/mcd_mcp_client.py query-my-account ``` **功能说明：** - 查询用户积分账户信息 - 包括可用积分、累计积分、冻结积分、即将过期积分等 ### 六、积分商城兑换 #### 14. 积分兑换商品列表 当用户想用积分兑换商品时使用。 **调用方式：** ```python python scripts/mcd_mcp_client.py mall-points-products ``` **功能说明：** - 查询麦麦商城内可用积分兑换的餐品券 - 不包含积分兑换的实物或第三方码 #### 15. 积分兑换商品详情 当用户想了解某个积分商品的详细信息时使用。 **调用方式：** ```python python scripts/mcd_mcp_client.py mall-product-detail --product-id <商品ID> ``` **必需参数：** - `--product-id`: 商品ID **功能说明：** - 查询指定积分兑换商品券的详细信息 - 包括图片、积分、有效期、说明、详情等 #### 16. 积分兑换商品下单 当用户确认用积分兑换商品时使用。 **调用方式：** ```python python scripts/mcd_mcp_client.py mall-create-order --product-id <商品ID> ``` **必需参数：** - `--product-id`: 商品ID **功能说明：** - 使用积分兑换指定餐品券 - 完成积分扣减并发放券码 - 返回兑换订单号与券码信息 ### 七、营销活动 #### 17. 活动日历查询 当用户想了解麦当劳的营销活动时使用。 **调用方式：** ```python python scripts/mcd_mcp_client.py campaign-calendar ``` **功能说明：** - 查询麦当劳中国当月的营销活动日历 - 返回进行中、往期和未来日期的活动 ### 八、工具辅助 #### 18. 获取当前时间信息 获取当前时间，用于确定活动有效期、订单时间等。 **调用方式：** ```python python scripts/mcd_mcp_client.py now-time-info ``` **功能说明：** - 返回当前的完整时间信息 - 用于了解当前时间和日期 ## 资源索引 - MCP客户端脚本：见 [scripts/mcd_mcp_client.py](scripts/mcd_mcp_client.py) - 工具参数详细说明：见 [references/tools_reference.md](references/tools_reference.md) ## 注意事项 - 所有API调用需要有效的MCP Token，请确保凭证已正确配置 - 门店编码（storeCode）和BE编码（beCode）需要从配送地址查询接口获取 - 餐品编码（mealCode）需要从餐品列表查询接口获取 - 创建订单前需要先查询配送地址、餐品列表、计算价格 - 积分兑换会扣减积分，请提示用户确认后再操作 - 所有JSON参数需使用单引号包裹，如：`--items '[{"mealCode":"XXX","quantity":1}]'` ## 使用示例 ### 示例1：查询餐品营养信息 用户："帮我查一下麦当劳有哪些餐品的营养信息" **执行步骤：** 1. 调用营养信息查询工具 ```bash python scripts/mcd_mcp_client.py list-nutrition-foods ``` 2. 向用户展示营养数据，帮助用户了解各餐品的热量和营养成分 ### 示例2：完成一次外送点餐 用户："我想在麦当劳点一个巨无霸套餐送到家" **执行步骤：** 1. 查询配送地址 ```bash python scripts/mcd_mcp_client.py delivery-query-addresses ``` 2. 查询门店可售餐品 ```bash python scripts/mcd_mcp_client.py query-meals --store-code XXX --be-code XXX ``` 3. 查询餐品详情（获取巨无霸套餐编码） ```bash python scripts/mcd_mcp_client.py query-meal-detail --meal-code XXX ``` 4. 查询可用优惠券 ```bash python scripts/mcd_mcp_client.py query-store-coupons --store-code XXX ``` 5. 计算价格 ```bash python scripts/mcd_mcp_client.py calculate-price --store-code XXX --be-code XXX --items '[{"mealCode":"XXX","quantity":1}]' ``` 6. 创建订单 ```bash python scripts/mcd_mcp_client.py create-order --store-code XXX --be-code XXX --address-id XXX --items '[{"mealCode":"XXX","quantity":1}]' ``` 7. 向用户提供支付链接 ### 示例3：领取并使用优惠券 用户："帮我领一下麦当劳的优惠券，然后看看我有哪些券" **执行步骤：** 1. 一键领取麦麦省优惠券 ```bash python scripts/mcd_mcp_client.py auto-bind-coupons ``` 2. 查询我的优惠券 ```bash python scripts/mcd_mcp_client.py query-my-coupons ``` 3. 向用户展示已领取的优惠券列表 ### 示例4：积分兑换商品 用户："我想用积分兑换一个麦辣鸡腿堡，帮我看看需要多少积分" **执行步骤：** 1. 查询积分余额 ```bash python scripts/mcd_mcp_client.py query-my-account ``` 2. 查询积分兑换商品列表 ```bash python scripts/mcd_mcp_client.py mall-points-products ``` 3. 找到麦辣鸡腿堡对应的商品ID，查询详情 ```bash python scripts/mcd_mcp_client.py mall-product-detail --product-id XXX ``` 4. 向用户展示所需积分和商品详情 5. 用户确认后，执行兑换 ```bash python scripts/mcd_mcp_client.py mall-create-order --product-id XXX ```