Skip to content
Back to search

mcd-event-radar

麦当劳 MCP Agent Skill:查「附近有什么麦麦活动」,生成卡通活动地图——门店位置取自官方经纬度,只展示已核实可预约场次 🍟

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zafer-liu--mcd-event-radar/badge.svg)](/listings/zafer-liu--mcd-event-radar)

HTML

<a href="/listings/zafer-liu--mcd-event-radar"><img src="/api/listings/zafer-liu--mcd-event-radar/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 240 lines · 2 findings marked

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="images/map-preview.png" width="880" alt="麦麦活动地图 · 北京实测效果" />
  3. # 🍟 麦麦活动雷达 · McEvent Radar
  4. **「这个周末,附近哪家麦麦有生日派对?哪家读书会还有名额?」**
  5. 一句话问出去,回来一张**卡通活动地图**——门店小屋站在麦当劳官方给的真实经纬度上,
  6. 活动卡片里只装**官方亲口确认还有名额**的场次。
  7. <br>
  8. [![MCP](https://img.shields.io/badge/MCD--MCP-35%20tools-DA291C.svg)](MCP_INTEGRATION.md)
  9. [![Skill](https://img.shields.io/badge/WorkBuddy-Skill-FFC72C.svg)](skill/mcd-event-radar/SKILL.md)
  10. [![Live Tested](https://img.shields.io/badge/realtime--verified-620%20sessions%20%C2%B7%20BJ-brightgreen.svg)](MCP_INTEGRATION.md#在线验证记录2026-10-09真实-token)
  11. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
  12. [![Live Demo](https://img.shields.io/badge/live--demo-online-blueviolet.svg)](https://app-ezf35mw5oq9t.miaoda.online/map)
  13. **🌐 [项目介绍主页](https://app-ezf35mw5oq9t.miaoda.online) · [在线演示地图(免安装,浏览器直接玩)](https://app-ezf35mw5oq9t.miaoda.online/map)**
  14. *麦当劳程序员创意开发大赛参赛作品 · 基于麦当劳 MCP 的 Agent Skill · 全程使用 WorkBuddy 开发*
  15. </div>
  16. ---
  17. ## 🧭 30 秒看懂
  18. ```
  19. 你:附近有什么麦当劳活动?
  20. 雷达:📡 扫描北京 · 未来 14 天
  21. ✅ 620 个可预约场次 · 11 类活动 · 10 家门店
  22. 🗺️ [卡通活动地图]
  23. 海淀区 · 北师大餐厅 ── 今天 17:30—19:30
  24. 四小福豪华版生日派对 ¥88 余 12
  25. 东城区 · 8 家门店连成一片 party 区 🎪
  26. 🎯 离你最近的:北师大餐厅,天天都有四小福豪华版(¥88)
  27. 📅 点一下「周六」,36 场任你挑
  28. ```
  29. 每一个数字都有出处:620 是官方接口实时返回的场次数,¥88 是和商城价核对过的价格,
  30. 「余 12」是官方接口的原始名额数——**雷达只转述,不编故事**。
  31. ---
  32. ## 🎬 演示视频(3 分 52 秒 · 完整跑一遍)
  33. [![麦麦活动雷达演示视频](images/video-poster.jpg)](https://github.com/Zafer-Liu/mcd-event-radar/releases/download/demo-video/mcd-event-radar-demo.mp4)
  34. > ▶ **[点击观看 / 下载视频(13.4 MB · 1080p)](https://github.com/Zafer-Liu/mcd-event-radar/releases/download/demo-video/mcd-event-radar-demo.mp4)**
  35. > · 讨论见 [Issue #1](https://github.com/Zafer-Liu/mcd-event-radar/issues/1)
  36. >
  37. > GitHub 不支持在线播放视频,链接会**下载到本机**后用播放器观看;不想下载就先看
  38. > [在线演示地图](https://app-ezf35mw5oq9t.miaoda.online/map),浏览器里直接点。
  39. 视频里你能看到:一句话提问 → 城市确认 → 官方 MCP 实时扫描 → 卡通活动地图生成
  40. → 点日期/活动类型筛选 → 导出 `.ics` 日历,全程无剪辑、无假数据。
  41. ---
  42. ## 🚀 三步开吃
  43. > **想先看效果?** 打开[在线演示地图](https://app-ezf35mw5oq9t.miaoda.online/map):不用安装、不用 Token,在浏览器里直接点门店、筛日期、导出日历。
  44. > 演示站的活动与场次为**虚构数据**(门店相对位置仍是真实经纬度投影),页面本身已明确标注;
  45. > 真实数据请按下面三步接入自己的 Token。
  46. ### 第 1 步 · 把这句话发给 WorkBuddy
  47. 不用打开任何命令行——WorkBuddy 自己就会干活。复制下面这句,粘贴进 WorkBuddy 对话框,回车:
  48. ```text
  49. 帮我安装这个技能:https://github.com/Zafer-Liu/mcd-event-radar
  50. 把仓库里 skill/mcd-event-radar 文件夹复制到用户级技能目录(~/.workbuddy/skills/),
  51. 确认 SKILL.md 存在,装完提醒我重开一轮会话
  52. ```
  53. 它会自己下载、安装、验收。装好后**新开一轮会话**,进入第 2 步。
  54. > **不想用对话装?** 两个替代方案,效果一样:
  55. > - **图形界面**:下载本仓库的 `dist/mcd-event-radar-skill.zip`,
  56. > 在 WorkBuddy「技能 → 添加技能 → 上传技能」里导入。
  57. > - **命令行**(适合熟手,重复运行 = 更新;卸载 = 删掉 `~/.workbuddy/skills/mcd-event-radar` 文件夹):
  58. >
  59. > ```powershell
  60. > irm https://raw.githubusercontent.com/Zafer-Liu/mcd-event-radar/main/install.ps1 | iex
  61. > ```
  62. >
  63. > ```bash
  64. > curl -fsSL https://raw.githubusercontent.com/Zafer-Liu/mcd-event-radar/main/install.sh | bash
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 93 on GitHub
  65. > ```
  66. ### 第 2 步 · 对它说一句话
  67. > **「查附近的活动」**
  68. 它会先和你确认城市(支持自动定位,VPN 用户直接报城市名更稳),然后开扫。
  69. ### 第 3 步 · 贴一次 Token,以后一直免配置
  70. 第一次使用时,它会给你一个 1 分钟的官方 Token 申请指引
  71. ([open.mcd.cn/mcp/doc](https://open.mcd.cn/mcp/doc) → 登录 → 控制台 → 激活 → 一键复制),
  72. 你把 Token 粘贴到对话里,**剩下的配置它自己完成**——自动备份、在线验证、绝不外传。
  73. > ⚠️ Token 等同于你的账号凭证:只贴在自己的对话里,不要发群聊、朋友圈或 GitHub。
  74. ---
  75. ## 🗺️ 这张地图,哪些是真的?
  76. | 你看到的 | 是真的吗 | 一句话解释 |
  77. | --- | --- | --- |
  78. | 🏠 门店小屋的位置 | ✅ 真 | 麦当劳官方接口返回的门店经纬度,直接投影到地图上 |
  79. | 🛣️ 街道名字(东单北大街…) | ✅ 真 | 官方地址字段里的街道名 |
  80. | 🎫 卡片上的「可预约」 | ✅ 真 | 官方场次接口亲口说还有名额,才算可预约 |
  81. | 💰 卡片上的 ¥88 | ✅ 核实过 | 接口原始值 8800(单位是分),已和商城标价 88 元核对一致 |
  82. | 🎪 彩色片区 / 道路 / 公园 | ⚠️ 示意 | 画得好看用的,页面明确标注「卡通示意图 · 非精确地图」 |
  83. | 🟡 小屋头顶的数字 | ✅ 实时 | 当前筛选下这家店还有多少场,点日期立刻变 |
  84. **不画假位置、不虚报名额、不瞎标价格**——这是本项目的底线,详见下方「数据诚实红线」。
  85. 顺手还能做:点活动类型的**色标**一键筛选、把当前筛选结果**导出成日历文件**(`.ics`,可直接导入手机日历;官方没给场次时间的会如实标成全天事件);
  86. 门店小屋支持**键盘操作**(Tab 聚焦、回车筛选),系统开启「减少动态效果」时会自动关掉动画。
  87. ---
  88. ## 🧑‍🤝‍🧑 谁需要它
  89. | 你是 | 你会问 |
  90. | --- | --- |
  91. | 有娃家庭 | 「周末带娃去哪家麦麦?生日派对/读书会哪场还有名额?」 |
  92. | 活动型麦门 | 「麦麦奇妙夜捣蛋派对什么时候开?离我近吗?」 |
  93. | 附近党 | 「别给我一堵文字墙,地图上指给我看哪家店最近」 |
  94. | 谨慎型用户 | 「预约前我要看清活动、门店、场次、费用、名额依据」 |
  95. ---
  96. ## ❓ 小白常见问题
  97. **Q:我的城市查不到活动?**
  98. 麦当劳主题活动只在部分城市/门店开放。可以换个城市、把日期范围拉长,或过几天再扫。
  99. **Q:Token 是什么?安全吗?**
  100. 相当于一把只开你自己家门的钥匙。Skill 只把它写进你本机的 WorkBuddy 配置(写前自动备份),
  101. 不进仓库、不进日志、不在对话里回显。介意的话,随时可去官方平台重新申请作废旧的。
  102. **Q:它会不会偷偷帮我下单?**
  103. 不会。默认只查询;真要预约,它会把活动、门店、日期、场次、人数、费用全部列出来,
  104. **你逐项点头之后**才动手,付款也在麦当劳官方流程里由你自己完成。
  105. **Q:地图能当导航用吗?**
  106. 不能。门店的相对位置是真的,但彩色片区和道路是卡通装饰,页面本身也标注了「非精确地图」。
  107. **Q:装完没反应?**
  108. 重启 WorkBuddy 或新开一轮会话,再说「查附近的活动」。
  109. ---
  110. # 🔬 给爱看细节的同学
  111. 以下是技术部分,普通用户不需要读。
  112. ## 四个实测发现(2026-10-09 真实 Token 联调,非文档推测)
  113. **1️⃣ 官方文档的工具名和线上不一致** — 文档写 `query-partystore-date/session`,
  114. 线上 `tools/list` 实测为 `query-party-store-date/session`,本项目全部按实测名对接并写进自检。
  115. **2️⃣ 场次价格的单位是「分」,且可自证** — 场次接口只给裸数字(如 `13800`)。
  116. 用 `mall-product-detail` 同商品价格交叉核实:**11/11 商品倍率恒 ×100**(商城 138 元 ↔ 场次 13800)。
  117. 这个核验已做进运行时:倍率对上才显示 ¥138,对不上自动回退「单位待核实」,官方改口径也不翻车。
  118. **3️⃣ `leftNum` 恒为 12,疑似容量上限而非实时余量** — 上海 116 场、北京 620 场全部如此,
  119. 界面只转述原始值并注明,不吹「名额充足」。
  120. **4️⃣ 门店坐标是官方接口自带的** — `query-party-store` 原始返回含
  121. `address / latitude / longitude`(北京单商品即 365 家门店全带),这是地图敢用真实位置投影的底气。
  122. > 完整联调记录:[MCP_INTEGRATION.md](MCP_INTEGRATION.md)
  123. ## 架构一句话
  124. **Agent 编排 + 确定性脚本**:数字与数据链全部钉在零依赖 Node.js 脚本里(连接器自检、实时查询、
  125. 坐标投影、价格核验),LLM 只负责理解需求、执行流程和守护确认门控。
  126. ```text
  127. 用户一句话 → 城市确认 → 官方 MCP 核实链(商品→城市→门店→日期→场次)
  128. → 卡通地图(真实坐标投影 + 活动卡片) → 用户确认后才可预约
  129. ```
  130. ## 命令行进阶(零依赖,Node.js 20+)
  131. ```powershell
  132. $env:MCD_MCP_TOKEN = Read-Host -MaskInput '麦当劳 MCP Token'
  133. npm run live -- --city 北京 --output events.local.json # 官方 MCP 实时查询(含门店坐标)
  134. npm run radar -- --input events.local.json --city 北京 # 生成卡通活动地图(默认 HTML)
  135. Remove-Item Env:\MCD_MCP_TOKEN
  136. ```
  137. 离线体验(无需 Token):`node skill/mcd-event-radar/scripts/radar.mjs --input examples/sample-events.json --city 上海 --output demo.html`
  138. ## 数据诚实红线
  139. - 查不到就说查不到,说明已查范围;不用搜索结果、模型记忆或示例数据冒充实时结果
  140. - 活动日历 ≠ 预约名额:只有场次接口明确返回有名额才标「可预约」
  141. - 价格展示原始值 + 运行时单位核验,核验不过不换算
  142. - 门店无坐标就进「示意车道」并注明,不猜位置
  143. - Token 只进本机配置,不进回复、示例、日志和本仓库
  144. ## 项目结构(精简版)
  145. ```
  146. mcd-event-radar/
  147. ├── install.ps1 / install.sh # 命令行安装脚本(备选路径,见第 1 步)
  148. ├── skill/mcd-event-radar/ # Skill 源码(SKILL.md + 6 个零依赖脚本)
  149. ├── dist/mcd-event-radar-skill.zip # 可直接导入 WorkBuddy 的 Skill 包
  150. ├── examples/sample-events.json # 虚构演示数据(离线体验用,已标注)
  151. └── images/ # 北京实测截图 + 演示视频封面
  152. ```
  153. ## 参赛材料
  154. | 要求 | 文件 |
  155. | --- | --- |
  156. | 项目介绍/安装/示例/目标用户 | 本 README |
  157. | 介绍主页 + 在线演示地图 | [app-ezf35mw5oq9t.miaoda.online](https://app-ezf35mw5oq9t.miaoda.online)(介绍页 · [演示地图](https://app-ezf35mw5oq9t.miaoda.online/map)) |
  158. | 作品演示视频(3 分 52 秒) | [Issue #1](https://github.com/Zafer-Liu/mcd-event-radar/issues/1) · [下载观看(13.4 MB)](https://github.com/Zafer-Liu/mcd-event-radar/releases/download/demo-video/mcd-event-radar-demo.mp4) |
  159. | 参赛声明(官方原文未改动) | [CONTEST_DECLARATION.md](CONTEST_DECLARATION.md) |
  160. | MCP 接入说明 | [MCP_INTEGRATION.md](MCP_INTEGRATION.md) |
  161. | 脱敏 MCP 配置示例 | [mcp-config.example.json](mcp-config.example.json) |
  162. | WorkBuddy 开发上下文 | [workbuddy.md](workbuddy.md) |
  163. ---
  164. ## License & 声明
  165. [MIT](LICENSE) · 本项目为麦当劳程序员创意开发大赛参赛作品,由参赛者独立开发,非麦当劳官方产品。
  166. 活动、价格和名额均以麦当劳官方实时结果为准。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.