Mcd Budget Meal logo

Mcd Budget Meal

Community
Sam-Hui-dot
mcd-budget-meal

使用麦当劳中国 MCP,为单人到店取餐查询菜单、核对当前门店优惠并比较预算内餐单。适用于“30元吃什么”“保留汉堡换饮料”等点餐决策请求。

Overview

PublisherSam-Hui-dot
Repositorymcd-budget-meal
Skill namemcd-budget-meal
Stars
908
Forks
43
Bundled files
8
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • 8 bundled files

    Scripts, templates, and references the model can read while it works. Files are read-only and never executed.

  • Open source

    Published by Sam-Hui-dot on GitHub. Read the source before you install it.

Installation

Install the Mcd Budget Meal AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/Sam-Hui-dot/mcd-budget-meal/tree/main/skills/mcd-budget-meal
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/Sam-Hui-dot/mcd-budget-meal.git /tmp/mcd-budget-meal
mkdir -p .claude/skills
cp -r /tmp/mcd-budget-meal/skills/mcd-budget-meal .claude/skills/mcd-budget-meal
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Mcd Budget Meal in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Mcd Budget Meal on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Mcd Budget Meal is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

麦麦预算餐

让用户用一句话获得少量可选择的餐单,每份给出实际餐品、官方核价、预算余量和优惠条件。使用用户本机已启用的麦当劳 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,将最多三份完整核价参数与对应组成写到私有餐单计划,用 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,使用项目内的官方 MCP直连客户端;mcp_query.py单工具路径已完成三份真实核价及一次换饮料核价。新版 quote_meals.py复用它的通信客户端,自动核价并比较完整计划。用户已授权使用其本机连接器查询核价时,可用 --use-workbuddy-config读取现有私有认证;不打印 Token、不修改配置。第一次失败后停止,不轮换参数探测。没有 Python或无法执行本地脚本时,明确说明该宿主暂不能完成核价,不用菜单价替代。

比较与输出

读取 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 只查询和核价,不调用创建订单、支付、领券、积分兑换或新增地址工具。用户决定后,给出便于在麦当劳官方渠道核对的餐单;结算价格以官方当前结果为准。

过敏相关请求不能靠标签推断安全,提示用户向门店核实。不要推断未返回的营养、配料和过敏原信息。

Bundled files

The model reads these on demand while the skill is loaded. They are exposed as readable files and are never executed.

Frequently asked questions

What does the Mcd Budget Meal AI skill do?

使用麦当劳中国 MCP,为单人到店取餐查询菜单、核对当前门店优惠并比较预算内餐单。适用于“30元吃什么”“保留汉堡换饮料”等点餐决策请求。

Why use Mcd Budget Meal on TypingMind?

Because you install it once and use it with any model. Mcd Budget Meal is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Mcd Budget Meal in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/Sam-Hui-dot/mcd-budget-meal/tree/main/skills/mcd-budget-meal. TypingMind reads its SKILL.md and bundles its files and installs it as a skill you can enable per chat.

Which AI models can use Mcd Budget Meal?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Mcd Budget Meal?

As many as you like. As long as a model supports skills, you can use Mcd Budget Meal with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Mcd Budget Meal AI skill free?

It is published on GitHub by Sam-Hui-dot. Check the repository for licensing terms. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