McDonald's MCP Demo
麦当劳中国 MCP (Model Context Protocol) 集成示例项目,为 Claude Code 提供麦当劳优惠券和活动查询能力。
功能
- 查询麦当劳活动日历
- 查询可领取的优惠券
- 一键领取所有优惠券
- 查询已领取的优惠券
快速开始
1. 获取 MCP Token
- 访问 https://open.mcd.cn/mcp/doc
- 点击右上角【登录】,使用手机号验证登录
- 登录后点击【控制台】
- 点击激活按钮,申请 MCP Token
- 复制生成的 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
