How do I install Mcd Git?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Mcd Git need an API key?

No required environment variable is listed on this record.

What transport does Mcd Git use?

Mcd Git runs locally over stdio.

When was Mcd Git last checked?

Last checked 2026-10-27. 用 git 命令点麦当劳：add 放购物车，rebase 凑最省，push 确认后才下单；card 生成 1024 吃麦贡献图（3D 汉堡天际线 / 年度小票）。基于麦当劳 MCP Server，附 --demo 无 Token 试玩和 Agent Skill。非官方参赛作品。

เซิร์ฟเวอร์ MCP Mcd Git

mcd-git · 用 git 命令点麦当劳

mcd-git add 放进购物车，mcd-git rebase 自动凑套餐、挑最省的券，mcd-git push 才真正下单，终端里直接出支付二维码；需要 Git 子命令语义时也可使用 git mcd。基于麦当劳中国 MCP Server（mcp.mcd.cn）。

git mcd 演示：status → add → diff → rebase → commit → push 出二维码 → log --graph

动图和下面所有截图都是 --demo 合成数据：门店、价格、订单号、券都是编的，支付链接指向 example.com。

一套引擎，两个入口

开发者：在终端里优先敲 mcd-git，人工操作和命令补全都以它为推荐入口。git-mcd 在 PATH 里时，也可以使用 Git 的 git mcd … 子命令语义；它不会碰你代码仓库的 .git。
普通用户：把 SKILL.md 装进 WorkBuddy / Claude Code / Kiro，用大白话点餐，Agent 在后台跑 git mcd --json。

一段 Agent 对话（demo 数据）：

你：   中午想吃巨无霸，不要酸黄瓜，再来中薯条和中可乐。12:20 去店外取餐柜拿，不要餐具，看看怎么最省。

Agent：（git mcd add 巨无霸 中薯条 中可乐 --no-pickle --json → git mcd rebase --json → git mcd diff --json）
       三样正好凑成巨无霸套餐，再用一张「示例·巨无霸套餐立减 5 元」：¥45.50 → ¥33.50。
       （git mcd commit -m 午饭 --json → git mcd push --at 12:20 --locker --no-tableware --json）
       门店 演示·代码港店 · 外带·店外取餐柜 · 预约 12:20 · 不要餐具
       巨无霸套餐 [巨无霸 · 中薯条 · 中可乐] 去酸黄瓜，应付 ¥33.50。要下单吗？付款需要你自己完成。

你：   确认。

Agent：（git mcd push --at 12:20 --locker --no-tableware --confirm bfc651c --json）
       下好了，请在 12:05 前打开这个链接付款：https://example.com/mcd-git-demo/pay?orderId=1024…
       付完跟我说一声，我帮你查取餐码。

和普通 Skill 的区别：确认由代码强制执行。 普通 Skill 只是一段提示词，Agent 手里有 MCP 连接器就能随时直接调 create-order。mcd-git 的 Skill 不需要给 Agent 配 MCP 连接器，Token 只给 mcd-git 用，Agent 手里只有 git mcd 这一套命令：下单必须先出确认摘要，再用 --confirm <commit 哈希> 执行；哈希、参数、重新算出的应付金额，任何一项和预览时对不上，代码都会拒绝。代码保证的是这三件事：一定先出预览，确认时不能换参数，价格会复核。至于 Agent 有没有先把摘要拿给你看、等你点头，代码分辨不出来，这一步靠 SKILL.md 的规则约束 Agent。

1024 特别版：生成你的吃麦贡献图

麦门天际线：过去一年吃麦贡献图（demo 合成数据）

把吃麦记录（最多过去一年）画成一张卡片，有三种样式，用 --style 选：

麦门天际线（skyline，默认）：等距 3D，最多 53 周 × 7 天，每天吃了几次就叠几层汉堡（底面包、肉饼、芝士、生菜、顶面包），超过 4 层只画 4 层、顶上标一个「+」；10-24 那格插一面「0x400」小旗。打开时汉堡按周从左到右落下叠好，只播一次、3 秒内停在完整状态，系统开了「减弱动态效果」就直接显示完成状态。默认深色夜景，浅色模式下换成奶油底。宽版，适合贴在 GitHub 个人主页。
年度吃麦小票（receipt）：竖版热敏小票，最常点 TOP 5 当商品行，中间一块点阵热力图（红圈是 10-24），下面是时段分布、TOTAL 和一根装饰条形码。适合发朋友圈、小红书。
平面格子（grid）：GitHub 风格的 7 行 × 53 周格子，颜色深浅表示那天吃了几单，10-24 那格单独描边。最朴素，放进文档里也不扎眼。

