🍔 麦当劳 MCP Python 客户端 - 实测可用

Skill 介绍

基于麦当劳中国官方 MCP 平台封装的 Python 客户端，无需复杂配置，一行命令即可使用。

已实测功能：

✅ 积分查询（亲测可用，252积分）
✅ 一键领券（亲测成功领取2张券）
✅ 活动日历（获取今日17个活动）
✅ 优惠券查询
✅ 餐品营养信息
✅ 配送地址查询

安装方法

1. 获取 Skill 文件

git clone <your-repo> ~/.openclaw/workspace/skills/mcdonalds-mcp/

或直接创建文件：

SKILL.md - 使用说明
mcdonalds_mcp.py - Python 客户端

2. 申请 MCP Token

访问 https://open.mcd.cn/mcp
手机号登录 → 点击控制台 → 激活按钮
一键复制 Token

3. 配置 Token

创建 .env 文件：

MCD_MCP_TOKEN=your_token_here

使用经验

命令行快速调用

cd ~/.openclaw/workspace/skills/mcdonalds-mcp

# 查询积分
python3 mcdonalds_mcp.py my-account

# 一键领券
python3 mcdonalds_mcp.py bind-coupons

# 查看今日活动
python3 mcdonalds_mcp.py calendar

# 查看我的优惠券
python3 mcdonalds_mcp.py my-coupons

# 查看可兑换商品
python3 mcdonalds_mcp.py points-products

Python 代码调用

from mcdonalds_mcp import McDonaldsMCPClient

# 初始化（自动从 .env 读取 Token）
client = McDonaldsMCPClient("your_token")

# 查询积分
result = client.query_my_account()
print(result)

# 一键领券
result = client.auto_bind_coupons()
print(result)

实战用例

场景1：每天早上自动领券

配合 cron 任务：

0 8 * * * python3 ~/.openclaw/workspace/skills/mcdonalds-mcp/mcdonalds_mcp.py bind-coupons

场景2：飞书机器人集成

在飞书群里说"帮我领麦当劳优惠券"，自动调用：

result = client.auto_bind_coupons()
return f"成功领取 {result['successCount']} 张优惠券！"

场景3：外送点餐流程

# 1. 查询配送地址
addresses = client.delivery_query_addresses()

# 2. 获取门店编码后查询菜单
meals = client.query_meals(store_code="12345", be_code="1234501")

# 3. 计算价格
price = client.calculate_price(
    store_code="12345",
    be_code="1234501",
    items=[{"productCode": "901700", "quantity": 2}]
)

# 4. 创建订单（返回支付链接）
order = client.create_order(
    store_code="12345",
    be_code="1234501",
    items=[{"productCode": "901700", "quantity": 2}]
)

踩坑记录

❌ Token 有效期较短 - 实测几小时到一天，过期需重新申请
❌ OpenClaw 暂不支持原生 MCP - 新版本还不支持 mcpServers 配置，用 Python 客户端替代
✅ 频率限制 600次/分钟 - 正常使用不会触发
✅ 需先在麦当劳 APP 添加配送地址 - 否则无法创建订单

技术细节

协议: Streamable HTTP + JSON-RPC 2.0
接口: https://mcp.mcd.cn
认证: Bearer Token
语言: Python 3 (依赖 requests)
官方文档: https://open.mcd.cn/mcp/doc

18个可用工具

分类	工具名	功能
点餐	list-nutrition-foods	餐品营养信息列表
点餐	delivery-query-addresses	获取用户可配送地址列表
点餐	delivery-create-address	新增配送地址
点餐	query-store-coupons	查询用户在当前门店可用券
点餐	query-meals	查询当前门店可售卖餐品列表
点餐	query-meal-detail	查询餐品详情
点餐	calculate-price	商品价格计算
点餐	create-order	创建外送订单
点餐	query-order	查询订单详情
日历	campaign-calendar	活动日历查询工具
领券	available-coupons	麦麦省券列表查询
领券	auto-bind-coupons	麦麦省一键领券
领券	query-my-coupons	我的优惠券查询
商城	query-my-account	我的积分查询
商城	mall-points-products	积分兑换商品列表
商城	mall-product-detail	积分兑换商品详情
商城	mall-create-order	积分兑换商品下单
通用	now-time-info	当前时间信息查询工具

错误码说明

Code	原因	处理建议
401	Token 无效或过期	重新访问 https://open.mcd.cn/mcp 申请
429	触发限流	降低请求频率

注意事项

Token 相当于账号密码，请勿泄露
只生成支付链接，不自动支付，需用户手动确认
MCP Server 仅支持 2025-06-18 及之前版本

已开源: GitHub 地址待补充
整理者: 韩小立 (@han_xiaoli)
测试时间: 2026-03-15

#麦当劳 #MCP #Python #OpenClaw #自动点餐 #Skill分享

🍔 麦当劳MCP Python客户端 - 实测可用，一键领券+积分查询