mcd-cn

麦当劳助手 - 查询/领取优惠券、活动日历、餐品营养信息、门店查询

MIT-0 · Free to use, modify, and redistribute. No attribution required.
0 · 1k · 0 current installs · 0 all-time installs
byhiyu@hi-yu
duplicate of @hi-yu/mcdonald
MIT-0
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Suspicious
medium confidence
Purpose & Capability
The name/description (McDonald's helper: coupons, calendar, nutrition, store lookup) aligns with the operations in SKILL.md (curl calls to mcp.mcd.cn). However, the registry metadata reported 'Required env vars: none' while the SKILL.md requires an API token (MCD_TOKEN); that mismatch is unexpected and should be explained.
Instruction Scope
Instructions are explicit and limited to POSTing JSON-RPC calls to the MCP endpoint (mcp.mcd.cn) via curl and parsing responses. They do not instruct reading unrelated files or system state. One action (auto-bind-coupons) is state-changing (will attempt to claim coupons into the user account) — this is within the described domain but requires explicit user consent because it performs account actions.
Install Mechanism
No install spec and no code files are provided (instruction-only). This minimizes on-disk risk; the skill relies on curl being available at runtime.
!
Credentials
The SKILL.md requires an API credential (MCD_TOKEN) and an optional MCD_MCP_URL, which are proportionate to the stated purpose. However, the skill registry metadata claims no required environment variables — that inconsistency is concerning because a required credential is not declared in the registry. Users should be warned before supplying tokens.
Persistence & Privilege
The skill does not request permanent/always-on presence and does not modify other skills or system-wide settings. Autonomous invocation is permitted by default but not combined with other privilege escalations here.
What to consider before installing
This skill appears to do what it says (call McDonald's MCP API) but has two issues you should consider before installing: (1) SKILL.md requires you to provide an MCD_TOKEN for your account, yet the registry metadata did not declare any required env vars — confirm with the publisher why the registry omits this. (2) The 'auto-bind-coupons' tool is state-changing and will perform actions in your account if the skill is allowed to run; do not enable autonomous execution of state-changing commands without explicit user consent. Additional recommendations: only provide the minimum-scoped token the service supports (avoid sharing full-account credentials), verify the MCP endpoint (https://mcp.mcd.cn) is legitimate, avoid pasting the token into public chats, consider requiring manual confirmation for coupon-claiming operations, and be mindful of rate limits and privacy implications.

Like a lobster shell, security has layers — review code before you run it.

Current versionv1.0.0
Download zip
latestvk97302q6gt1k389d32kra93hrh80j1qm

License

MIT-0
Free to use, modify, and redistribute. No attribution required.

Runtime requirements

🍔 Clawdis

SKILL.md

🍔 麦当劳助手

当用户询问麦当劳相关问题时,使用此 skill 调用麦当劳 MCP 服务获取实时数据。

适用场景

  • 查询/领取优惠券
  • 查看活动日历
  • 查询餐品营养信息
  • 搭配指定热量套餐

配置要求

必需配置

用户需要在 MCP 官网注册并获取 API Token:

  • 访问 https://mcp.mcd.cn 获取 Token
  • 设置环境变量 MCD_TOKEN 或在调用时替换 <YOUR_TOKEN>

可选配置

  • MCD_MCP_URL: MCP 服务地址,默认 https://mcp.mcd.cn

调用方式

使用 exec 工具执行 curl 命令调用 MCP 服务:

MCD_URL="${MCD_MCP_URL:-https://mcp.mcd.cn}"
MCD_AUTH="Authorization: Bearer ${MCD_TOKEN:-<YOUR_TOKEN>}"

curl -s -X POST "$MCD_URL" \
  -H "$MCD_AUTH" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"<工具名>","arguments":{<参数>}},"id":1}'

可用工具

1. 查询可领优惠券 (available-coupons)

查看当前可领取的所有优惠券。

触发词: "有什么优惠券"、"可以领什么券"、"今天有什么优惠"

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

2. 一键领取优惠券 (auto-bind-coupons)

自动领取所有可用优惠券到账户。

触发词: "帮我领券"、"一键领券"、"全部领取"

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

3. 查询我的优惠券 (my-coupons)

查看已领取的优惠券列表。

触发词: "我有哪些优惠券"、"我的券"、"已领取的券"

参数:

  • page: 页码,默认 "1"
  • pageSize: 每页数量,默认 "50"
curl -s -X POST "${MCD_MCP_URL:-https://mcp.mcd.cn}" \
  -H "Authorization: Bearer ${MCD_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"my-coupons","arguments":{"page":"1","pageSize":"50"}},"id":1}'

4. 查询活动日历 (campaign-calender)

查看近期麦当劳活动安排。

触发词: "最近有什么活动"、"麦当劳活动"、"促销活动"

curl -s -X POST "${MCD_MCP_URL:-https://mcp.mcd.cn}" \
  -H "Authorization: Bearer ${MCD_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"campaign-calender","arguments":{}},"id":1}'

5. 查询餐品营养信息 (list-nutrition-foods)

获取麦当劳常见餐品的营养成分数据,包括能量、蛋白质、脂肪、碳水化合物、钠、钙等信息。适用于用户咨询热量、营养或搭配指定热量套餐。

触发词: "热量"、"卡路里"、"营养信息"、"多少大卡"、"帮我搭配XX卡的套餐"

curl -s -X POST "${MCD_MCP_URL:-https://mcp.mcd.cn}" \
  -H "Authorization: Bearer ${MCD_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"list-nutrition-foods","arguments":{}},"id":1}'

6. 获取当前时间 (now-time-info)

返回当前的完整时间信息,帮助判断活动是否在有效期内。

触发词: "现在几点"、"今天几号"(通常无需用户触发,AI 自动调用以判断活动时效)

curl -s -X POST "${MCD_MCP_URL:-https://mcp.mcd.cn}" \
  -H "Authorization: Bearer ${MCD_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"now-time-info","arguments":{}},"id":1}'

响应处理

成功响应

{
  "jsonrpc": "2.0",
  "result": {
    "content": [{"type": "text", "text": "..."}],
    "structuredContent": {...}
  },
  "id": 1
}

解析 result.content[0].textresult.structuredContent 获取数据。

错误响应

{
  "jsonrpc": "2.0",
  "error": {"code": -32000, "message": "Token expired"},
  "id": 1
}

常见错误:

  • Token expired: Token 过期,需要重新获取
  • Unauthorized: Token 无效
  • Rate limited: 请求过于频繁,稍后再试

输出格式建议

优惠券列表

以表格或清单形式展示,包含:

  • 优惠券名称
  • 优惠金额/折扣
  • 有效期
  • 使用条件

营养信息

以表格展示,包含:

  • 餐品名称
  • 热量 (kcal)
  • 蛋白质 (g)
  • 脂肪 (g)
  • 碳水化合物 (g)

使用示例

用户: 今天麦当劳有什么优惠券可以领?

AI 执行:

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

AI 回复:

当前可领取的优惠券:

  1. 🍟 麦辣鸡腿堡套餐立减5元 (有效期至2月10日)
  2. 🥤 任意饮品第二杯半价 (有效期至2月15日) ...

需要帮你一键领取吗?

注意事项

  1. Token 安全: 不要在公开场合暴露用户的 MCD_TOKEN
  2. 频率限制: 避免短时间内大量请求
  3. 数据时效: 优惠券和活动信息实时变化,建议用户及时查询
  4. 热量搭配: 使用营养信息帮用户搭配套餐时,注意计算总热量

更新日志

  • v1.0.0: 初始版本,支持优惠券、活动、营养、门店查询

Files

1 total
Select a file
Select a file to preview.

Comments

Loading comments…