平面格子版吃麦贡献图（demo 合成数据）

真实卡片从你最早一单开始画（最少 12 周，最多 53 周），随使用越来越满：麦当劳接口只给最近 10 单，更早的要靠本机账本慢慢攒；10-24 不在画出来的这几周里时，天际线不插小旗、小票不画红圈（天际线底部那格「10-24 / Happy 0x400 Day」是 1024 特别版的固定标语，一直都在）。上面三张是 demo 一年的合成数据，所以是满的；平面格子固定画 53 周。

终端里先出预览（终端画不出 3D，天际线和格子都用格子预览；小票直接打印文字版），同时在本机写一个 SVG：自包含（不引用外部字体、图片和脚本，重复的图形用 <defs> + <use> 复用），跟着系统切换浅色 / 深色，二三十 KB。同样的数据每次生成的文件都一样。

mcd-git --demo card                    # 先用合成数据看看效果（上面这张就是），写到当前目录的 mcd-contributions-skyline.svg
mcd-git card                           # 用你自己的记录，默认麦门天际线，从你最早一单画起
mcd-git card --style receipt           # 年度吃麦小票，默认写到 mcd-contributions-receipt.svg
mcd-git card --style grid              # 平面格子，默认写到 mcd-contributions-grid.svg
mcd-git card -o ~/Desktop/mcd.svg      # 换个地方写
mcd-git card --with-savings            # 卡片上多一项「用券省下 ¥X」（默认不出现任何金额）

默认文件名按样式区分（mcd-contributions-skyline.svg / -receipt.svg / -grid.svg），三种样式各写各的、连跑两种不会互相覆盖；用 -o 指定路径时完全听你的。节前（今天还没到 10-24）卡片会把右边界提前延伸到 10-24 那一周，提前标出「即将到来的程序员节」（天际线插旗、小票红圈、格子描边），不用等到当天才看得到。

--with-savings 的数是下限：order-list 不返回优惠明细，只有 push 过或 show 过的单才知道省了多少。天际线和小票上有单缺明细时会写「只算有优惠明细的 N 单，是下限」，终端里也会提示。

贴到 GitHub 个人主页（全程在本机手动完成）：

建一个和用户名同名的仓库 <用户名>/<用户名>，GitHub 会把它的 README 显示在你的个人主页上；
在本机运行 mcd-git card -o <那个仓库的目录>/mcd-contributions.svg；
在那个仓库的 README.md 里加一行 <img src="mcd-contributions.svg" alt="过去一年吃麦贡献图">；
自己 git add、git commit、git push。

不要用 GitHub Actions 定时生成。 MCP Token 不能放进 CI（服务规则不允许把凭证托管到第三方平台），也不允许自动化调用。想更新就在本机再跑一次 mcd-git card。

卡片上有什么：日期级的格子（或汉堡、点阵）、总单数、最常点（小票是 TOP 5 和次数）、最常时段，以及数据范围（比如「数据：麦当劳最近 10 单 + 本机记录，最早到 2026-10-21」）。没有门店、地址、订单号、手机号、具体下单时刻和总消费；只有加了 --with-savings 才显示省下的钱。公开之前自己再看一眼。

数据从哪来：order-list 只返回最近 10 单，所以刚开始用时格子会比较空。mcd-git 会把看到的订单记进本机账本，用得越久越全；取消的和没付款的单不算。

