claudeers.
// MCP Servers

mcd-commit-fuel

代码换麦麦:根据本地 git 提交与构建节奏,在 VS Code / Claude Code 状态栏给出麦当劳积分、优惠券与餐品推荐,基于麦当劳 MCP。代码不出本机,下单需确认。参赛作品,非麦当劳官方产品。

// MCP Servers[ cli ][ api ][ claude ]#claude#mcp-servers◷ MIT$open-sourceupdated about 1 month ago
Actively maintained
99/100
last commit about 1 month ago
last release about 1 month ago
releases 1
open issues 0
// star history

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up mcd-commit-fuel (git-clone project) into my current project.
Found on https://claudeers.com/mcd-commit-fuel
Repo: https://github.com/byfanx/mcd-commit-fuel
Homepage/docs: —
Detected install method: git-clone → git clone https://github.com/byfanx/mcd-commit-fuel
Category: mcp-servers. Platforms: cli, api.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or clone
git clone https://github.com/byfanx/mcd-commit-fuel

// compatibility

Platformscli, api
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageTypeScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

麦麦代码补给站(mcd-commit-fuel)

根据本地 git 提交与构建节奏,在 VS Code / Claude Code 状态栏给出麦当劳积分、优惠券与按餐段推荐的餐品。代码不出本机,下单需确认。

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

它做什么

在本地读取你的开发节奏,判断当前状态,只在合适的时候安静地给一句提示:

状态什么时候出现状态栏
空闲 / 专注中默认;30 分钟内提交 ≥ 2 次算专注,不打扰🍟 1200分 · 6券
构建等待构建或测试运行超过 3 分钟⏳ 构建中 · 收藏门店 3 张券可用
卡 bug20 分钟内测试连续失败 3 次,或 1 小时内 revert 2 次按餐段推荐,如下午 ☕ 下午茶?锡兰红茶 2kcal
刚发版30 分钟内打了 release tag(如 v1.2.0)🎉 发版了 · 请团队吃一顿?
收工今天有提交,且已空闲 90 分钟🧾 收工了 · 今日小票
  • 本月有积分即将过期时,状态栏会加上 ⚠过期。
  • 同一类提醒每天最多 2 次,超过后只显示积分和券数。
  • 3 天内到期、到店可用的券会在状态栏提示(如 🍟 1200分 · 6券 · 2张临期),点开后点击就能用这张券下单。
  • 餐品按餐段推荐(见下方按餐段推荐),所有推荐都附热量和营养信息。
  • Commit 小票:把今天的提交、测试、构建耗时换成一张字符画小票:
================================
    MCD COMMIT FUEL 今日小票
--------------------------------
日期                  2026-10-10
时间                       18:20
提交                        x 12
Revert                       x 1
测试             通过 8 / 失败 3
构建与测试耗时           14 分钟
--------------------------------
今日推荐                  苹果片
                         32 kcal
              蛋白质 0g · 钠 0mg
--------------------------------
积分                        1200
可用券                      6 张
================================
   代码不出本机 · 下单需确认
  • 点单、团餐和领券(VS Code):手动触发,弹窗二次确认后才会调用写接口,支付在麦当劳 App 中完成。
    • 点一份餐品:到店自取,可以选收藏门店,也可以按城市和门店名搜索,按当前餐段推荐。
    • 用券下单:在详情里点击一张到店可用的券。
    • 请团队吃一顿:团餐外送到你在麦当劳 App 中保存的地址,默认 2~4 人,也可以自定义人数。每人一个汉堡加一杯饮品,小食共享,确认框里列出人均热量和人均价格。没有地址时会提示先去 App 里添加。

按餐段推荐

先看餐品是否适合这个时间,再看热量。常点的排在最前;有收藏门店时只推荐这家店当前在卖的。薯条、甜品冰品和套餐不主动推荐。

餐段时间推荐每份热量上限
早餐06:00–10:30粥、豆浆、麦满分、咖啡500 kcal
午餐 / 晚餐11:00–13:30 / 17:30–20:00汉堡 + 饮品800 kcal(合计)
下午茶14:00–17:00红茶、咖啡、奶铁、派300 kcal
夜宵22:00–06:00轻食,不含咖啡因250 kcal
其他时段轻食和饮品250 kcal

目标用户

  • 每天在 VS Code 或 Claude Code 里写代码、也常点麦当劳的开发者。
  • 想及时用掉临期券和即将过期积分,又不想频繁切到手机 App 的人。
  • 发版后想请团队吃一顿、希望一步搞定团餐搭配的小团队负责人。

项目预览

VS Code 插件

插件详情页,安装后在扩展面板中查看。

VS Code 插件

