mcd-fries-pet skill
A fries-shaped desktop pet shows skill replies on McDonald's menu, calories, stores and coupons from the official MCP in bubbles.
- 116 ★ on the repository
- Last commit
Extended access
Why this level
- The background pet and supervisor register as macOS `launchd` jobs.
- The MCP token stays on the user's computer and goes to McDonald's.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/mcd-fries-petDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The background pet and supervisor register as macOS `launchd` jobs.
- The MCP token stays on the user's computer and goes to McDonald's.
This is third-party code. Review the repository files before installing.
What it does
The repository has two parts. The skill `skills/mcd-order-advisor/SKILL.md` asks McDonald's official MCP (`mcd-mcp`) for the live menu, nutrition data for about 160 dishes, stores and promotions, then assembles a meal for a calorie or budget target. The script `push_bubble.py` writes the result to `~/.mcd-pet/bubble.json`. The second part is the pet 麦麦, which polls that file every half second and shows the recommendation in a bubble. Variants include PySide6, native macOS Swift and a web version in HTML, plus the `watchdog.py` supervisor and `coupon_alert.py`, which notifies when a coupon becomes claimable but never claims it.
Who it is for. WorkBuddy and macOS users who want McDonald's meal picks shown by a lively desktop character.
Good fit when
- You must fit a 600 kcal limit and want two order options.
- You want the recommendation as a desktop bubble rather than in a chat window.
- An author builds a skill on McDonald's MCP and needs an example of a skill paired with a desktop widget.
- A user wants a notification when a coupon becomes claimable.
Not a fit when
- You need a working checkout: the skill only advises.
- The computer runs Windows or Linux: autostart targets macOS.
- You have no McDonald's MCP token.
Example request
Pick a dinner under 50 yuan at the nearest McDonald's, low sodium, and have the desktop pet say it.Limitations
This is an unofficial contest entry, not a McDonald's product. Data needs a token from `open.mcd.cn/mcp`, and the README says both `Authorization` and `authToken` headers are required or the answer is 403; WorkBuddy must be fully restarted after setup. The pet needs Python 3 and PySide6, and the supervisor and autostart use macOS `launchd`. No license is stated in the repository.
How to disable. Stop the pet and supervisor via `launchctl` labels `com.mcd.pet` and `com.mcd.pet.watchdog`, then delete the skill folder, the `mcd-mcp` connector and `~/.mcd-pet`.
FAQ
What runs the pet?
Install `python3 -m pip install PySide6` and run `python3 pet/麦麦-tk.py`. The pet runs separately from the skill and must stay running.
Does the script claim coupons itself?
No. `coupon_alert.py` only watches coupon states and sends a bubble and a macOS notification. Claiming a coupon stays a manual step.
What if the MCP returns 403?
Set both `Authorization` and `authToken` in the config, then fully quit and reopen WorkBuddy so tools reload.
How do I open the web version?
Open `pet/虚拟宠物-麦麦.html` in a browser. The page shows the animation but receives no messages from the skill.
Is Xcode needed for the native version?
Xcode Command Line Tools are required: the Swift version starts with the script `编译运行原生版.command`.
Discussion
No questions or reviews yet.
Related
SkillsDesktop pet with a CLI and a skill: an agent keeps sticky notes on the desktop while the console calls the McDonald's MCP service
MCP server of a desktop pet: session status, token usage, McDonald's and Luckin Coffee coupons and orders with confirmation
A skill that asks about your mood, assembles a McDonald's meal from the menu and places the order through MCP after you confirm.
McMates: a McDonald's China ordering skill with memory
mcd-1024-skill
A skill over the McDonald's China MCP: one order pick, memory of your past orders and a Big Mac price index across cities
McButler (mcd-self-butler)
mcd-self-butler
McButler works out calories and the full cost of an order, including travel and queue time, from the McDonald's China MCP
An unofficial skill for McDonald's China: a training plan, combo comparison by price and macros, order tracking and recaps
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| mcd-fries-pet (this card) | no | 116 | |
| mcd-desktop-pet | no | 91 | a pet with a console and stickers that calls the MCP; here the pet voices a calorie-based picker skill's recommendations |
| MCD Saver Strategist | no | 1,333 | computes order options and per-person price; this project covers calorie-based picks and desktop display |
README in short
The skill must not invent menus or prices: if the MCP is down it has to say so. Recommendations travel through the local `bubble.json` file.