本机订单账本：~/.config/mcd-git/ledger.json（demo 用的是另一份 ~/.config/mcd-git/demo/ledger.json），文件权限 600，只给吃麦贡献图当数据。log、cherry-pick、card 查 order-list 时顺手合并最近 10 单，show 顺手补上那一单的原价和优惠（同一单按订单号合并，新状态覆盖旧状态），push 下单成功时记一笔，并和那个本地 commit 关联起来。每单只存下单时间、状态、餐品名和份数、原价 / 优惠 / 实付、取餐方式；不存订单号原文（只存它的哈希）、门店、手机号、地址、取餐码、支付链接。删掉这个文件就清空了，不影响购物车和订单。

git 命令 ↔ 点餐动作

mcd-git / git mcd	点餐动作	会改动你的账户吗
`init`	选门店和取餐方式（到店 / 得来速 / 麦乐送），相当于设置远端	否
`status`	当前分支（按时段：breakfast / lunch / tea / dinner）、购物车、可用券、待支付订单	否
`ls-remote [关键词]`	看本店菜单：不带关键词按分类分组，超过一屏用分页器；价格是真实可得价，要随单购会员卡才有的优惠价另外注明	否
`add <餐品>`	放进购物车；`--no-pickle` 去酸黄瓜，`--with 少冰`，`--choose 大薯条`	否
`restore --staged <餐品>`	从购物车拿出来	否
`reset`	清空购物车；`reset ORIG_HEAD` 撤销 rebase；`reset --soft HEAD~1` 撤回没 push 的 commit	否
`diff`	像 unified diff 一样逐行看差价：菜单价 vs 应付，或用券前 vs 用券后	否
`rebase`	单品凑成套餐（squash）、换上最省的一张券（coupon），每个方案都真实算价	否
`commit -m <说明>`	锁定这一单：本地快照 + 核价，哈希由内容决定	否
`push`	真正下单，出支付链接和二维码；支持 `--at 12:20` 预约、`--locker` 取餐柜、`--no-tableware`、`--remark`、`--qr full/half/fancy[=名字]`	✎ 会，先确认
`log --graph`	吃麦提交历史，按时段画分支图	否
`log --stat`	吃麦统计：每单列出餐品、实付和省下的钱，最后汇总单数、金额、时段分布和最常点；支持 `-n`、`--since`、`--until`	否
`show [HEAD]`	订单状态、取餐码、取餐柜、外送进度（只在你运行时查一次）	否
`cherry-pick HEAD`	再来一单：把上一单拣回购物车，换了门店也会按新菜单重新对齐	否
`revert`	取消订单，必须选原因	✎ 会，先确认
`fetch`	今日活动、可领的券（只读）	否
`pull`	领券：先列出可领券，确认后一次领取全部（接口不支持只领几张）	✎ 会，先确认

所有命令都支持 --demo（合成数据，不需要 Token）和 --json（给 Agent 和脚本用）。人工对照表随时看：mcd-git help；git mcd help 仍保留为 Git 子命令兼容写法。

30 秒试玩，无需 Token

装了 uv 的话，一行就能跑：

uvx --from git+https://github.com/zhutoumeme/mcd-git mcd-git --demo status

想多玩几步，就装上它（需要 Python 3.9+）：

pip install "git+https://github.com/zhutoumeme/mcd-git"   # 或 uv tool install git+https://github.com/zhutoumeme/mcd-git

mcd-git --demo status
mcd-git --demo add 巨无霸 中薯条 中可乐 --no-pickle
mcd-git --demo diff
mcd-git --demo rebase
mcd-git --demo commit -m "发版前的午饭"
mcd-git --demo push --at 12:20 --locker --no-tableware   # 终端里会问 y/N
mcd-git --demo log --graph
mcd-git --demo log --stat                                # 吃麦统计：每单餐品、实付、省了多少，按时段汇总
mcd-git --demo show
mcd-git --demo cherry-pick HEAD
mcd-git --demo pull                                      # 领券，终端里会问 y/N
mcd-git --demo card                                      # 吃麦贡献图（麦门天际线），写到当前目录的 mcd-contributions-skyline.svg
mcd-git --demo card --style receipt                      # 年度吃麦小票，终端里也会打印一张

装完会有两个等价的命令：mcd-git（人工直接操作和补全的推荐入口）和 git-mcd（Git 会把 git mcd 分发给它）。demo 的状态单独放在 ~/.config/mcd-git/demo/，想从头再来就 mcd-git --demo init --pick 1。嫌每条都敲 --demo 麻烦，可以先 export MCD_GIT_DEMO=1（首屏动图就是这么录的）。

