🍟 麦麦交易终端

帮你点麦当劳最省的 Skill

自动叠加优惠券、积分和门店活动，实时核价，算出这一单怎么付最划算。

让 AI 帮你点，或者自己在终端里点，都行。

快速开始 · 网页版 · 功能 · 原理剖析 · 作为 Skill 使用 · 使用示例 · 常见问题 · 反馈与参与

快速开始

1. 安装（一行命令，不需要 Python）

# macOS / Linux / WSL · 国内网络
curl -fsSL --max-time 60 https://gh-proxy.com/https://github.com/Zhangfengmo/mcd-terminal/releases/latest/download/install.sh | bash

# macOS / Linux / WSL · 海外网络
curl -fsSL --max-time 60 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 | iex

2. 登录：在 麦当劳 MCP 开放平台 用手机号登录，点「控制台 → 激活」复制 Token，然后：

mcd login

3. 开始用

mcd                                   # 今日简报
mcd order 巨无霸 中杯拿铁 --dry-run     # 看看怎么付最省（不下单）

想省事可以先把默认设置好，之后点餐什么都不用填（不设也行，第一次点餐会自动选上次去过的店）：

mcd config store --city 上海 --near 人民广场   # 默认门店
mcd config mode delivery                      # 默认外送（需要先 mcd address add 加一个地址）
mcd config                                    # 看看现在的设置

还没有 Token？所有命令都可以加 --demo，用演示数据先逛一圈。

网页版：mcd web

终端不够直观的时候，运行 mcd web（或 mcd w），浏览器里会打开同一套功能：

• 活动地图：麦当劳的活动按类型分布在上新广场、优惠大街、早餐小镇、咖啡山丘、派对乐园和周边玩具铺几座小岛上，今天在做的、即将开始的一眼就能看出来；带周边或玩具的活动单独标出，路的尽头是积分抽奖的奖池。生日派对、亲子活动这些要报名的体验活动也在这里。
• 点餐：门店菜单带图片，点几下加进购物车，右边的小票实时算出每样怎么付最省，确认后下单，手机扫码付款，再看出餐进度和取餐码。
• 我的券和积分：按到期时间排的倒计时，快过期的标红；抽中的奖品也在这里。
• 积分商城：商品按“每积分值多少钱”排好，一键算清仓方案。
• 我的设置：右上角能看到现在用的是哪家门店、送到哪个地址；点餐方式、门店、收货地址、积分用法、堂食外带都在这里改。新增地址会先检查手机号、城市和门牌号，同一个地址不会重复添加。

不错过任何一个日子：活动、券和积分到期、派对场次，都可以一键“提醒我”。在 Mac 上直接加进系统的提醒事项（列表「麦麦提醒」）；在 Windows 和 Linux 上生成一个带闹钟的日历文件，用 Outlook、系统日历打开就能导入。终端里也一样：

mcd remind coupons                     # 7 天内到期的券，到期当天 10 点提醒
mcd remind points                      # 快过期的积分，月底前 3 天提醒
mcd remind campaign -t 麦旋风          # 某个活动，下一个活动日提醒
mcd party 生日派对 -c 上海             # 生日派对还有哪些门店、哪天几点可以约

网页只在你自己的电脑上运行（只监听 127.0.0.1），Token 不会发给网页；扣积分、下单前一样会先问你。没有 Token 可以先用 mcd web --demo 看看。

功能

原理剖析

一句话点餐背后，是十几次麦当劳 MCP 调用加一个组合优化：

%%{init: {"flowchart": {"wrappingWidth": 320}}}%%
flowchart LR
    A["你：mcd order<br/>巨无霸 拿铁 薯条 麦乐鸡"] --> B["收集信息<br/>门店 · 菜单 · 已有券<br/>积分 · 积分商城 · 活动"]
    B --> C["优化<br/>每件商品选：现金 /<br/>已有券 / 积分兑券"]
    C --> D["实时核价<br/>门店活动 · 配送费"]
    D --> E["加购建议<br/>快过期的券 · 剩余积分"]
    E --> F{"你确认？"}
    F -- 好 --> G["兑换积分 → 下单<br/>→ 支付链接"]
    F -- 先不了 --> H["什么都不发生"]

为什么要算，而不是凭直觉？ 演示里这单原价 ¥68.50，手上有 1,880 积分和两张券（薯条、麦乐鸡）：

券和积分要放在一起考虑，局部最划算不等于整单最划算。引擎把它建模成带约束的多选背包问题，精确求解，并和暴力枚举对拍了 300 组随机购物车。模型、算法、AI 调用时序和安装安全链路的完整说明，见 原理剖析。

