正在整理你需要的资料…
johnny37/mcd-experience-atlas ↗ · 项目主页 ↗
孩子生日想办麦当劳派对,哪些城市、哪些门店能办、多少钱,官方 App 得一层层点开才看得到。mcd-experience-atlas 用麦当劳中国官方 MCP 只读采集,把 281 城 3664 家门店、26 款体验活动铺成一张可搜的地图:圆点大小即该城可办活动款数,7 天场次日历把零场次标灰。有 2 款活动全国无城市可约。
适合想给孩子办派对,或筹备团建品鉴会、需要查哪些门店能承接的人。官方 App 只能逐级点开试,这里是拉通全量数据后才能算出的横向对比。
下面是把仓库 README 逐节读完后归纳出的中文要点。
从麦当劳官方 MCP 实测采集到 281 个城市、3664 家可办门店、157 个场次、26 款体验活动,在线打开即用,一次查询就能回答某城市能否办生日派对、哪家店、多少钱
地图提供可体验活动款数视图、可办门店数视图、品类筛选、7 天场次日历、门店搜索与筛选,以及自动算出全国零城市可约活动、门店集中度等结论的数据洞察面板
地图与查询全部只读,src/book.py 额外提供可真实下单的能力但默认关闭,必须用户明确说出确认创建订单、核对完整回显、订单指纹一致且前置校验通过才会建单
默认是纯 SVG 散点图,只画城市坐标与经纬网格,不描行政边界、不加载在线底图;带底图的视图需自行接入腾讯地图、高德、百度、天地图等有资质服务商,禁止使用未获境内测绘资质的数据源
难点在于摸清一条没有文档的链路:体验活动预约的入口是积分商城选商品,所有 tools/call 返回 Markdown 说明加内嵌 JSON,得从 success 起用 JSONDecoder.raw_decode 找边界
几组离线测试分别锁定风险:TOON 的字面量陷阱与误取说明文档里的 JSON 示例、下单的三条安全属性、data/atlas.json 的计数一致性与价格单位、参赛文件与凭证合规
mcd-experience-atlas/
├── README.md 项目介绍 / 安装 / 使用示例 / 目标用户
├── MCP_INTEGRATION.md 实际调用的 Server/Tool/流程/业务价值(参赛必需)
├── CONTEST_DECLARATION.md 参赛声明(官方原文,未做任何改动)
├── CONTRIBUTING.md 贡献指南:可复用模块清单 + 四个二次开发方向
├── mcp-config.example.json 脱敏配置示例,仅含 ${MCD_MCP_TOKEN} 占位符
├── workbuddy.md 使用 WorkBuddy 开发的对话上下文
├── SKILL.md Agent 技能描述(可被任意 MCP 客户端加载)
├── LICENSE MIT
├── index.html 单文件地图页(数据内联,供 GitHub Pages 根目录托管)
├── data/
│ ├── atlas.json 前端使用的打包数据(build_atlas.py 生成)
│ ├── cities.json 281 城 + 经纬度 + 品类覆盖矩阵
│ ├── stores.json 各城市可办门店全量
│ ├── sessions.json 场次抽样(79 城 / 157 场次)
│ ├── experiences.json 50 个商城 SPU
│ ├── nutrition.json 160 项营养表(TOON 已解析)
│ ├── lottery.json 积分抽奖活动与奖池
│ ├── campaign_calendar.json 当月营销活动日历
│ ├── live_verification.json 通过 WorkBuddy 连接器的全链路实时验证记录
│ ├── tools_snapshot.json tools/list 实测元数据
│ └── tools_reference.md 35 个工具的完整描述与入参 Schema
├── src/
│ ├── mcp_client.py MCP 客户端(混合响应解析、429 退避、写操作黑名单)
│ ├── toon.py TOON 解析器(含字面量 \n 归一化)
│ ├── collect.py 采集脚本(支持 --deep / --resume)
│ ├── build_atlas.py 数据打包 + 单文件版本生成(同时输出根 index.html)
│ ├── make_posters.py 分享海报渲染(数字取自 atlas.json,不写死)
│ ├── make_gif.py 演示动图合成(Pillow)
│ └── book.py 体验活动预约:带确认闸的下单流程(默认只读)
├── web/
│ ├── index.html 图谱页面(零依赖)
│ └── at| 主要语言 | HTML | 许可 | MIT |
|---|---|---|---|
| 创建时间 | 2026-10-13 | 最近提交 | 2026-10-23 |
| 站内采集 | 2026-11-06 起,连续观察 6 天 | 最近一次 | 2026-11-11 |
最近 5 次采集
2026-11-06 135 ★ → 2026-11-11 132 ★ (累计 -3)
数据来自 GitHub 公开接口的每日采集快照,star 数为采集当时读到的值, 与 GitHub 页面上显示的实时数字可能有几分钟的差距。 项目名点击可回到 本页。