命令一览

init：选门店，相当于设置远端

不带参数列收藏门店；按地标搜要同时给城市和关键词：mcd-git init --city 南京 --keyword 新街口（只给其中一个，麦当劳接口都不认）。门店列表按终端宽度显示全名。接口一次大约只给 5 家，--limit 3 只列前 3 家（只在本地截取，不会多调接口）；想看别的店就换个更具体的地标。

mcd-git init

status：看看现在什么情况

git mcd status

add：放进购物车，顺手去掉酸黄瓜

git mcd add

diff：每一分钱花在哪儿

git mcd diff

rebase：凑套餐 + 挑券，省下来的才是真的

rebase 只在购物车里的单品正好能凑满套餐（主食、小食、饮料都在）时才 squash，绝不为了便宜往购物车里多塞东西。一单只能用一张券，而且券和账户自带的折扣可能互斥，所以每个方案都会真实调一次 calculate-price，每条命令最多 20 次。不满意就 mcd-git reset ORIG_HEAD。

git mcd rebase

commit：锁定这一单

git mcd commit

push：确认后才下单，出支付二维码

终端里先给确认摘要再问 y/N。Agent、管道或 --json 等非交互环境只出摘要，用户同意后用 --confirm <commit 哈希> 执行。mcd-git 只生成待支付订单，不会替你付款。二维码扫了直接拉起麦当劳 App 付款（和收银页里的码一样），默认用整格画法（每个模块两个带背景色的空格），各终端都扫得出；--qr half 用半块字符画，高度减半更紧凑，但部分终端（如 macOS Terminal.app）可能扫不出；终端太窄放不下整格时会自动退回半块并提示，拉宽窗口后运行 mcd-git show 可以重新出码。想要点花样可以 --qr fancy 画麦当劳主题码（麦门金配色 + 正中像素麦当劳元素 Logo，机器照样识别，终端太窄会自动退回普通码）——fancy 每次从汉堡、薯条、麦乐鸡、甜筒、派、金拱门 6 个图案里随机出一个，想固定某一个就写 --qr fancy=burger（也支持 fries / nuggets / cone / pie / arch）。扫不出来就直接打开下面的支付链接，或到麦当劳 App 订单页付款。

git mcd push

log --graph：吃麦提交历史

git mcd log --graph

log --stat：吃麦统计

像 git log --stat 一样，每单下面列出餐品行和一行小结（几样、实付、用券省了多少），最后像 diff --stat 一样汇总：几单（其中几单已取消、几单待支付）、几样、实付、省下的钱，再按早餐 / 午饭 / 下午茶 / 晚饭 / 夜宵画分布，列出最常点的前 3 名。已取消的单照常显示但不计入金额，待支付的单单独标出、也不计入。数据来自本机账本，运行时先调一次 order-list 刷新最近 10 单；-n 20 看更多，--since 2026-10-01 --until 2026-10-31 按日期筛（含当天）。order-list 不返回原价和优惠，没 push 或 show 过的单省了多少不知道，汇总里会提示有几单没算进去。不显示热量。

git mcd log --stat

show：取餐码在这里

git mcd show

cherry-pick HEAD：再来一单

git mcd cherry-pick HEAD

pull：领券，同样先确认

像 git pull 一样 fetch + merge：先列出麦麦省里可领的券，你确认后调一次 auto-bind-coupons 把它们领进账户。这个接口没有参数，只能一次领全部、不能只挑其中几张，所以摘要里会把要领的每一张都列出来。终端里回答 y 就立即领取，领的是那一刻的全部可领券，摘要放了很久的话先回答 N 再重新运行一次。非交互环境只出摘要，用户同意后再用 --confirm <指纹> 执行；确认时会重新拉一次列表，和预览时不一样就拒绝。没有可领的券时输出 Already up to date.。领到之后，下单前跑一次 mcd-git rebase 就会自动挑最省的那张。

git mcd pull

card：1024 吃麦贡献图