目标用户

• 常吃麦当劳、手上攒着券和积分的人：不用再自己算哪张券配哪样、积分该换什么，也不会让它们过期浪费。
• 用 AI agent 的人：装上这个 Skill，让 Claude Code、WorkBuddy 等 agent 帮你点餐。最优付法由引擎精确计算，不靠 AI 心算；扣积分、下单前都会先征得你的同意。
• 喜欢在终端里解决问题的程序员：写着代码，一条命令就把午饭点了。

作为 Skill 使用

仓库根目录的 SKILL.md 就是这个 Skill，它告诉 agent 什么时候用、怎么调用引擎、怎么向你确认。装好之后，直接对 agent 说“帮我点个巨无霸和拿铁，怎么省怎么来”就行。

agent 调用时都加 --json，输出单个 JSON 对象。会扣积分或下单的命令，不加 --yes 只返回方案，必须先得到你的同意。开发细节见 AGENTS.md。

使用示例

懒得打全称？ 常用命令和参数都有简写，mcd -h 随时查：

mcd o 巨无霸 麦乐鸡x2 -n      # = mcd order 巨无霸 麦乐鸡x2 --dry-run
mcd o 巨无霸 -d -y            # 外送，跳过确认直接下单
mcd t                         # = mcd track

放心用

• 扣积分、下单和取消订单前都会先问你，付款始终由你自己打开链接完成。
• 默认设置只存在本机 ~/.config/mcd-terminal/prefs.json：门店编码、地址 ID 和几项偏好，不含 Token，mcd config reset 清空。
• Token 只留在你的电脑上：保存在 ~/.config/mcd-terminal/token（仅本人可读），只发送给麦当劳 MCP，mcd logout 即可删除。
• 安装包强制校验：每个安装包的 SHA-256 在发布时就写进了安装脚本，下载、校验或解压任何一步失败都不会安装。
• 积分估值和热量仅供参考，实际以门店为准。

常见问题

国内访问 GitHub 下载经常很慢，所以国内请用带 gh-proxy.com 的那条命令。安装脚本还会同时测速 GitHub 和几个加速镜像，从最快的下载并显示进度条，哪个来源卡住就自动换下一个。镜像只提供安装包，文件若被篡改，校验通不过会被丢弃。

不同地区、不同运营商能用的镜像不一样。如果 gh-proxy.com 在你的网络里连不上，把命令里的 https://gh-proxy.com/ 换成 https://ghfast.top/ 再试。如果你用了代理工具，记得终端默认不走代理，需要先 export https_proxy=http://127.0.0.1:<端口>。

程序装在 ~/.local/bin/mcd（Windows 是 %LOCALAPPDATA%\mcd-terminal），安装脚本已经把它写进了 PATH，但对已经打开的终端不起作用。重新打开一个终端，或者执行 export PATH="$HOME/.local/bin:$PATH"。

• 升级：重新运行一次安装命令。
• 卸载：mcd logout 删除 Token，然后删掉 ~/.local/bin/mcd、~/.local/share/mcd-terminal 和 ~/.config/mcd-terminal。
• 只用 GitHub、不走镜像：在 bash 前加 MCD_MIRROR=none。
• 用 Python 安装：pipx install git+https://github.com/Zhangfengmo/mcd-terminal.git。
• 想先看看安装脚本的内容：把命令里的 | bash 去掉。

参考 mcp-config.example.json，Token 用环境变量 MCD_MCP_TOKEN 提供。本项目用到了哪些 MCP 能力，见 MCP_INTEGRATION.md。

反馈与参与

非常欢迎提 Issue，哪怕只是一句话：

• 🐛 用着不顺：报错、算出来的价格和门店对不上、哪一步让你犹豫了，都可以说。贴上命令和输出会更好排查（记得把 Token、手机号和地址遮掉）。
• 💡 想要新功能：比如想让它记住你的口味、支持某种点餐方式，或者希望 AI agent 能多做哪一步。
• 🍟 分享你的省钱方案：用它省下了多少、有什么券和积分的组合是它没想到的，都欢迎来聊。

也欢迎直接提 Pull Request。如果它帮你省了钱，点个 ⭐ 就是最好的鼓励。

更多

• MCP_INTEGRATION.md：用到的麦当劳 MCP Server、31 个工具、调用流程、真实服务端的兼容细节和业务价值
• SKILL.md · AGENTS.md：给 AI agent 的使用指南
• 本项目是麦当劳程序员创意开发大赛的参赛作品，并非麦当劳官方产品，仅供个人非商业使用。参赛声明见 CONTEST_DECLARATION.md。
• License: MIT