麦当劳优惠券查询服务

麦当劳中国MCP集成示例项目,提供麦当劳优惠券和活动查询功能,包括查询活动日历、可领取优惠券、一键领取优惠券及查询已领取优惠券。

  • by sawzhang
  • 本地部署
  • 更新于
在 GitHub 查看 alexzhang2015/mcd_mcp

使用说明

McDonald's MCP Demo

麦当劳中国 MCP (Model Context Protocol) 集成示例项目,为 Claude Code 提供麦当劳优惠券和活动查询能力。

功能

  • 查询麦当劳活动日历
  • 查询可领取的优惠券
  • 一键领取所有优惠券
  • 查询已领取的优惠券

快速开始

1. 获取 MCP Token

  1. 访问 https://open.mcd.cn/mcp/doc
  2. 点击右上角【登录】,使用手机号验证登录
  3. 登录后点击【控制台】
  4. 点击激活按钮,申请 MCP Token
  5. 复制生成的 Token

2. 配置 MCP

编辑 .mcp.json,将 YOUR_MCP_TOKEN 替换为你的 Token:

{
  "mcpServers": {
    "mcd-mcp": {
      "type": "http",
      "url": "https://mcp.mcd.cn/mcp-servers/mcd-mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

3. 重启 Claude Code

配置完成后,重启 Claude Code 以加载 MCP 服务器。

使用方式

Slash 命令

命令 说明
/mcd 麦当劳 MCP 通用助手
/mcd-activities 查询活动日历
/mcd-coupons 查询可领取的优惠券
/mcd-claim 一键领取所有优惠券
/mcd-my-coupons 查询我的优惠券

自然语言 (Skills)

直接用中文提问,Claude 会自动识别并调用相应工具:

  • "麦当劳有什么活动?"
  • "有什么券可以领?"
  • "帮我一键领券"
  • "我有哪些优惠券?"

MCP 工具

工具名称 说明
campaign-calender 查询当月营销活动日历
available-coupons 查询麦麦省可领取的优惠券
auto-bind-coupons 自动领取所有可用优惠券
my-coupons 查询已领取的优惠券
now-time-info 获取当前服务器时间

项目结构

.
├── .mcp.json                       # MCP 服务器配置
├── .claude/
│   ├── settings.json               # Claude Code 设置
│   ├── commands/                   # Slash 命令 (显式触发)
│   │   ├── mcd.md
│   │   ├── mcd-activities.md
│   │   ├── mcd-coupons.md
│   │   ├── mcd-claim.md
│   │   └── mcd-my-coupons.md
│   └── skills/                     # Skills (自然语言触发)
│       ├── mcd/SKILL.md
│       ├── mcd-activities/SKILL.md
│       ├── mcd-coupons/SKILL.md
│       ├── mcd-claim/SKILL.md
│       └── mcd-my-coupons/SKILL.md
├── CLAUDE.md                       # Claude Code 项目指南
└── README.md

注意事项

  • MCP Token 代表你的麦当劳会员身份,请勿分享
  • 每个 Token 每分钟最多 600 次请求
  • 需要 Claude Code 支持 HTTP 协议的 MCP 服务器

相关链接

License

MIT