在 Claude Code、WorkBuddy、Cursor 等 AI agent 里发这段话,它会自己装好:
帮我安装并接入「麦麦交易终端」:https://github.com/Zhangfengmo/mcd-terminal
按 README 安装 mcd 并运行 mcd skill install;然后让我去 https://open.mcd.cn/mcp 复制 Token,运行 mcd login 粘贴。
之后直接说需求就行,比如:
- “帮我点个巨无霸和拿铁,怎么省怎么来”
- “积分快过期了,换点什么最划算?”
- “周末给孩子办生日派对,我们 6 个人,约哪场最稳?”
扣积分、下单、抽奖、预约前,AI 都会先问你;付款由你自己扫码。
1. 安装(不需要 Python)
# macOS / Linux / WSL(国内网络;海外去掉 https://gh-proxy.com/)
curl -fsSL --max-time 60 https://gh-proxy.com/https://github.com/Zhangfengmo/mcd-terminal/releases/latest/download/install.sh | bash# Windows PowerShell(国内网络;海外去掉 https://gh-proxy.com/)
irm https://gh-proxy.com/https://github.com/Zhangfengmo/mcd-terminal/releases/latest/download/install.ps1 | iex2. 登录:在 麦当劳 MCP 开放平台 用手机号登录,「控制台 → 激活」复制 Token,然后:
mcd login3. 点餐
mcd # 今日简报
mcd order 巨无霸 拿铁 --dry-run # 只看怎么付最省
mcd order 巨无霸 拿铁 # 确认后下单,手机扫付款码进 App 付款
mcd web # 网页版没有 Token 也能先体验:命令后加 --demo。
- 点餐最省:每样餐品在现金、已有券、积分换券里选最省的组合,下单前实时核价。支持自取、外送、得来速、团餐和预约。
- 活动和派对:活动地图一览,活动餐品直接加购;派对按人数推荐最不怕凑不齐的场次,直接预约。
- 积分和券:到期提醒、快过期积分换什么最值、一键领券、积分抽奖、问卷奖券。
- 吃了多少:按真实订单统计今天、本周、本月的热量和营养。
- 提醒:券到期、活动、派对一键加进提醒事项或日历。
- 游戏厅:等餐时玩接薯条,餐好了自动提示取餐码;老虎机按预算和券摇出今天吃啥,每日猜价、麦麦签、麦麦人格可以分享给朋友。终端和网页都能玩。
以上功能在网页版(mcd web)里的样子:
- 常吃麦当劳、手上攒着券和积分的人
- 用 AI agent、想让 AI 帮忙点餐的人
- 给孩子办生日会的家长,和在意吃了多少的人
| 命令 | 做什么 |
|---|---|
mcd order 巨无霸 麦乐鸡x2 |
点餐(-n 只看不下单,-d 外送) |
mcd track / mcd orders |
订单进度和取餐码 / 最近订单 |
mcd portfolio / mcd spend --expiring |
我的积分和券 / 用掉快过期的积分 |
mcd party 生日派对 -c 上海 --people 6 |
派对场次和推荐,加 --book 预约 |
mcd calendar --map |
活动地图;mcd calendar 活动名 看能点什么 |
mcd stats |
吃了多少热量 |
mcd play |
游戏厅(mcd play fries --wait last 边等餐边玩) |
mcd config |
默认门店、地址、点餐方式 |
mcd web |
网页版 |
全部命令:mcd -h。
- 扣积分、下单、抽奖、预约前都会先问你,付款由你自己完成。
- Token 和设置只存在本机
~/.config/mcd-terminal/,mcd logout删除 Token。 - 安装包有 SHA-256 校验,网页版只在本机运行。
安装慢或卡住?
把 gh-proxy.com 换成 ghfast.top 再试;用了代理的话先 export https_proxy=http://127.0.0.1:<端口>。
提示 command not found: mcd?
重新打开终端,或执行 export PATH="$HOME/.local/bin:$PATH"。
到店自取用哪家店?
麦当劳 MCP 不支持 GPS 定位。默认依次用:上次的门店、App 收藏的门店、收货地址附近的门店。换店加 --city 成都 --near 天府三街,会记住。
怎么升级、卸载?
升级:重新运行安装命令。卸载:mcd logout,再删掉 ~/.local/bin/mcd、~/.local/share/mcd-terminal、~/.config/mcd-terminal。
给每样餐品选“现金 / 已有券 / 积分换券”,在积分预算内让实付最低,这是一个多选背包问题,引擎精确求解。演示里原价 ¥68.50 的一单,凭直觉用积分要付 ¥25.00,最优解是 ¥21.80。详见 原理剖析。
- 给开发者和 agent:SKILL.md · AGENTS.md · MCP_INTEGRATION.md
- 欢迎提 Issue 或 Pull Request;觉得有用就点个 Star。
- 本项目是麦当劳程序员创意开发大赛参赛作品,非官方产品,仅供个人非商业使用(参赛声明)。License: MIT