终端里一周一列：有颜色时一格一个小方块，管道和 NO_COLOR 下用 · ░ ▒ ▓ █ 分档。终端画不出 3D，默认的麦门天际线也用这份格子预览；卡片本身写成 SVG，见上面「1024 特别版」。

mcd-git card

--style receipt 在终端里直接打印一张文字小票：

mcd-git card --style receipt

help：对照表

对照表优先用 mcd-git help 看；Git 子命令兼容写法是 git mcd help、git mcd -h 和不带参数的 git mcd。注意不要写 git mcd --help：git 会把它拦截成 git help mcd 去找 man 手册。子命令的帮助优先写成 mcd-git push -h，git mcd push -h 仍可用。

git mcd help

命令补全

mcd-git completion <shell> 会生成补全脚本，子命令、选项、--qr / card --style 的取值以及餐品名都能按 TAB 补。人工在终端操作和补全时，mcd-git <TAB> 是保证支持、推荐的入口；git-mcd <TAB> 是等价兼容入口。git mcd <TAB> 只作为可选兼容：它依赖平台是否加载并转发 Git 自带补全脚本，不是 mcd-git 能保证的入口；PowerShell 尤其不保证 Git 转发。以下命令均只安装本机脚本，不访问 MCP。

macOS：Zsh（默认 shell）

# 安装：写入 ~/.zshrc；已有同一行时不要重复追加
printf '\n# mcd-git completion\neval "$(mcd-git completion zsh)"\n' >> ~/.zshrc
# 重载
source ~/.zshrc
# 测试（输入命令后按 TAB；--demo 不需要 Token）
mcd-git --demo <TAB>
mcd-git --demo add 巨<TAB>
# 可选：检查脚本能否生成
mcd-git completion zsh >/tmp/mcd-git.zsh

macOS：Bash 3.2

# 安装：macOS 自带 bash 3.2 也支持
printf '\n# mcd-git completion\neval "$(mcd-git completion bash)"\n' >> ~/.bash_profile
# 可选兼容：若要让 git mcd 也补，先加载 Git 自带补全（mcd-git 入口不依赖这一行）
source /Library/Developer/CommandLineTools/usr/share/git-core/git-completion.bash 2>/dev/null || true
# 重载
source ~/.bash_profile
# 测试
a=$(mcd-git completion bash); test -n "$a" && echo 'bash completion script: OK'
mcd-git --demo <TAB>

Linux：Bash

# 安装并写入 ~/.bashrc
printf '\n# mcd-git completion\neval "$(mcd-git completion bash)"\n' >> ~/.bashrc
# Git 自带补全通常由 bash-completion 提供；路径因发行版而异
if [ -f /usr/share/bash-completion/completions/git ]; then source /usr/share/bash-completion/completions/git; fi
# 重载
source ~/.bashrc
# 测试
mcd-git --demo <TAB>
mcd-git --demo add 巨<TAB>

若 Linux 没有 Git 补全，安装发行版的 bash-completion 后再 source 它；这只影响可选兼容入口 git mcd <TAB>，不影响保证可用的 mcd-git <TAB>。

Fish

# 安装
mkdir -p ~/.config/fish/completions
mcd-git completion fish > ~/.config/fish/completions/mcd-git.fish
# 重载当前 shell（或退出后重新打开 fish）
source ~/.config/fish/completions/mcd-git.fish
# 测试
mcd-git --demo add 巨<TAB>

git-mcd <TAB> 也会复用 mcd-git 脚本；若要尝试兼容入口 git mcd <TAB>，是否生效取决于 Fish 自带的 Git 补全是否转发它。

Windows：Git Bash

# 安装：写入 Git Bash 的 ~/.bashrc
printf '\n# mcd-git completion\neval "$(mcd-git completion bash)"\n' >> ~/.bashrc
# Git Bash 的 git-completion.bash 路径随安装位置变化，常见路径如下
[ -f /usr/share/bash-completion/completions/git ] && source /usr/share/bash-completion/completions/git
# 重载
source ~/.bashrc
# 测试：首选入口是 mcd-git；兼容入口 git mcd 需要 Git 自带补全已加载
mcd-git --demo <TAB>
mcd-git --demo add 巨<TAB>

Windows：WSL Bash

