尚未偵測到更新。GitHub 發布版本後會顯示在這裡。
個人 GitHub 帳號下公開儲存庫的擁有者可以登入並驗證所有權,自行管理介紹,無需管理員核准。
登入並產生驗證檔案,在 30 分鐘內將其提交至此儲存庫的預設分支。其他分支或分叉儲存庫中的檔案無效。然後在下方檢查檔案,即可無需管理員核准直接管理專案。請保留檔案以維持管理權限。
如需登入,將前往登入頁面。登入後請回到此處,再次點擊所選的驗證按鈕。
在專案資料夾中執行 /nomorevibe verify,即可驗證所有權並自行管理介紹。
一分鐘完成驗證读取你的麦当劳订单,生成麦门八型人格年度报告海报 - 麦当劳 MCP 大赛参赛作品
翻譯準備中
正在載入完整 README。
檢視完整 README ↗今年的你,正式确诊为哪一型麦门人?
读取你的麦当劳订单,从时间、渠道、单品、金额里算出你的麦门人格,生成一张能直接发朋友圈的 3:4 年度海报。
在线体验:talk2joan.github.io/mcd-laofan-report
参赛赛道:麦当劳程序员创意开发大赛 · 麦当劳 MCP 只读开发
核心特点:
order-list 和 now-time-info 只读获取order-list 返回的 JSON,或先看八型演示没有 Token 也能 10 秒看到完整效果:
看完觉得有意思再 Star,想要自己的报告再往下走。
# macOS / Linux
export MCD_MCP_TOKEN="你的 Token"
python3 mcp_bridge.py
# Windows PowerShell
$env:MCD_MCP_TOKEN="你的 Token"
python mcp_bridge.py
也可以直接打开 talk2joan.github.io/mcd-laofan-report,它会请求你本机的 127.0.0.1:8765(需要先启动桥接)。Token 和订单都不经过 GitHub,全程留在本地。
桥接做了什么:
order-list(历史订单)和 now-time-info(报告时间)createTime、orderType、realTotalAmount、商品名与数量给浏览器orderId、门店、地址、手机号等字段127.0.0.1,CORS 只放行本机页面和本项目 GitHub Pages,其他网站无法读取你的订单如果你已经通过其他方式拿到了 order-list 的原始返回(JSON 格式),可以在页面上点「导入订单 JSON」直接上传,全部在浏览器本地计算。
┌─────────────────┐
│ 浏览器(前端) │
│ index.html │ ← 用户看到的页面,零后端
│ app.js │ ← 订单解析、20+ 指标计算、八型打分
│ poster.js │ ← Canvas 渲染海报(把真实数字画进预设的卡片位置)
└────────┬────────┘
│ HTTP GET /api/report
▼
┌─────────────────┐
│ mcp_bridge.py │ ← 本机桥接(可选,只在方式一/二时需要)
│ 只读 MCP │ ← 调用 order-list + now-time-info
│ 脱敏 + CORS │ ← 丢掉敏感字段,只放行白名单来源
└────────┬────────┘
│ MCP over HTTPS
▼
┌─────────────────┐
│ 麦当劳 MCP │
│ mcp.mcd.cn │
└─────────────────┘
app.js:数据层,导出 prepareReport()、shareTexts() 等 11 个函数
summarize():从订单数组算出 20+ 项指标determinePersona():按八套规则打分(0–100),最高分当选posterCards():为每种人格准备底部三张数据卡的内容poster.js:视觉层,导出 renderPoster(canvas, { image, cards, demo })
mcp_bridge.py:本机桥接(可选)
order-list 和 now-time-infoorderId、storeId、deliveryAddress、mobile 等字段null(file://)、127.0.0.1、localhost、talk2joan.github.ioAccess-Control-Allow-Private-Network: true(Chrome 私有网络访问)index.html:单页应用
每种人格按订单行为独立打分(0–100),最高分当选:
| 人格 | 英文 key | 判定逻辑 |
|---|---|---|
| 班马 | banma | 工作日下单占比 ≥ 70% |
| 深夜黑马 | midnight | 22:00 后下单占比 ≥ 50% |
| 甜品治愈派 | dessert | 甜品(甜筒/圣代/派)下单占比 ≥ 30% |
| 卡急马 | rush | 17:00–19:30 下班冲刺占比 ≥ 35% |
| 麦门痴心人 | classic | 单品复购 Top 1 占比 ≥ 25% |
| 麦门探险家 | explorer | 只尝一次的单品数 ≥ 独特单品数的 50% |
| 麦乐送常驻民 | delivery | 外送订单占比 ≥ 60% |
| 麦门显眼包 | spotlight | 高于中位数 1.8 倍的"高光时刻"订单数 ≥ 总数的 20% |
八张人格海报由 Seedream 生成(Prompt 见 传播手册.md),版式一致:
poster.js 用纸色圆角矩形盖住原图卡片内容,重绘 [标签, 数值, 单位]order-list 和 now-time-info,不下单、不支付、不领券桥接白名单:
null(file://)、127.0.0.1、localhost、talk2joan.github.ioMCD_BRIDGE_ORIGINS 追加来源(逗号分隔,完整 https://域名)为什么在线版安全:
127.0.0.1:8765talk2joan.github.io,其他网站无法读取你的订单Access-Control-Allow-Private-Network: true,本桥接已支持# 单元测试(Node.js 内置 test runner,零依赖)
node --test tests/
# 本机启动桥接
export MCD_MCP_TOKEN="你的 Token" # 或 Windows: $env:MCD_MCP_TOKEN="..."
python3 mcp_bridge.py
# 打开 http://127.0.0.1:8765/
测试覆盖:
tools/call 返回的 content[].text(Markdown 包裹 JSON)shareText() 默认返回朋友圈文案mcd-laofan-report/
├── index.html # 单页应用
├── app.js # 数据层(订单解析、指标计算、八型打分)
├── poster.js # 视觉层(Canvas 渲染海报)
├── mcp_bridge.py # 本机桥接(可选,只在方式一/二时需要)
├── mcd_client.py # MCP 客户端(mcp_bridge.py 的依赖)
├── tests/
│ └── app.test.js # 单元测试
├── assets/
│ ├── persona-*.jpg # 八张人格海报底图(Seedream 生成)
│ └── mcdonalds-arches.png # 麦当劳金拱门 logo
├── 传播手册.md # 产品定位、八型规则、视觉规范、分享钩子
├── PRD.md # 完整产品需求文档
├── PLAN.md # 开发计划与里程碑
├── 技术设计.md # 架构、数据契约、MCP 集成方案
├── 提交清单.md # 参赛必交文件检查表
└── README.md # 本文件
必交文件:
assets/ 目录,海报样张)PRD.md、技术设计.md、传播手册.md)order-list 和 now-time-info 只读工具传播手册.md)MIT License. 详见 LICENSE 文件。
免责声明: