核心用法
mcd-cn 是一款面向麦当劳中国 MCP(Marketing Campaign Platform)的命令行工具,主打优惠券与活动日历的便捷查询。默认输出为人类可读格式,附加 --json 标志可切换为机器解析格式,便于脚本自动化。
主要功能模块:
- 活动日历 (
campaign-calender):查看当期营销活动,支持指定日期 (--specifiedDate yyyy-MM-dd) - 优惠券管理:查询可领券 (
available-coupons)、自动领取 (auto-bind-coupons)、查看已领券 (my-coupons) - 辅助信息:获取当前时间 (
now-time-info)
配置方式: 通过 MCDCN_MCP_TOKEN 环境变量或 .env 文件注入令牌,可选自定义服务器地址 MCDCN_MCP_URL。
显著优点
1. 双模输出:默认人类友好,JSON 模式无缝衔接 CI/CD 或定时任务
2. 自动化友好:auto-bind-coupons 支持一键批量领券,降低手动操作成本
3. 安装便捷:Homebrew 一键安装,跨平台兼容 macOS/Linux
4. 限频合理:600 RPM 对个人用户及轻量脚本充足
潜在缺点与局限性
- 令牌获取门槛:需从麦当劳中国 MCP 控制台手动获取,无 OAuth 等标准授权流程
- 地域锁定:仅限中国大陆麦当劳体系,境外账号不可用
- 功能边界:仅覆盖优惠券与日历,不支持点餐、支付等交易环节
- CLI 依赖:非图形化工具,普通用户需具备终端基础
适合人群
- 技术型麦当劳用户,希望自动化追踪优惠券
- 羊毛党/省钱博主,需要批量查询与领取
- 开发者集成到个人效率工作流(如每日定时推送到企业微信/钉钉)
常规风险
- 令牌泄露:
MCDCN_MCP_TOKEN为长期有效凭证,若泄露可能导致账号被滥用领券 - Rate Limit 触发:高频脚本需自行实现退避逻辑,避免 600 RPM 触顶
- 接口变更:非官方 McDonald's 官方维护的 MCP 封装,接口调整可能导致工具失效
- 合规灰色地带:自动领券可能违反平台服务条款,存在账号限制风险