mcdonalds-coupons

麦当劳优惠券助手

一项连接麦当劳中国 MCP Server 的技能，可帮助用户发现优惠、领取优惠券并管理优惠券钱包。

概述

此技能使用麦当劳官方 MCP（Model Context Protocol）服务来：

• 查询可用优惠券（麦麦省）
• 一键领取所有优惠券
• 查看活动日历
• 查看用户的优惠券钱包

Token 管理

检查是否存在 Token

首先，检查用户是否已配置 Token：

python scripts/token-manager.py list

没有 Token？引导用户获取

📝 首次使用需要 MCP Token

获取步骤:
1. 访问 https://open.mcd.cn/mcp
2. 点击右上角「登录」
3. 使用手机号验证登录
4. 点击「控制台」→「激活」
5. 复制生成的 Token

添加 Token:
python scripts/token-manager.py add <名称> <token>

示例:
python scripts/token-manager.py add personal 1kxNLFYT...

多 Token 管理

用户可以使用自定义昵称管理多个 Token：

# Add tokens - nickname can be anything user wants
python scripts/token-manager.py add 我自己 <token1>
python scripts/token-manager.py add 老妈 <token2>
python scripts/token-manager.py add 女朋友 <token3>

# List all tokens
python scripts/token-manager.py list
# Output:
# 🎫 已保存的 Token:
# ----------------------------------------
#   我自己: 1kxNLFYT...LuqJ ← 当前
#   老妈: 2abCDEFG...XyZ
#   女朋友: 3mnOPQRS...123
# ----------------------------------------

# Switch active token
python scripts/token-manager.py switch 老妈

# Remove a token
python scripts/token-manager.py remove 女朋友

存储位置： ~/.mcd-tokens.json（自动创建，权限为 600）

Token 会持久缓存——用户只需添加一次，之后即可随时使用。

快速参考

操作	MCP 工具	说明
列出可用优惠券	available-coupons	显示可领取的麦麦省优惠券
领取所有优惠券	auto-bind-coupons	一键领取所有优惠券
查看我的优惠券	my-coupons	用户已领取的优惠券钱包
查看促销活动	campaign-calender	当前和即将开始的活动
获取当前时间	now-time-info	用于有效期检查的服务端时间

实现方式

使用辅助脚本（推荐）

# Uses token from token manager automatically
python scripts/mcd-mcp.py available-coupons

# Or specify token directly
python scripts/mcd-mcp.py available-coupons <token>

直接发起 HTTP 调用

curl -X POST https://mcp.mcd.cn/mcp-servers/mcd-mcp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"available-coupons"}}'

解析响应

{
  "result": {
    "content": [{"type": "text", "text": "...coupon data..."}]
  }
}

提取文本：result.content[0].text

示例工作流

用户：「有什么麦当劳优惠？」

1. 检查是否存在 Token → 如果没有，引导用户添加
2. 调用 available-coupons
3. 展示优惠券及价格
4. 询问是否要领取全部优惠券

用户：「帮我领券」/「一键领取」

1. 调用 auto-bind-coupons
2. 告知成功领取的数量
3. 提醒优惠券的到期日期

用户：「切换到我妈的账号领券」

1. 运行 python scripts/token-manager.py switch 老妈
2. 然后调用 auto-bind-coupons
3. 确认：「已用「老妈」的账号领取了 X 张券」

用户：「帮我把女朋友的麦当劳加进来」

1. 引导用户从 https://open.mcd.cn/mcp 获取 Token
2. 询问用户昵称：「你想给这个账号起什么名字？」
3. 运行 python scripts/token-manager.py add <用户起的名字> <token>
4. 确认添加成功

回复风格

展示优惠券信息时：

• 使用食物表情符号（🍔🍟🍗）
• 突出显示价格和优惠金额
• 按类别分组
• 标注到期日期
• 显示当前使用的账号（如果有多个）

常见问题

问题	解决方案
401 Unauthorized	Token 无效或已过期，请获取新的 Token
429 Too Many Requests	达到速率限制（600 次/分钟），请稍后重试
未配置 Token	引导用户使用 token-manager.py add 添加 Token
账号错误	使用 token-manager.py switch

速率限制

• 每个 Token 每分钟最多 600 次请求
• 每个 Token 相互独立（可并行使用多个账号）