mcd-budget-bite skill

Skill for McDonald's China orders: enumerates combos under budget and calorie caps and returns three plans

  • 124 ★ on the repository
  • Last commit
Skill

Extended access

Why this level

  • Uses a McDonald's China MCP token to read menus and prices.
All reasons and checks

tttmc/mcd-budget-bite

Install

Works in

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/mcd-budget-bite

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Uses a McDonald's China MCP token to read menus and prices.

This is third-party code. Review the repository files before installing.

What it does

The skill works on top of McDonald's China MCP. The user names two limits: a budget ceiling and a calorie ceiling. The solver enumerates all feasible combinations and returns three plans: the most filling, the cheapest and the most balanced. The decision stays with the person. Each plan carries calorie hints and a value ladder: calories and protein per yuan. Combo meals are split into parts and nutrition is summed. Items with missing data are flagged and excluded, never guessed. Demo page data was captured from the MCP for one restaurant in Shanghai on 10 October 2026. On `docs/index.html` the budget and calorie sliders recompute plans with no token or network, and the logic was checked against the command-line version on six scenarios.

Who it is for. People who order from McDonald's China and count money and calories together, for example while cutting weight.

Good fit when

  • Lunch is capped at 30 yuan and the best combination must be chosen.
  • An order of at most 700 kilocalories and no wasted spending is needed.
  • You want to compare which items give more protein per yuan.
  • The page should open locally with no token and no network.

Not a fit when

  • You need to place and pay for an order: the skill only selects.
  • You are outside China: restaurants and menus are tied to McDonald's China MCP.
  • An MCP token cannot be obtained.

Example request

I have 25 yuan and at most 700 kilocalories for lunch at McDonald's. Show three plans and the value ladder.

Limitations

Live data needs a McDonald's China MCP token from open.mcd.cn (phone number login), passed through the `MCD_MCP_TOKEN` variable or the `mcp-config.example.json` file. Without a token only the demo page works, on a menu snapshot of one restaurant from 10 October 2026: prices and contents elsewhere and at other times may differ. The skill targets WorkBuddy and the description is in Chinese. Items with missing data are excluded, so some dishes may be missing from plans. The repository does not state a license.

How to disable. Delete the skill folder from the skills directory and remove `MCD_MCP_TOKEN` from the environment. Revoke the token at open.mcd.cn if needed.

FAQ

How can I try it without a token?

Open `docs/index.html` in a browser: the page is standalone, needs no network and places no orders.

How do I get a token?

Go to open.mcd.cn/mcp, sign in by phone number, open the console and click activate.

What are the three plans?

The most filling, the cheapest and the most balanced. The final choice stays with the user.

What about uncertain data?

Missing items are flagged and excluded and values are not estimated.

How does it differ from coupon searching?

It solves a task with two constraints at once, budget and calories, and goes beyond saving on discounts.

Discussion

No questions or reviews yet.

Skills

A skill on the McDonald's China MCP: turns a budget and wishes into up to three menus with official prices, leftover budget and coupon terms

SkillExtended access1.3KRepository stars

A skill that plans a China McDonald's order under a budget and sodium limit, checks store coupons and never orders.

SkillMinimal access582Repository stars

A skill for ordering at McDonald's China: two gates, price and calories, and three combinations that pass both.

SkillExtended access109Repository stars

Skill for McDonald's China by calories and protein: computes nutrition per ingredient and finds the cheapest combos

SkillBroad access123Repository stars

An unofficial skill for McDonald's China: a training plan, combo comparison by price and macros, order tracking and recaps

SkillBroad access118Repository stars

A skill and CLI for the McDonald's China menu: three meal options for a budget, with nutrition and a source for every figure

SkillMinimal access121Repository stars

README in short

The project combines a skill, a Python solver and a standalone demo page whose logic is checked by `scripts/verify_demo.js`.

README badge

Original SKILL.md

---
name: mcd-budget-bite
description: 麦麦预算餐盘。在预算上限与热量上限双重约束下,求解麦当劳最优点餐组合,输出最饱型/最省型/最均衡型三套方案、热量贴士与每元性价比天梯榜。当用户说「XX块能吃啥麦当劳」「预算30元点麦当劳」「麦当劳怎么点最划算」「减肥期吃麦当劳怎么点」「帮我算一下这顿多少大卡」时使用。
---

# 麦麦预算餐盘(mcd-budget-bite)

给我一个预算,还你一份「吃得饱、花得值、热量心里有数」的麦当劳组合。

## 何时使用

用户给出预算、热量上限,或表达「想吃麦当劳但不想花太多/怕长胖」时启用。典型说法:

- 「30 块能吃啥麦当劳」
- 「预算 25,热量别超 700 大卡」
- 「减脂期吃麦当劳怎么点」
- 「麦当劳怎么点最划算」
- 「帮我算一下巨无霸三件套多少大卡」

## 工作流程

### 1. 收集约束(缺什么问什么,但一次最多问两个问题)

| 参数 | 默认值 | 说明 |
|---|---|---|
| 预算上限 | 必问 | 用户不主动给就直接问 |
| 热量上限 | 800 kcal | 用户没说就用默认,并在输出里注明 |
| 忌口 | 无 | 如「不要酸黄瓜」「不要香菜」 |
| 就餐方式 | 到店自提 | 外送需先查配送地址 |

### 2. 依次调用麦当劳 MCP

```
now-time-info        → 判定早餐/正餐时段,决定取哪套菜单
query-nearby-stores  → 定位门店(到店自提 beType=1)
query-meals          → 拉取当前门店可售菜单
list-nutrition-foods → 拉取营养数据
query-meal-detail    → 拆解套餐 / 解析杯型默认规格
calculate-price      → 对最终候选复核真实应付价
```

门店查询注意:`query-nearby-stores` 的 `searchType=2` 必须同时传 `city` 和 `keyword`,
只传一个会返回 600058「城市名或者关键词不能为空」。

### 3. 求解

```bash
export MCD_MCP_TOKEN=<用户的 token>
python scripts/solve.py --store <门店编码> --budget 30 --kcal 800
```

Report a problem