Maintainer of this skill?
by ayingQAQ
McCosmos · 麦门星图｜基于麦当劳 MCP 的餐品营养对比与替代发现 Skill，提供独立运行包、可解释分析与三维星图。
# Add to your Claude Code skills
git clone https://github.com/ayingQAQ/McCosmosSee how McCosmos compares with popular alternatives.
McCosmos is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by ayingQAQ. McCosmos · 麦门星图｜基于麦当劳 MCP 的餐品营养对比与替代发现 Skill，提供独立运行包、可解释分析与三维星图。. It has 60 GitHub stars.
McCosmos's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/ayingQAQ/McCosmos" and add it to your Claude Code skills directory (see the Installation section above).
McCosmos is primarily written in TypeScript. It is open-source under ayingQAQ on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh McCosmos against similar tools.
No comments yet. Be the first to share your thoughts!
Available after the catalog security scan passes.
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
基于麦当劳 MCP 的餐品营养对比与替代发现 Skill。用自然语言比较真实餐品、按热量条件找候选、解释营养相似性，并通过三维星图查看结果。
面向使用 Agent 查询与比较麦当劳餐品的用户，以及复用可解释营养分析能力的开发者。核心分析无需打开网页；已有三维宇宙、图鉴和实验室是可视化探索入口。独立参赛作品，信息以官方渠道为准。
下载 独立 Skill 包 mccosmos-skill.zip，将其中的 mccosmos 文件夹放到目标客户端支持的 Skill 目录。也可从成功的 Skill Actions 下载同名产物。
~/.agents/skills/mccosmos；客户端发现方式以其支持为准，必要时启动新会话。安装后向 Agent 输入：
使用 $mccosmos 对比巨无霸和麦香鱼的营养差异。
| 可以这样问 | Skill 会做什么 |
|---|---|
| 对比巨无霸和麦香鱼 | 核对原始规格，列出营养原值与差异 |
| 找比巨无霸热量低、营养特征相近的同类替代 | 严格筛选真实候选，解释相似维度和热量差 |
| 早餐里不超过400 kcal的有哪些，按热量升序 | 按真实数值筛选、排序；缺失不算0 |
| 冰牛奶有哪些杯型 | 列出具体规格，避免混用大小杯数据 |
| 想在星图里看这些餐品 | 提供对应图鉴或星图链接 |
Skill 会检查实际 CLI 结果再答复。相似度不是健康评分；未核实单位保持“原始值”，不声称每份或每100克；没有符合结果时明确说明。Skill 入口 · 命令参考 · 验收方法与证据
独立包也能直接运行：
node "/path/to/mccosmos/scripts/mccosmos.mjs" compare --from="巨无霸" --to="麦香鱼"
node "/path/to/mccosmos/scripts/mccosmos.mjs" alternatives --name="巨无霸" --lower-kcal --limit=3
| 探索站 | 简介 | 可以做什么 |
|---|---|---|
| 宇宙观测站 | 探索首页 | 查看星图概况、随机发现餐品、开启今日任务 |
| 营养星系 | 三维美食宇宙 | 旋转与穿梭星团，搜索餐品，切换营养透镜，规划星际航线 |
| 星球图鉴 | 餐品资料册 | 按类别筛选、排序、收藏，查看商品图片和营养档案 |
| 营养实验室 | 餐品对照台 | 对比 2–3 款餐品，查看原值、差值与相近度，导出对照卡 |
| 探索任务 | 每日发现手帐 | 完成双生星、营养排名和指定航线任务，领取星章 |
建议从观测站开始探索；五个站点均可通过顶部导航直接进入。
| 入口 | 内容 |
|---|---|
| Actions 与静态包 | 查看构建、测试结果，下载可离线运行的静态包 |
| MCP 接入说明 | 数据同步、接口使用与凭据配置方式 |
| McCosmos Skill | 安装后使用自然语言对比、筛选与查找替代餐品 |
| 用户旅程与验收 | 五站之间的交互路径和验收记录 |
| 实施记录 | 项目开发过程与阶段记录 |
宇宙使用奶油纸色、麦当劳红与暖金色。卡通餐品图案附在 受光照的真实三维球体表面，保留弧面、明暗交界与立体星环；图案映射到贴合球面的三维网格，参与光照、透视、遮挡和雾化，拾取对应三维球体；旋转、平移、相机飞行继续工作。营养指标只改变尺寸，不重排位置。图鉴与档案则显示有来源的真实商品图片，两类视觉资产各司其职。
当前 158 条营养餐品规格中，138 条可显示图片（101 条准确对应/已核对别名，37 条同款尺寸参考）。其中 112 条来自 MCP query-meals / query-meal-detail，另外 26 条来自麦当劳中国官网营养计算器、同名商品页及套餐推广页。list-nutrition-foods 不含图片；积分商城图片不用于餐品映射。
图鉴中同款饮品不再按大小杯重复铺卡：117 张卡片，其中饮品 40 张；默认展示中杯，详情中可切换杯型，各自的原始 ID、营养值、收藏与实验室记录保持独立。冰/热、口味与奶基底不同的商品仍分开。
图片保留菜单原名、编码、来源页、原始 URL 与审核说明。尺寸参考在卡片和详情公开标注，官网套餐推广图只用于对应的同名组合；历史推广文案及价格不代表当前供应。尚未确认的 20 条规格与加载失败时显示明确占位，不用其他商品冒充。逐项来源与未覆盖列表见 图片来源与覆盖。
node scripts/cache-food-photos.mjs 可重新缓存已审核 URL，不需要 Token。首页任务采用独立的标题、说明与按钮区域，在桌面、平板、手机分别调整列数，避免长中文被操作按钮挤成竖排。
收藏、实验台、最近查看和任务进度保存在版本化 localStorage；官方与演示模式分别存储。清除浏览器数据后消失，存储被禁用时仍能在当前会话探索。分享图包含来源和单位边界，不把未核实的原始值改写为每份 g/mg。
需要 Node.js 24+、pnpm 11.21.0。
pnpm install --frozen-lockfile
pnpm dev
打开终端显示的本地地址，默认读取官方快照。
从成功的 Actions 运行下载 mccosmos-static，解压后运行：
node serve.mjs
打开 http://127.0.0.1:4173。包内含营养快照、已匹配商品照片、卡通 SVG 贴图与字体，无需安装依赖、联网或提供 Token。不支持直接双击 index.html，不使用 Service Worker。
首次项目同步为 2026-10-21 11:20（北京时间）：官方接口160条，完全去重后158条。准确时间和数量见界面/快照 meta，非实时在售菜单。
接口未显式声明部分单位和计量基准，因此显示 kcal 及其他指标原始值，不擅自声称每份、每100克或 g/mg。类别本地推断，相近度为工程算法，非官方评价。
通过 ?demo=1 或来源说明窗口主动进入演示模式，持续标为“合成示例数据 · 非官方营养信息”。官方数据失败只显示错误，不自动伪装回退。合成数据生成器与真实快照隔离。
在麦当劳开放平台登录并激活 Token。设置环境变量 MCD_MCP_TOKEN，或把 .env.example 复制为 .env.local 填入 Token，然后：
pnpm sync:mcd
Token 不带 Bearer 前缀，不进入浏览器或公开仓库。同步失败保留旧快照，仅调用只读营养工具。
pnpm cosmos:cli -- compare --from="巨无霸" --to="麦香鱼"
pnpm cosmos:cli -- search --category=breakfast --max-kcal=400 --sort=kcal-asc --limit=10
pnpm cosmos:cli -- alternatives --name="巨无霸" --lower-kcal
pnpm cosmos:cli -- list --category=burger
pnpm cosmos:cli -- neighbors --name="巨无霸" --limit=3
pnpm cosmos:cli -- route --from="巨无霸" --to="双层吉士汉堡"
pnpm cosmos:cli -- discover --kind=twins
pnpm cosmos:cli -- discover --kind=lonely --demo
返回 JSON：ok/mode/source/fetchedAt/warnings 和 data/error。失败退出码非零；重名返回候选，请使用 --id、--from-id 或 --to-id。图不连通时可能无路径。
上面是源码模式，需要项目依赖。分发时使用 pnpm skill:build 生成 dist-skill/mccosmos，pnpm skill:verify 在仓库外的临时目录验收纯 Node 包；这些构建和验收在 Actions 中执行。复制源码 skills/mccosmos 仅得到指令与参考，仍需要项目；用户安装应优先下载完整独立包。不会自动修改客户端配置。
每次 push、PR、手动触发均运行 Actions：test → typecheck → lint → build → skill:build → skill:verify → verify:contest → Playwright。普通 CI 不配置 MCP Token；浏览器测试使用真正的离线静态包，保存1440×900、768×1024、390×844截图和测试报告。
Cloudflare Pages：构建命令 pnpm build，输出 dist，Node24，无需服务端凭据。也可上传 Actions 产物。在线部署状态见实施记录；没有实际可访问地址前不宣称上线。
星系使用按需渲染、InstancedMesh 批量绘制与有上限的插画解码缓存（32 张 / 8 MiB）；静止后停止动画帧，退出页面释放 GPU 资源。保留真正的三维透视与逐星球拾取，详见性能与缓存说明。
React、TypeScript、Vite、Three.js WebGL2（PerspectiveCamera、OrbitControls、Raycaster）、自绘 SVG、少量 Rough.js 纸面装饰；Canvas2D 仅用于材质纹理与卡片导出。Zod 和 TOON 严格适配、MCP SDK 同步，Vitest 和 Playwright 验证。
三维布局、相机、材质、资源清理与扩展入口见 三维重构说明。
星球、纸张布局和插画为原创。感谢 Wired Elements、PaperCSS、Rough.js 的线条启发，不套用完整布局。第三方许可见 THIRD_PARTY_NOTICES.md。代码 MIT，官方数据、声明和第三方素材各遵守自身条款。