麦当劳MCP自动化工具
🍟 麦当劳接口自动化工具，自动领券、查库存、算优惠、一键下单。
功能特性
✅ 每日自动领取当日可用优惠券
✅ 查询附近任意门店的产品库存
✅ 自动计算最优优惠组合，最大化省钱
✅ 支持一键下单到店取餐
✅ 多账号管理，全家共用
✅ 优惠券过期提醒，不浪费任何优惠
环境要求
- curl (默认系统自带)
- jq (JSON解析工具，
brew install jq或apt install jq安装)
快速开始
1. 获取Token
打开麦当劳App，抓包获取请求头中的MCD_TOKEN，或使用登录接口获取。
2. 配置Token
export MCD_TOKEN="你的MCD_TOKEN"
3. 常用命令
# 领取今日优惠券
./mcd-cli.sh coupon:receive
# 查询附近门店库存
./mcd-cli.sh store:stock --city "北京" --keyword "麦辣鸡腿堡"
# 计算最优优惠组合
./mcd-cli.sh order:calculate --items "麦辣鸡腿堡,薯条,可乐"
# 一键下单
./mcd-cli.sh order:place --store-id "12345" --items "麦辣鸡腿堡,薯条,可乐"
配置说明
| 环境变量 | 说明 | 默认值 |
|---|---|---|
| MCD_TOKEN | 麦当劳接口Token | 必填 |
| MCD_CITY | 默认城市 | 自动定位 |
| MCD_STORE_ID | 默认门店ID | 自动选择最近门店 |
| MCD_NOTIFY_URL | 优惠提醒通知地址 | 无 |
避坑指南（实战总结）
- 接口地址正确格式：✅ 正确：POST到
https://mcp.mcd.cn/（根地址），使用JSON-RPC 2.0协议调用；❌ 错误：不要调用/v1/xxx这类RESTful路径，会返回404 - 调用方式正确格式：所有业务接口都通过
tools/call方法调用，参数为工具名称和参数，不要直接调用业务路径 - 商品编码必查：下单前必须先调用
query-meals获取真实商品编码和对应名称，禁止凭记忆猜编码，避免下错单 - 优惠券ID必查：优惠券ID从
query-my-coupons或query-store-coupons获取，禁止直接填优惠券名称，会导致优惠无法使用 - 下单前置检查：创建订单前必须先调用
calculate-price确认价格、商品、优惠是否正确，再提交订单 - Token有效期：用户账号Token有效期为24小时~7天，无需频繁刷新，返回401再重新获取
- 调用频率：接口调用间隔至少2秒，单日调用不超过200次，避免风控
- 风控处理：如果被限制访问，等待24小时自动解封，或更换账号
- 库存查询：部分三四线城市门店不支持库存查询，自动降级为仅显示优惠券
定时任务配置
每天早上8点自动领取优惠券：
0 8 * * * export MCD_TOKEN="你的Token" && /path/to/mcd-cli.sh coupon:receive
项目地址
GitHub: https://github.com/yourname/mcd-mcp 文档: https://docs.example.com/mcd-mcp