正在整理你需要的资料…
smallchristy123/mcmeal-compass ↗
点麦当劳想按热量和预算控制,又懒得自己逐件查营养和价格。mcmeal-compass 走麦当劳中国官方 MCP,把套餐逐件展开求官方营养成分,用官方计价并标出每个金额的价源,取不到的数据如实标「未知」而不是填 0。仓库带不可变夹具快照,没有 Token 也能离线跑通解析与推荐,只是下单能力在代码里被显式关闭。
适合想按热量和预算控制麦当劳点餐、且要求每个数字都能追溯来源的人。它只负责算清楚,不提供下单能力,真实下单开关始终是关闭的。
mcmeal-compass
点麦当劳想按热量和预算控制,又懒得自己逐件查营养和价格
下面是把仓库 README 逐节读完后归纳出的中文要点。
基于麦当劳中国官方 MCP 的命令行工具,把可解释营养搭配、官方计价核价与下单前安全闸门放在一起;当前版本可运行可装载,但真实下单能力被显式关闭。
输入预算和饮食偏好后,通过官方 MCP 查门店菜单与营养数据、尽量取官方计价,给出有来源可比较的候选;本版本不能下单,调用下单接口会直接报错。
对比普通点餐推荐与本项目:数值逐项标注来源,输出可比较的备选而非唯一最佳套餐,支持营养偏好与预算共同优化,数值与约束交给结构化规则、LLM 只负责理解意图。
覆盖按门店时段选餐、套餐自动展开并逐件累加营养、三方案对比、正餐范围可解释、配件替换重算、最终复核再报价,以及四级数据来源标注;替换后官方报价会随组成变化。
仓库内附有一次真实调用的脱敏留档,clone 后即可运行,离线输出逐字取自运行记录;在线跑需要 Token,价格来源会变成官方计价已核实。
先自行申请麦当劳中国官方 MCP Token,在支持 Streamable HTTP 的客户端里按示例配置 mcd-mcp 服务,再启用该 Skill,用自然语言描述一餐需求。
mcmeal-compass/
├── README.md # 本文件
├── SKILL.md # 可安装入口(Agent 装载用:用法 / 输出约定 / 边界)
├── CONTEST_DECLARATION.md # 官方参赛声明(原样,未修改)
├── MCP_INTEGRATION.md # 实测工具、调用证据与失败降级
├── mcp-config.example.json # 脱敏配置示例(环境变量占位符)
├── workbuddy.md # WorkBuddy 开发上下文(申领专项奖励时提交)
├── package.json / tsconfig.json # 工程配置(Node ≥ 22.6,原生 TypeScript)
├── LICENSE
├── .gitignore
├── docs/ # 架构、数据政策、隐私与安全、演示与审核留档
│ ├── API_PROBE_NOTES.md # MCP 接口实测口径(35 工具、TOON 三坑、计价单位)
│ ├── MATCHING_NOTES.md # 营养匹配实测(命中率、失败模式、别名取舍)
│ ├── DECISION_NOTES.md # 决策内核口径(硬约束 / 评分 / 三方案 / 解释边界 / Go-No-Go 判定)
│ ├── RETROSPECTIVE-*.md # 阶段复盘(远观法)
│ ├── HUMAN_REVIEW.md # 人工审核口径与结论(35 条,2026-10-12 结清)
│ ├── human-review/ # 人工审核判定表与留档(含改前原件;见其 README 的身份对照表)
│ ├── DEMO_SCRIPT.md # 演示录制脚本(真在线取材、分镜、遮挡要点、复核清单)
│ ├── demo/ # 演示取材留档(真实运行原文 + SHA-256;见其 README)
│ ├── REVIEW-DISPOSITION-*.md # 外部评审的逐条处置(取证 + 裁定)
│ └── REVIEW-RESPONSE-v3-*.md # v3 整改的逐条对账(问题反例→修改→入口→日志→适用范围)
├── fixtures/ # 不可变快照(测试基线的唯一来源,契约见 fixtures/README.md)
│ └── baseline-20261010-3450024/ # 一次真实调用的冻结:含 manifest.json(SHA-256 + 条数)
├── src/ # 核心实现
│ ├── toon.ts # TOON 解析器 + MCP 返回包拆解
│ ├── money.ts # 金额契约(内部一律整数「分」)
│ ├── schema.ts # 统一类型契约(zod)
│ ├── matching.ts | 主要语言 | TypeScript | 许可 | MIT |
|---|---|---|---|
| 创建时间 | 2026-10-10 | 最近提交 | 2026-10-19 |
| 站内采集 | 2026-11-06 起,连续观察 3 天 | 最近一次 | 2026-11-08 |
最近 3 次采集
2026-11-06 121 ★ → 2026-11-08 121 ★ (累计 —)
数据来自 GitHub 公开接口的每日采集快照,star 数为采集当时读到的值, 与 GitHub 页面上显示的实时数字可能有几分钟的差距。 项目名点击可回到 本页。