麦麦活动雷达 Skill 技能

技能简介

麦麦活动雷达（McEvent Radar）是基于麦当劳官方 MCP 的 WorkBuddy Agent Skill，也是麦当劳程序员创意开发大赛的参赛作品。一句话问出去——「附近有什么麦麦活动」——它先跟你确认城市，再用官方接口实时扫描未来两周的场次，最后回来一张卡通活动地图：门店小屋站在麦当劳官方给的真实经纬度上，活动卡片里只装官方接口确认还有名额的场次。北京实测一轮可扫出 620 个场次、11 类活动、10 家门店。

核心能力

1. 官方 MCP 实时核验：商品、城市、门店、日期、场次五级核实链全部走麦当劳官方接口，620 这类数字是接口实时返回，不是模型记忆。
2. 卡通活动地图：门店小屋用官方经纬度直接投影，街道名取自官方地址字段，点活动类型的色标即可一键筛选。
3. 数据诚实红线：查不到就说查不到并说明已查范围；只有场次接口明确返回有名额才标「可预约」；价格展示原始值并做运行时单位核验，核验不过不换算；门店无坐标就进「示意车道」并注明。
4. 导出日历：筛选结果可导出 .ics 文件直接导入手机日历，官方没给时间的场次如实标成全天事件。
5. 门控预约：默认只查询；真要预约时把活动、门店、日期、场次、人数、费用全部列出，你逐项点头后才动手，付款仍在麦当劳官方流程内完成。
6. 键盘与无障碍：门店小屋支持 Tab 聚焦与回车筛选，系统开启「减少动态效果」时自动关掉动画。

安装配置

• 对话安装（推荐）：把安装指令发给 WorkBuddy，它会自动下载、把 skill/mcd-event-radar 复制到 ~/.workbuddy/skills/、确认 SKILL.md 存在并提示重开会话。
• 图形界面：下载仓库内 dist/mcd-event-radar-skill.zip，在 WorkBuddy「技能 → 添加技能 → 上传技能」里导入。
• 命令行：Windows 用 irm .../install.ps1 | iex，macOS/Linux 用 curl -fsSL .../install.sh | bash；重复运行即更新。
• Token 配置：首次使用会给你 1 分钟的官方 Token 申请指引（open.mcd.cn/mcp/doc），粘贴进对话即可，它自动备份、在线验证、绝不外传。

使用步骤

1. 安装技能后新开一轮会话。
2. 说一句「查附近的活动」。
3. 确认城市（支持自动定位，VPN 用户直接报城市名更稳）。
4. 等它完成官方 MCP 扫描，返回卡通活动地图与可预约卡片。
5. 点日期或色标筛选，选中场次后按提示确认预约。

适用场景

• 有娃家庭周末找就近的生日派对、读书会并确认还有名额。
• 活动型麦门查找「麦麦奇妙夜」这类主题活动的时间与距离。
• 想要地图直观呈现而非一堵文字墙的附近党。
• 需要在预约前看清活动、门店、场次、费用与名额依据的谨慎型用户。

适用人群：麦当劳常客、带娃家庭、本地活动爱好者，以及想把 MCP 接进日常助理的 WorkBuddy 用户。

工作原理：采用「Agent 编排 + 确定性脚本」架构。连接器自检、实时查询、坐标投影、价格核验这些数字链全部钉在零依赖 Node.js 脚本里，LLM 只负责理解需求、执行流程与守护确认门控。场次价格的原始值单位是分，运行时用商城同商品价格交叉核实倍率（实测 11/11 恒为 ×100），对不上就自动回退显示「单位待核实」。在线演示地图使用虚构数据且页面明确标注，门店相对位置仍是真实经纬度投影。

官方链接：GitHub 仓库 https://github.com/Zafer-Liu/mcd-event-radar ；介绍主页 https://app-ezf35mw5oq9t.miaoda.online ；在线演示地图 https://app-ezf35mw5oq9t.miaoda.online/map （MIT 协议，非麦当劳官方产品）。