状态栏:收工提醒

今天有提交、且已空闲 90 分钟后,状态栏提示查看今日小票,悬停可以看到提示。

状态栏:收工提醒

状态栏详情

点击状态栏打开:积分、临期券和常用操作。

状态栏详情

按餐段推荐点餐

按当前餐段从门店菜单推荐餐品,附热量和营养信息,★ 为常点。

按餐段推荐点餐

门店搜索

除了收藏门店,也可以按城市和关键词搜索门店。

门店搜索

全部可用的券

卡包里的全部券按到期日排序,点击即可用这张券下单。

全部可用的券

请团队吃一顿

团餐自动搭配后的下单确认,列出餐品、人均热量和人均价格。

请团队吃一顿

准备 token

本项目使用麦当劳 MCP(https://mcp.mcd.cn),需要你自己的 MCP token。

申请 token

  1. 打开麦当劳 MCP 开放平台:https://open.mcd.cn/mcp
  2. 点击右上角「登录」,用手机号完成验证登录。登录后右上角会变成「控制台」。
  3. 点击「控制台」,在弹窗中点击「激活」申请 MCP token。
  4. 阅读并同意服务协议。
  5. 申请成功后点击一键复制 token。

更多说明见官方的 麦当劳 MCP Server 使用指南。

配置 token

token 只保存在本机:

  • VS Code:运行命令 MCD Fuel: 设置 MCP token,粘贴 token,存入 VS Code SecretStorage。
  • 命令行 / Claude Code:设置环境变量 MCD_MCP_TOKEN,见下方"安装:命令行与 Claude Code statusline"。

token 相当于你的麦当劳账号凭证,可以查询积分、领券和下单。不要把它写进仓库或任何会被分享的配置文件;泄露后请在开放平台控制台重新申请。

安装:VS Code 插件

需要 VS Code 1.93 及以上。

  1. 从 Releases 下载 mcd-commit-fuel-vscode-<版本>.vsix(或按下方"开发"一节用 npm run release 自己打包)。
  2. 在扩展面板点 … → 从 VSIX 安装…,选择下载的文件。
  3. 运行命令 MCD Fuel: 设置 MCP token。状态栏右侧会显示积分和券数,点击查看详情。
命令说明
MCD Fuel: 查看详情积分、券和到期日、当前状态的推荐;点击一张券可以直接用券下单
MCD Fuel: 立即刷新立即拉取最新数据
MCD Fuel: 今日小票打开今日 Commit 小票
MCD Fuel: 点一份餐品(按餐段推荐,到店自取,需确认)选门店(收藏或搜索)→ 选餐品 → 算价 → 确认后下单
MCD Fuel: 请团队吃一顿(团餐外送,需确认)选人数 → 配送地址 → 门店 → 自动搭配 → 算价 → 确认后下单
MCD Fuel: 查看全部可用的券卡包里的全部券,按临期 / 到店可用 / 仅外送分组;点击到店可用的券直接下单(详情里的“查看全部 N 张券”也能进入)
MCD Fuel: 领取可领的券(需确认)先查询可领的券并在确认框列出,确认后领取,领完弹窗显示本次领到的券
MCD Fuel: 设置 / 清除 MCP token管理 token

插件会自动采集这些信号:vscode.git 的提交和 tag 变化、VS Code 任务(task)的开始和结束、终端里构建/测试命令的耗时和退出码(需要开启 shell integration)。

设置项(mcdFuel.*):pollMinutes(轮询间隔,默认 30,窗口失焦时暂停)、buildMinutes(默认 3)、dailyNudgeLimit(默认 2)、releaseTagPattern、lateNight、trackTerminal。

安装:命令行与 Claude Code statusline

需要 Node.js 22 及以上和 git。CLI 是一个单文件 mcd-fuel.mjs,没有其他依赖。

  1. 从 Releases 下载 mcd-fuel.mjs。

  2. 放到 PATH 里:

    # Linux / macOS / WSL
    mkdir -p ~/.local/bin
    mv mcd-fuel.mjs ~/.local/bin/mcd-fuel && chmod +x ~/.local/bin/mcd-fuel
    mcd-fuel --version
    

    Windows 上不需要改名,直接用 node C:\路径\mcd-fuel.mjs <命令> 运行。

  3. 在 shell 配置文件(如 ~/.bashrc、~/.zshrc)里设置 token,然后重新打开终端:

    export MCD_MCP_TOKEN=你的token
    
  4. 在 ~/.claude/settings.json 中加入(Windows 写成 node C:\\路径\\mcd-fuel.mjs statusline):

    {
      "statusLine": { "type": "command", "command": "mcd-fuel statusline" }
    }
    

    Claude Code 从启动它的终端继承环境变量,设置 token 后需要重新启动 Claude Code。

也可以从源码运行:git clone 后执行 npm install && npm run package:cli,生成的文件在 release/mcd-fuel.mjs。

statusline 只读本地缓存,不发网络请求;发现缓存过期时会在后台启动一次 mcd-fuel refresh,自己立即返回。

命令说明
mcd-fuel statusline给 Claude Code 用,输出一行状态
mcd-fuel refresh [--cwd 目录] [--force]采集当前仓库的提交和 tag 并刷新数据(只调用只读接口)
mcd-fuel receipt打印今日小票
mcd-fuel run -- <命令>运行构建或测试命令,并记录耗时和结果,退出码原样返回,例如 mcd-fuel run -- npm test

缓存目录

所有出口共用一份缓存 state.json(文件权限 0600):

环境默认位置
Linux / macOS / WSL~/.cache/mcd-commit-fuel(或 $XDG_CACHE_HOME/mcd-commit-fuel)
Windows%LOCALAPPDATA%\mcd-commit-fuel

可以用环境变量 MCD_FUEL_CACHE_DIR 指定。在 WSL 里用 CLI、在 Windows 里用 VS Code 时,两边默认不共享数据;想共享的话,在 WSL 中设置 MCD_FUEL_CACHE_DIR=/mnt/c/Users/<你的用户名>/AppData/Local/mcd-commit-fuel。通过 Remote - WSL 打开项目时,插件运行在 WSL 里,会自动与 CLI 共用 ~/.cache。

隐私与安全

  • 代码、diff、commit message、仓库名、作者邮箱都不会离开本机。commit message 只在本地用来判断是否 revert,判断后即丢弃。
  • 终端命令只记录类别(构建 / 测试)、耗时和退出码,不记录命令内容;其他命令不记录。
  • 发送给麦当劳 MCP 的只有接口参数(如门店编码、商品编码、配送地址 ID)。团餐只显示脱敏后的配送地址,不展示、不缓存姓名和电话。
  • 自动刷新只调用只读接口;领券、下单只能手动触发,并需要在确认框中再次确认。不接入抽奖和积分商城兑换。
  • VS Code 中不受信任的工作区不读取 git 记录。
  • MCP 客户端配置示例见 mcp-config.example.json,只包含环境变量占位符。

开发

npm install
npm test                 # 编译并运行全部单测(node:test)
npm run release          # 打包单文件 CLI 和 VS Code 插件,输出到 release/
MCD_MCP_TOKEN=... npm run smoke   # 用真实 token 调用全部只读接口,只打印摘要
目录内容
packages/coreMCP 客户端、只读 API、信号与状态机、推荐、缓存与刷新、小票、领券与点单,无运行时依赖
packages/climcd-fuel 命令行
packages/vscodeVS Code 插件,esbuild 打成单文件

相关文档

// faq

What is mcd-commit-fuel?

代码换麦麦:根据本地 git 提交与构建节奏,在 VS Code / Claude Code 状态栏给出麦当劳积分、优惠券与餐品推荐,基于麦当劳 MCP。代码不出本机,下单需确认。参赛作品,非麦当劳官方产品。. It is open-source on GitHub.

Is mcd-commit-fuel free to use?

mcd-commit-fuel is open-source under the MIT license, so it is free to use.

What category does mcd-commit-fuel belong to?

mcd-commit-fuel is listed under mcp-servers in the Claudeers registry of Claude-compatible tools.

25 views
★ 20 stars
unclaimed
updated about 1 month ago

// embed badge

mcd-commit-fuel on Claudeers
[![Claudeers](https://claudeers.com/api/badge/mcd-commit-fuel.svg)](https://claudeers.com/mcd-commit-fuel)

// retro hit counter

mcd-commit-fuel hit counter
[![Hits](https://claudeers.com/api/counter/mcd-commit-fuel.svg)](https://claudeers.com/mcd-commit-fuel)

// reviews

// guestbook

0/500

// related in MCP Servers

🔓

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete…

// mcp-serversf/⟨HTML⟩★ 177,810◷ NOASSERTION[ claude ]
🔓

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

// mcp-serversfarion1231/⟨Rust⟩★ 155,814◷ MIT[ claude ]
🔓

🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman

// mcp-serversJuliusBrussee/⟨JavaScript⟩★ 117,780◷ MIT[ claude ]
🔓

An open-source AI agent that brings the power of Gemini directly into your terminal.

// mcp-serversgoogle-gemini/⟨TypeScript⟩★ 108,744◷ Apache-2.0[ claude ]
→ see how mcd-commit-fuel connects across the ecosystem