# 在 WSL 内执行，写入 WSL 用户自己的 ~/.bashrc
printf '\n# mcd-git completion\neval "$(mcd-git completion bash)"\n' >> ~/.bashrc
sudo apt-get update && sudo apt-get install -y bash-completion  # 只需安装一次
source /usr/share/bash-completion/bash_completion 2>/dev/null || true
# 重载
source ~/.bashrc
# 测试
mcd-git --demo <TAB>
mcd-git --demo add 巨<TAB>

WSL 与 Windows Git Bash 是两个独立的 shell 环境，各自安装、各自重载；mcd-git 必须在当前环境的 PATH 中。

Windows：PowerShell 5.1 / PowerShell 7

# 安装：先创建 profile 父目录和文件；带标记时重复执行不会重复追加
$profileDirectory = Split-Path -Parent $PROFILE
if ($profileDirectory) { New-Item -ItemType Directory -Path $profileDirectory -Force | Out-Null }
if (-not (Test-Path -LiteralPath $PROFILE)) { New-Item -ItemType File -Path $PROFILE -Force | Out-Null }
$marker = '# mcd-git PowerShell completion'
if (-not (Select-String -LiteralPath $PROFILE -SimpleMatch $marker -Quiet -ErrorAction SilentlyContinue)) {
    Add-Content -LiteralPath $PROFILE -Value $marker
    mcd-git completion powershell | Add-Content -LiteralPath $PROFILE -Encoding UTF8
}
# 重载当前 PowerShell
. $PROFILE
# 测试：输入后按 TAB
mcd-git --demo <TAB>
mcd-git --demo add 巨<TAB>

关闭 PowerShell 窗口并重新打开后 profile 会自动加载。若脚本因执行策略被阻止，可仅为当前用户允许本地脚本（可选排障）：

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
. $PROFILE

PowerShell 补全注册给 mcd-git 和 git-mcd；不保证 git mcd 的 Git 转发补全。PowerShell 里二维码取值会列出 fancy:burger 这种冒号形式；命令本身也接受与其他 shell 一致的 --qr fancy=burger，不要把补全显示的冒号误当成餐品名。

餐品名与离线边界：add、ls-remote 补本店菜单，restore --staged 补购物车。前缀匹配优先，包含匹配随后（输入「鸡腿」可列出麦辣鸡腿堡、板烧鸡腿堡）；多候选时只列出，不吞掉已输入文字。候选只读 ~/.config/mcd-git/menu-cache.json（Windows 默认 %APPDATA%\\mcd-git\\menu-cache.json），缓存 24 小时有效，换店需重新运行 mcd-git ls-remote。按 TAB 不联网；缓存缺失或过期时不调用 MCP，zsh 会提示先刷新菜单，bash / Fish / PowerShell 静默没有餐品候选。--demo 可先生成演示缓存。

二维码 fancy 的名字可写成 --qr fancy=burger；PowerShell 的候选列表也提供 fancy:burger，这是补全脚本为避免等号解析而显示的等价分隔形式。

git mcd 的补全仅是可选兼容，不是 mcd-git 自己能保证的：Zsh 通常由系统 _git 转调，Bash / Git Bash / WSL 需要先加载 Git 自带的 git-completion.bash，Fish 依赖其 Git 补全实现；没有这些配置时请使用保证支持的 mcd-git <TAB>。

接入真实账户（3 步）

申请 Token：在麦当劳 MCP 开放平台登录控制台，激活并复制 MCP Token。

放在本机：所有平台都首推环境变量 MCD_MCP_TOKEN；也可以写进配置文件。查找顺序是环境变量 MCD_MCP_TOKEN 优先，其次按平台找配置文件（$XDG_CONFIG_HOME/mcd-mcp/token → Windows 的 %APPDATA%\mcd-mcp\token → ~/.config/mcd-mcp/token，取第一个存在且非空的）。Token 只放在本机、只进请求头，不会被打印、写日志或写进仓库，也不会上传到别处。

macOS

# 长期使用：从剪贴板写进文件（Token 不会留在 shell 历史里）
mkdir -p ~/.config/mcd-mcp && pbpaste > ~/.config/mcd-mcp/token && chmod 600 ~/.config/mcd-mcp/token
# 临时使用：只在当前终端有效
export MCD_MCP_TOKEN=你的Token

