一个基于 麦当劳中国官方 MCP 服务（https://mcp.mcd.cn）的 WorkBuddy Skill，
帮你把一顿麦当劳点到最便宜：查附近门店 → 查券 → 配菜单 → 带券算价 → 比价推荐。
本 Skill 只做「省钱比价」，默认不下单、不自动领券；任何写操作（领券 / 下单）都需你明确确认。
- 🏪 选门店：按地址查附近麦当劳，拿到
storeCode、距离、营业状态 - 🎟️ 查券：门店可用券（
query-store-coupons，含couponId与适用商品）、账户券、麦麦省可领券 - 🍔 配菜单：拉取门店在售菜单，支持套餐拆解与替换（
query-meal-detail） - 🧮 带券算价：调用官方
calculate-price计算真实原价 / 优惠 / 应付 - 💡 比价推荐：本地求解器缩窄候选组合，给出最便宜方案与「省了多少」
- 带券算价的
couponId只能来自query-store-coupons；query-my-coupons/available-coupons不返回couponId，不能直接喂calculate-price。 calculate-price的discount是相对券原价口径，不等于菜单促销价口径。真实省钱 = 菜单原价合计 −payableTotal。- 价格单位：
query-meals为「元」（字符串）；calculate-price金额为「分」，展示 ÷100。 - 限流：每 Token 600 次 / 分钟，超限返回
429。
更完整的坑位清单见 references/coupon_price_guide.md。
- 打开 麦当劳 MCP 开放平台
- 右上角【登录】→ 手机号验证登录
- 进入【控制台】→ 点击激活 → 申请 MCP Token → 复制
Token 相当于服务访问凭证，切勿提交到公开仓库或出现在截图里。
打开 WorkBuddy「管理连接器」→ 自定义配置，加入（参考 mcp-config.example.json）：
{
"mcpServers": {
"mcd-mcp": {
"type": "streamablehttp",
"url": "https://mcp.mcd.cn",
"headers": {
"Authorization": "Bearer ${MCD_MCP_TOKEN}"
}
}
}
}- 客户端支持环境变量插值时，先
export MCD_MCP_TOKEN=你的Token；不支持则把占位符替换为真实 Token（并确保该配置文件不进版本库）。 - 添加后手动启用连接器，否则工具不可用。
将本仓库作为用户级或项目级 Skill 放入：
- 用户级：
~/.workbuddy/skills/mcd-coupon-assistant/ - 项目级：
<项目>/.workbuddy/skills/mcd-coupon-assistant/
放入后，直接在对话里说：
「帮我用券点一份巨无霸套餐加麦辣鸡翅，怎么最便宜？」
Skill 会自动走查门店 → 查券 → 算价 → 推荐 的完整链路。
echo '{"items":[{"code":"P1","name":"巨无霸套餐","price":39.5}],
"coupons":[{"couponId":"C1","title":"省5元","products":["P1"]}]}' \
| python references/coupon_solver.pymcd-coupon-assistant/
├── SKILL.md # Skill 主体：触发条件、调用链路、安全规则
├── README.md # 本文件
├── MCP_INTEGRATION.md # MCP 接入与工具清单、调用流程
├── mcp-config.example.json # MCP 连接器配置示例（Token 用环境变量）
├── references/
│ ├── mcd-tools.md # 麦当劳 MCP 工具速查（优惠券方向）
│ ├── coupon_price_guide.md # 算价边界与坑位清单
│ └── coupon_solver.py # 本地候选组合求解器
├── .gitignore
└── LICENSE
- 遵守麦当劳中国《使用条款》及《麦当劳 MCP 服务规则》。
- 允许个人以非商业用途复制使用示例配置 / 代码，仅限连接与使用麦当劳 MCP 服务。
- 未经书面授权，不得用于商业售卖、付费分发、引流变现或暗示官方背书。
- 本项目不构成对麦当劳及其关联方商标的任何授权。
本项目形态为「WorkBuddy Skill + 麦当劳 MCP」，可参加「麦当劳程序员创意开发大赛」：