What it does
麦麦预算餐:基于麦当劳 MCP 的真实核价、预算比较与餐品替换 Skill
- Connects Instruction files the AI reads, with steps that call an outside service
- Account or key Some steps need a key for MCD_MCP_TOKEN (per the README)
- Category Coding
For makers: add a badge to your README
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/skills/sam-hui-dot-mcd-budget-meal)Use together with
MCP servers that connect the AI to services for the same work
Fallow
Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.
Desktop Commander
MCP server for terminal commands, file operations, and process management
Similar Skills
Same kind of work, ordered like the Skills list
| This one mcd-budget-meal | rea | andrej-karpathy-skills | graphify | MoneyPrinterTurbo | |
|---|---|---|---|---|---|
| Maker | Sam-Hui-dot | morluto | multica-ai | Graphify-Labs | harry0703 |
| Skills | 1 | 1 | 1 | 1 | 1 |
| GitHub stars | 1,329 | 468,733 | 234,332 | 150,287 | 144,566 |
| Last code change | Oct 24, 2026 | Nov 19, 2026 | Apr 20, 2026 | Nov 18, 2026 | Nov 18, 2026 |
| License | – | MIT | – | Apache-2.0 | MIT |
1 skills (instruction sets) by Sam-Hui-dot that an AI reads and follows · not an MCP server
How a Skill differs from MCP
MCP = the hands
Connects the AI to an outside service or data, such as reading Notion or creating an invoice. A program or server has to be running.
Skill = the manual
A text file that teaches the AI how to do a task. It connects to nothing.
Some overlap: a few Skills run scripts that call tools, and a few MCP servers only send knowledge. Start from the task you want done.
Works with
Cursor
From the maker’s README and the folders in the repo
Install
Is it safe?
- Who made it
GitHub account Sam-Hui-dot (person), 1 years old
- Use and upkeep
★ 1,329 stars · code last changed Oct 24, 2026
- Any scripts?
4 scripts that can run on a computer: scripts/compare_meals.py, scripts/mcp_query.py, scripts/quote_meals.py, scripts/report_meals.py
- Uses the internet?
Scripts that go online: scripts/mcp_query.py
- Changes machine-wide settings?
No hooks or writes to machine settings found
Checked automatically from the repo files at commit 25d5f34 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself
First: which AI do you use?
Pick your app and this page shows only how to install it there
Option 1Upload to claude.ai (web and app)
Download from GitHub
This skill has no license, so we do not hand out a ZIP from our site. Download it from GitHub and arrange the folder yourself, or use "Let the AI install it" above, which is easier
Download from GitHub (whole repo) ↗
Unzip it, then zip only the skills/mcd-budget-meal folder again. The ZIP must have a mcd-budget-meal folder with SKILL.md at the top level, no loose files
Open Skills on claude.ai and upload
+Create skillUpload a skillpick mcd-budget-meal.zip
No Upload button? Turn on file creation first
SettingsCapabilitiesCode execution and file creation
Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free
Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)
Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)
Checked against official docs Nov 12, 2026 · Source: support.claude.com, support.claude.com, code.claude.com
Option 1Let Claude Code install it
Copy this sentence and paste it into a Claude Code chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Restart Claude Code, then type /mcd-budget-meal or ask for a matching task and Claude picks it up
Checked against official docs Nov 12, 2026 · Source: code.claude.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.claude/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/sam-hui-dot/mcd-budget-meal.git /tmp/popnx-skill-sam-hui-dot-mcd-budget-meal-25d5f34 && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-sam-hui-dot-mcd-budget-meal-25d5f34/skills/mcd-budget-meal' ~/.claude/skills/mcd-budget-mealRestart Claude Code, then type /mcd-budget-meal or ask for a matching task and Claude picks it up
ChatGPT desktop app
The ChatGPT desktop app has Codex built in, and Codex reads skills from ~/.agents/skills
Option 1Let ChatGPT install it
Open Codex in the ChatGPT desktop app and paste this sentence into the chat
The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Option 2Put the folder there yourself
Put the mcd-budget-meal folder at ~/.agents/skills/mcd-budget-meal
~ is your home folder ($HOME)
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.agents/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/sam-hui-dot/mcd-budget-meal.git /tmp/popnx-skill-sam-hui-dot-mcd-budget-meal-25d5f34 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-sam-hui-dot-mcd-budget-meal-25d5f34/skills/mcd-budget-meal' ~/.agents/skills/mcd-budget-meal
After installing
- ChatGPT desktop app: open Skills in the sidebar to see that the skill is there
- To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
- Codex picks up newly installed skills by itself; if one does not show up, restart Codex
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
ChatGPT on the web and mobile
Skills you install yourself do not work here; only skills that come with a plugin from the directory
To use this skill with ChatGPT, use the ChatGPT desktop app as above
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
Option 1Let Codex install it
Copy this sentence and paste it into a Codex chat · Works in Codex inside the ChatGPT desktop app, Codex CLI and the IDE extension
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Codex picks up newly installed skills by itself; if one does not show up, restart Codex · To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.agents/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/sam-hui-dot/mcd-budget-meal.git /tmp/popnx-skill-sam-hui-dot-mcd-budget-meal-25d5f34 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-sam-hui-dot-mcd-budget-meal-25d5f34/skills/mcd-budget-meal' ~/.agents/skills/mcd-budget-mealRestart Codex, then ask for a matching task; Codex lists the skill
Option 1Let Cursor install it
Copy this sentence and paste it into a Cursor chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
In Cursor’s Agent chat, type / and pick mcd-budget-meal
Checked against official docs Nov 12, 2026 · Source: cursor.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.cursor/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/sam-hui-dot/mcd-budget-meal.git /tmp/popnx-skill-sam-hui-dot-mcd-budget-meal-25d5f34 && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-sam-hui-dot-mcd-budget-meal-25d5f34/skills/mcd-budget-meal' ~/.cursor/skills/mcd-budget-mealIn Cursor’s Agent chat, type / and pick mcd-budget-meal
Option 1Let the AI install it
For other apps that read skills. The sentence gives the paths for Claude Code, Codex and Cursor so the AI picks the one for your app · Copy this sentence into the app’s chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Checked against official docs Nov 12, 2026 · Source: code.claude.com, learn.chatgpt.com, cursor.com
For Terminal users
Other apps that support Agent Skills (such as Gemini CLI or GitHub Copilot) use different folders. Check that app’s guide, then copy the folder with the SKILL.md there.
Skill folders checked against the official Claude Code, Codex and Cursor guides on Nov 11, 2026
✓ Commands checked Nov 19, 2026
View the original SKILL.md
The text below comes from the maker’s repo, not from PopNx MCP
3,211 characters · Open the full file on GitHub
---
name: mcd-budget-meal
description: 使用麦当劳中国 MCP,为单人到店取餐查询菜单、核对当前门店优惠并比较预算内餐单。适用于“30元吃什么”“保留汉堡换饮料”等点餐决策请求。
---
# 麦麦预算餐
让用户用一句话获得少量可选择的餐单,每份给出实际餐品、官方核价、预算余量和优惠条件。使用用户本机已启用的麦当劳 MCP 连接器,服务地址 `https://mcp.mcd.cn`。
## 收集需求
从对话提取预算、门店或位置、必选餐品、不要的餐品和取餐时间。缺预算或门店时一起询问;已给出的信息不要重复问。默认单人、现在、到店取餐。外送、多门店比较和多人分账不属于这一版,说明范围后让用户选择是否继续到店取餐。
将偏好转成可检查约束:指定餐品用 `required_codes`,最低份数用 `required_quantities`;“一个汉堡和一杯饮料”用由当前菜单确认的 `required_groups`,允许各组内替代。不要的餐品用 `excluded_codes`,名称匹配用 `excluded_terms`。不把父套餐计入实际汉堡或饮料份数,不把“不要普通可乐”自动扩展成“不要所有可乐”;含糊且影响结果时再确认。
若需定位,使用用户主动提供的位置调用 `query-nearby-stores`,让用户选定门店。没有位置时直接询问门店,不推测用户地址。不要把个人定位保存到公开文件。
## 获取实际餐单和价格
1. 查看当前连接器的工具说明和输入 schema,以当前 schema 组织参数。本项目的 JSON 是本地整理格式,不能直接作为 MCP 请求参数。
2. 用 `query-meals` 查所选门店菜单;用 `query-store-coupons` 查此门店下用户可用的券。没有券就比较不带券的餐单;券查询失败则注明优惠尚未核实,不推测其可用性。
3. 对准备使用的套餐调用 `query-meal-detail`,补齐必选组合、允许替换项和数量。区分主商品价格、加购价、会员条件价及替换差价,不把菜单展示价当作应付价。
4. 从实际菜单构造最多三份候选:预算内的基础餐单、保留用户偏好的餐单、另一份套餐组合。只保留有意义的差异,不为了凑数增加餐品。不擅自删掉必选项、改变预算或加入付费会员。
5. 对每份候选调用 `calculate-price`。请求中的门店、取餐方式、时间、餐品选项和券保持一致。仅成功核价的餐单进入比较;记录应付总额、币种、金额单位、时间和工具返回引用。
宿主允许执行脚本时,优先读取 [references/meal-plan.md](references/meal-plan.md),将最多三份完整核价参数与对应组成写到私有餐单计划,用 `scripts/quote_meals.py`完成核价与自动比较。用户不需要编辑 JSON或抄录金额。该入口在实际请求前检查编码和份数、在工具定义中确认单位;用已有本机 WorkBuddy认证时显式添加 `--use-workbuddy-config`。候选生成、餐品归类、券条件仍必须来自实际工具结果,不能用示例编码。没有已获授权的脚本执行条件时保留原生工具流程。
每次用户请求只做这几份必要核价,不遍历全菜单、不后台刷新、不自动重试限流。遇到错误保留原因;餐品不可售可替换一次并重新核价。401 提示用户检查本机连接器;429 停止本轮调用。
遇到 `Parameter validation failed` 等参数类型错误,立即停止本轮核价,不继续轮换餐单或用空数组、缺参数请求试探。保存可见的工具输入 schema、该次实际 arguments 和原始错误;无法读取的部分写明不可用,不把推测或重写后的示例当原始记录。`items` 的数组 `[{...}]` 与字符串 `"[{...}]"` 是不同类型,应按实际 schema 传值。仅凭错误文字或省略参数后的另一种错误,不能确定问题发生在客户端,也不能断言连接器存在 bug。先核对参数与 schema;有明确修正依据后,在本次任务已授权范围内修正并再核价一次;同类错误再发生就停止并保留诊断资料。
WorkBuddy 经延迟工具入口报告 `/items: must be array` 时,不再经同一入口重试,也不要求反复重启或改连接器。读取 [references/workbuddy-compatibility.md](references/workbuddy-compatibility.md),使用项目内的官方 MCP直连客户端;`mcp_query.py`单工具路径已完成三份真实核价及一次换饮料核价。新版 `quote_meals.py`复用它的通信客户端,自动核价并比较完整计划。用户已授权使用其本机连接器查询核价时,可用 `--use-workbuddy-config`读取现有私有认证;不打印 Token、不修改配置。第一次失败后停止,不轮换参数探测。没有 Python或无法执行本地脚本时,明确说明该宿主暂不能完成核价,不用菜单价替代。
## 比较与输出
读取 [references/quote-format.md](references/quote-format.md) 了解本地数据格式。将成功核价结果归一化为整数分,使用 `scripts/compare_meals.py` 确定预算内排序、余量和超预算差额。宿主允许执行本地脚本时运行;否则直接按同样规则输出餐单表。
优先展示满足必选餐品且预算内的方案,再按应付价从低到高排列。相同餐品及选项只展示应付价较低的一份,说明所用优惠。结果是“本轮候选中更省钱”,不宣称全门店最优。
输出门店、到店取餐、核价时间,以及每份的餐品和数量、应付金额、预算余量、券或会员条件。没有预算内方案时列出最接近的方案和超额,不自动放宽需求。未核价或失败的候选单独注明。
批量入口使用新的 `--records-dir` 后,会自动生成 `comparison.json` 和 `meal-report.html`。告诉用户报告的完整本机路径,便于直接打开;报告只包含本轮有效餐单,打开页面不会发出请求。差价说明分别列出增加、减少和保持不变的实际餐品,不把整单差价说成单品价格。公开分享前由用户确认所选门店和餐品是否适合披露,不上传原始记录。
HTML或比较JSON导出失败属于本地文件问题,不将已经成功的报价当作失败,不因此重新调用核价。保留终端有效结果,按导出提示处理。已有 `comparison.json`时可用 `scripts/report_meals.py <比较JSON> --from-comparison --output <private内的新HTML路径>`离线恢复;这会保留原核价时间并标注历史结果,不能替代当前购买前的重新核价。
连接器名称可以不同于 `mcd-mcp`:直连客户端按官方地址匹配;多个匹配项时用 `--server-key`明确选择。认证失败、限流和网络错误按具体提示处理,不自动重试。本批量入口已完成三份真实核价、报告生成及换饮料重新核价;当次无可用券,不能视作带券案例验证。
用户说“不要可乐”“加个薯条”时,重新查必要的可替换选项,并对改动后的完整餐单重新核价。禁止用旧总价加减菜单价格代替重新核价。
本 Skill 只查询和核价,不调用创建订单、支付、领券、积分兑换或新增地址工具。用户决定后,给出便于在麦当劳官方渠道核对的餐单;结算价格以官方当前结果为准。
过敏相关请求不能靠标签推断安全,提示用户向门店核实。不要推断未返回的营养、配料和过敏原信息。
Discussion
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
From GitHub
- GitHub stars
- 1,329
- Maker
- Sam-Hui-dot
- License
- No license stated This repo states no license. By default the author keeps all rights: ask before you share it or use it commercially.
- Last code change
- Oct 24, 2026
- SKILL.md files in the repo (including translated copies and templates)
- 1
- Topics
- mcdonalds, mcp, python, skill, workbuddy