Linux

# 长期使用：把 Token 写进文件（也可以从剪贴板，用 xclip -o 之类）
mkdir -p ~/.config/mcd-mcp && printf '%s' "你的Token" > ~/.config/mcd-mcp/token && chmod 600 ~/.config/mcd-mcp/token
# 临时使用：只在当前终端有效
export MCD_MCP_TOKEN=你的Token

Windows（PowerShell）

# 长期使用：写进用户环境变量，新开的终端生效
setx MCD_MCP_TOKEN "你的Token"
# 临时使用：只在当前终端有效
$env:MCD_MCP_TOKEN = "你的Token"
# 或者存成配置文件
New-Item -ItemType Directory -Force "$env:APPDATA\mcd-mcp" | Out-Null
Set-Content -NoNewline "$env:APPDATA\mcd-mcp\token" "你的Token"

也支持用 XDG_CONFIG_HOME 指定配置根目录（会在它下面找 mcd-mcp/token）。

选门店开点：mcd-git init 列收藏门店，或 mcd-git init --city 上海 --keyword 人民广场 按地标搜；得来速加 --mode drive，麦乐送用 --mode delivery。之后的用法和 demo 一模一样。

mcp-config.example.json 是比赛要求的脱敏配置示例，只有 ${MCD_MCP_TOKEN} 占位符。mcd-git 自己不需要它，想让其他 MCP 客户端直连时可以照着配。

只有 push、revert 和 pull 会改动你的账户，每次都会先出确认摘要；不会自动付款；没有后台任务、定时或轮询，每一次调用都由你的命令触发。

交给你的 Agent

把下面这段话原样发给 WorkBuddy / Claude Code / Kiro（Agent 需要能在本机执行命令）：

请帮我安装 mcd-git 这个点麦当劳的 Skill：
1. 运行 uv tool install git+https://github.com/zhutoumeme/mcd-git（没有 uv 就用 pip install "git+https://github.com/zhutoumeme/mcd-git"），然后运行 `mcd-git help` 确认装好了；
2. 把 https://github.com/zhutoumeme/mcd-git 仓库根目录的 SKILL.md 装进你的 Skill 目录（Claude Code 是 ~/.claude/skills/mcd-git/SKILL.md，Kiro 是 ~/.kiro/skills/mcd-git/SKILL.md，WorkBuddy 在「技能」里导入）；
3. 以后我说要点麦当劳，就按 SKILL.md 用 git mcd --json 操作。下单、取消和领券前必须把确认摘要给我看，我明确同意后才能加 --confirm。
Token 我会自己配置（环境变量 MCD_MCP_TOKEN，或配置文件；macOS/Linux 在 ~/.config/mcd-mcp/token，Windows 在 %APPDATA%\mcd-mcp\token），不用在对话里发给你。没有 Token 时先用 --demo 给我演示。

安全边界

写操作只有三个：create-order（push）、cancel-order（revert）、auto-bind-coupons（pull），都要经过确认闸：预览 → 用户同意 → --confirm。积分兑换、抽奖、派对订单、新建地址这些写操作，代码里一律拦截，不调用；确认闸签发的许可也只对它对应的那一个 tool 有效。
确认闸由代码执行：--confirm 必须对得上 10 分钟内的预览（同一个 commit、同样的参数）；真正下单前重新算价，应付金额和下单参数的指纹都要和预览时一致；pull --confirm 要对得上可领券列表的指纹，领之前重新拉一次列表，变了就拒绝；同一份确认只能用一次；push --force、pull --force 一律拒绝。
结果未知不重试：网络超时、响应不完整、返回看不懂、按了 Ctrl+C，这些情况都不会自动重发 create-order，会提示先 mcd-git log 核对，避免重复下单；pull 同样不会重发 auto-bind-coupons，会提示先 mcd-git status 或 mcd-git fetch 核对。
低频、手动：每条命令由你触发；领券每次都由你手动触发，只领你自己账户的券，不做定时或循环领取；calculate-price 每条命令最多 20 次，带缓存；遇到 429 只对只读请求退避重试。
隐私：Token 只在请求头里，只发给 https://mcp.mcd.cn（地址写死在代码里，不能用环境变量改）；收货地址只保留 addressId 和打码提示；状态文件在 ~/.config/mcd-git/（目录 700、文件 600），本机订单账本 ledger.json 也在这里，只存贡献图要用的字段（见「1024 特别版」）；给命令补全用的菜单缓存 menu-cache.json 也在这里，只有餐品 code、名称、类型和门店，按 TAB 只读它、不联网；card 生成的 SVG 只写在你的电脑上，mcd-git 不会替你上传。

