mcd-wrapped - 麦当劳 MCP 能力探测与数据报告工具箱

mcd-wrapped 是一个围绕麦当劳 MCP 开放能力构建的工具箱，仓库由维护者 lvzuojing 托管在 GitHub。据项目自述，它把四个模块串成一条链路：探测 MCP 各 tool 的真实返回形态、生成个人年度消费年报、汇总公共数据全景报告，以及用蒙特卡洛模拟估算抽奖的期望值。项目定位并非「又一个点餐助手」，README 中明确表示方向是「先帮开发者搞清楚 MCP 到底返回了什么，再把数据做成值得点星的报告」。它适合两类读者：正在对接麦当劳 MCP、需要摸清接口真实返回格式的开发者，以及希望把个人消费记录或公共餐品数据整理成可视化报告的普通用户。项目自述其为麦当劳 1024 程序员节创意开发大赛参赛作品，并声明非麦当劳官方产品。

维护者与状态

仓库维护者为 lvzuojing，地址是 github.com/lvzuojing/mcd-wrapped。仓库创建于 2026-10-09，最后一次提交在 2026-10-13，属于创建后数日内集中开发的早期项目。截至 2026-11-06，仓库获得 513 个星标。需要说明的是，该项目尚无正式 release，使用方式以直接运行仓库内脚本为主，没有可安装的发行包。许可证为 MIT。

主要能力

以下能力均据项目 README 自述整理，未经过实际运行验证。

• MCP 能力探测器（scripts/explore.py）：一键探测全部 tool 的真实返回，并自动串联参数，例如从 order-list 取 storeCode 喂给 query-meals、取 orderId 喂给 query-order。项目自述服务端实际暴露 35 个 tool（文档写的是 33 个），探测器跑通 27 个，7 个写操作默认跳过，1 个缺参数。README 还记录了三个「坑」：返回体不是 JSON 而是 Markdown，真 JSON 藏在 ## Original Response 之后；list-nutrition-foods 的 data 是逗号分隔文本表格；无数据时返回中文文案而非空数组。
• 个人年度消费年报（scripts/collect.py 与 scripts/build_report.py）：据项目说明，报告包含年度下单数、消费总额、客单价、深夜订单占比、最常去门店、连续打卡、高频单品 Top 6、月度趋势、周几偏好、下单高峰、累计能量、可用积分与奖品数。
• 麦当劳数据全景报告（scripts/public_data.py 与 scripts/build_panorama.py）：不需要个人消费记录，只用公共数据，涵盖 158 个餐品营养档案、热量与低卡排行、分布直方图、当月营销日历、积分抽奖池、可领券与积分商城商品。
• 抽奖 EV 精算器（scripts/lottery_ev.py）：基于真实奖池与单次消耗做蒙特卡洛模拟，默认 10 连抽 × 10000 轮，可通过参数调整抽数与轮次、折扣券基准价。项目自述麦当劳未公布中奖概率，结果基于等概率假设，脚本从不调用 draw-lottery。
• 方言语音播报（scripts/speak.py）：可选粤语、闽南语调、普通话等播报，后端按 VoxCPM2 到 macOS 内置中文嗓音自动回退，也支持 --dry-run 只输出播报稿。

使用入口

仓库地址：lvzuojing/mcd-wrapped。

据项目说明，使用前需要设置环境变量 MCD_MCP_TOKEN，然后直接运行 Python 脚本。README 给出的典型命令如下（多行命令以无属性 pre 呈现）：

export MCD_MCP_TOKEN=你的token
python3 scripts/explore.py

个人年报需要先采集再渲染：

export MCD_MCP_TOKEN=你的token
python3 scripts/collect.py
python3 scripts/build_report.py

全景报告不需要消费记录：

python3 scripts/public_data.py
python3 scripts/build_panorama.py

抽奖精算器可带参数运行：

python3 scripts/lottery_ev.py --draws 50 --trials 50000

项目自述探测器零第三方依赖，输出写入 out/ 目录下的 Markdown 或 HTML 文件。仓库内还包含 SKILL.md、MCP_INTEGRATION.md、mcp-config.example.json 等辅助文件，供 Agent 驱动流程与脱敏配置参考。

许可与限制

许可证为 MIT。项目自述的边界与限制包括：只读官方数据，不创建、不取消、不支付任何订单；draw-lottery、create-order、cancel-order、mall-create-order、auto-bind-coupons、party-order-create、delivery-create-address 等写操作工具一律不调用，只在报告中展示参数定义；配置文件仅使用环境变量占位符，不含凭证。能量数值按公开营养信息估算，仅供参考，不构成健康或营养建议；抽奖期望值因官方未公布概率而按等概率假设做披露性说明，不构成参与建议。语音播报依赖本地 VoxCPM2 服务或 macOS 内置嗓音，属于可选功能。项目为大赛参赛作品，非麦当劳官方产品，且尚无正式 release，接口形态与脚本行为可能随 MCP 服务端变化而调整。