目标用户

天天开终端的开发者：不想切到手机上凑券、比价，mcd-git status && mcd-git rebase 一气呵成。
想让 Agent 代点餐、但每一步都要看得见管得住的人：Agent 只能用带确认闸的命令，下单前一定会先出确认摘要，参数或价格一变就作废；先问你这一步由 SKILL.md 约束 Agent。
常点固定几样的人：mcd-git cherry-pick HEAD && mcd-git commit -m 再来一单 && mcd-git push 就是再来一单；预约、取餐柜、不要餐具一条命令说清楚。

它解决两件事：自己算「单点还是套餐、用哪张券」太费劲；把下单交给 Agent 又怕它自作主张。

FAQ

真的会下单吗？ 只有 push 并且你确认之后才会。生成的是待支付订单，付款要你自己在支付页或麦当劳 App 里完成。付款窗口是下单后 15 分钟（用真实账户实测过），不想要了就 mcd-git revert 取消。

会读写我的代码仓库吗？ 不会。mcd-git 不碰任何 .git 目录，状态只放在 ~/.config/mcd-git/。唯一会往别处写文件的是 card：只在你指定的位置写一个 SVG（默认当前目录的 mcd-contributions-<样式>.svg，比如天际线是 mcd-contributions-skyline.svg、小票是 mcd-contributions-receipt.svg），写完会显示完整路径（比如 已写入 ~/mcd-contributions-skyline.svg），--json 的 data.path 是绝对路径。

rebase 会不会为了省钱让我多吃？ 不会。只有购物车里的东西正好凑满一个套餐时才换，不会额外加任何餐品。

价格准吗？ 一切以 calculate-price 的实时结果为准。commit 时核一次价，push 预览和确认时各核一次，价格变了会拦下来让你重新确认。

去酸黄瓜、少冰这类特制一定生效吗？ mcd-git 只接受 query-meal-detail 里真实存在的选项，按 MCP 的参数格式传过去。但算价接口既不校验也不回显特制，真实订单里会不会照做还没实测过。下单后用 mcd-git show 核对子项名称，以门店实际出餐为准。

为什么一单只能用一张券？ 这是 MCP 的规则：两张券会返回「暂不支持多张券使用」（600022）。

log 为什么最多只有 10 单？ order-list 没有分页参数，只返回最近 10 单。log --stat 和 card 会再加上本机账本里记下的订单，用得越久越全。

show 会一直刷新订单状态吗？ 不会。只在你运行时查一次，不轮询。

没有 Token 能用吗？ 加 --demo 就行，全套命令都能离线体验。

路线图

P1：stash / stash pop 暂存购物车；rebase -i 手动挑方案；预约时段在本地先校验；餐品名拼音首字母补全（比如 jwb → 巨无霸）。
P2：ship --team 发版庆功的团餐方案（下单仍走 push）；push --at next-gap 读本地 .ics 找会议空档。

欢迎提 Issue 和 PR，新命令请保持「只读命令零副作用、写操作必须过确认闸」这条规矩。

声明

本项目是麦当劳程序员节创意开发大赛的参赛作品，由参赛者独立开发，非麦当劳官方产品。
项目输出仅供参考，不构成医疗、营养或其他专业建议。
餐品信息、价格及供应状态以麦当劳官方渠道的实时结果为准。

仓库里不使用麦当劳的 Logo、IP 形象或官方图片；终端截图和 --demo 夹具全部是合成数据。代码以 MIT 协议开源。

เพิ่มเซิร์ฟเวอร์นี้

Host a copy with our keys and logs.

Server facts

Tools

Questions