Skip to content
Back to search

mcctl

麦当劳中国 MCP 的命令行控制面:33 个官方 MCP 工具编排成 kubectl 式 CLI(人格测试/配餐/省钱/下单/积分)+ 麦麦派对策划师 + WorkBuddy Skill + 网页 Playground

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hulinkang9527--mcctl/badge.svg)](/listings/hulinkang9527--mcctl)

HTML

<a href="/listings/hulinkang9527--mcctl"><img src="/api/listings/hulinkang9527--mcctl/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 196 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="./docs/banner.png" alt="mcctl · 麦门的 kubectl" width="820" />
  3. </p>
  4. <h1 align="center">mcctl — 麦门的 kubectl</h1>
  5. <p align="center">
  6. <b>The kubectl for McDonald's China · 麦当劳中国 MCP 的命令行控制面</b>
  7. </p>
  8. <p align="center">
  9. <a href="https://hulinkang9527.github.io/mcctl/"><img alt="Play" src="https://img.shields.io/badge/%E2%96%B6%20%E6%89%8B%E6%9C%BA%E9%9B%B6%E5%AE%89%E8%A3%85-8%E9%A2%98%E6%B5%8B%E9%BA%A6%E9%97%A8%E4%BA%BA%E6%A0%BC-DA291C?style=for-the-badge"></a>
  10. <a href="https://github.com/hulinkang9527/mcctl/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/hulinkang9527/mcctl/actions/workflows/ci.yml/badge.svg"></a>
  11. <a href="https://github.com/hulinkang9527/mcctl/stargazers"><img alt="GitHub Stars" src="https://img.shields.io/github/stars/hulinkang9527/mcctl?style=social&label=Star"></a>
  12. </p>
  13. <p align="center">
  14. <img alt="Python" src="https://img.shields.io/badge/Python-3.10%2B-blue?logo=python&logoColor=white">
  15. <img alt="CLI MCP Tools" src="https://img.shields.io/badge/CLI%20MCP%20Tools-35-DA291C">
  16. <img alt="CLI" src="https://img.shields.io/badge/CLI-Typer%20%2F%20Rich-FFC72C">
  17. <img alt="Tests" src="https://img.shields.io/badge/tests-70%20passed-2E9E5B">
  18. <img alt="License" src="https://img.shields.io/badge/License-MIT-2E9E5B">
  19. <img alt="Unofficial" src="https://img.shields.io/badge/%E9%9D%9E%E5%AE%98%E6%96%B9-creative%20work-8A6410">
  20. </p>
  21. <p align="center">
  22. <img src="./docs/assets/playground.gif" alt="mcctl 网页 Playground:8 题测人格,生成可分享麦籍卡与好友匹配度" width="680" />
  23. <br /><sub>⬆ 10 秒真实流程:8 题测人格 → 麦籍卡 → 命定套餐 → 好友匹配度(网页为<b>离线演示</b>,预置数据)</sub>
  24. </p>
  25. ---
  26. ### 为什么用 mcctl,而不是又一个点餐网页?
  27. 普通点餐页只把菜单搬上屏幕;`mcctl` 把**决策**做成可编程的:8 题测出的人格不是标签,而是一套**可计算的营养 / 口味 / 社交权重**,直接驱动配餐组合搜索、券后到手价精算、派对场次约束求解——全部能在终端复现,`--json` 可直接接管道与 Agent。
  28. <table>
  29. <tr>
  30. <td width="34%" align="center" valign="top">
  31. <img src="./docs/assets/personas/mcctl-persona-FITA.png" alt="麦籍卡示例:板烧修行者 FITA" width="280" />
  32. <br /><sub>测完生成的麦籍卡 · 可下载 / 可扫码传播</sub>
  33. </td>
  34. <td valign="top">
  35. <b>▶ 在线体验(手机零安装)</b><br />
  36. <a href="https://hulinkang9527.github.io/mcctl/">hulinkang9527.github.io/mcctl</a><br />
  37. <sub>8 题出结果 · 可下载麦籍卡 · 可算好友匹配度(离线 Playground)</sub><br /><br />
  38. <b>⚡ 一行装上就跑</b><br />
  39. <code>pip install git+https://github.com/hulinkang9527/mcctl.git &amp;&amp; mcctl whoami</code><br /><br />
  40. <b>🧭 一条命令串演全部能力</b><br />
  41. <code>mcctl demo</code> — 人格 → 配餐 → 省钱 → 下单演练 → 积分
  42. </td>
  43. </tr>
  44. </table>
  45. `mcctl` 把麦当劳中国官方 MCP 开放的 **35 个工具**(CLI 已全量集成)编排成一套程序员命令:人格测试、控卡配餐、一键领券凑单、安全下单、积分兑换、派对预约,还能作为 **Agent Skill** 装进 WorkBuddy / Cursor。
  46. > **网页 vs CLI 的边界,先说清楚**:网页 Playground 是**离线演示**(纯静态、预置菜单与价格,不调用官方 MCP);
  47. > 想要**实时菜单 / 库存 / 到手价**请用 CLI —— `mcctl --live`(需在 open.mcd.cn/mcp 申请 Token,连不上会自动降级并明确提示)。
  48. >
  49. > 程序员节快乐。`kubectl` 管你的集群,`mcctl` 管你的麦门。
  50. ## ✨ 亮点
  51. - 🃏 **麦麦人格测试**:**8 题麦门人格测试**(前 7 题二选一 + 第 8 题终局四选一)测出 8 型 McPersona,生成可下载、可分享的像素风**麦籍卡**;人格是一套可计算的营养 / 口味权重,直接驱动配餐。
  52. - 💸 **真·省钱引擎**:一键领券 → 逐券试算 → 智能凑单,给你"基线 → 优惠 → 实付"和节省百分比,**拒绝伪优惠**。
  53. - 🛒 **安全下单闭环**:到店 / 外送全链路,所有交易默认**演练**,必须 `--confirm`,真实环境跳转官方支付、**不自动扣款**。
  54. - 🎉 **麦麦派对策划师(主打)**:`mcctl party plan` 把「城市 → 门店 → 日期 → 场次」做成约束求解——人数 / 预算 / 期望日期 / 名额硬约束卡死,输出 Top3 方案,`--confirm` 一键预约。
  55. - 🔌 **CLI 已集成 35 个 MCP 工具**:真实 Client + 离线 Mock 自动降级,**clone 即零配置体验**,配 Token 切实时数据。四种形态:Python 包 + CLI、Agent Skill、**离线网页 Playground**、可复用 SDK。
  56. ## 🚀 快速开始
  57. **方式一(零安装 · 手机点开即玩)**:打开 [**网页 Playground**](https://hulinkang9527.github.io/mcctl/)(手机也能玩):8 题测人格 → 命定套餐 → 下载 / 分享麦籍卡。
  58. > 网页 Playground 为**离线演示**(纯静态、内置示例菜单与价格),用于展示人格测试与配餐逻辑;
  59. > 真实 MCP 工具调用请在 CLI 实时模式下验证(方式二 / 方式四)。
  60. **方式二(从源码 · 推荐)**:
  61. ```bash
  62. git clone https://github.com/hulinkang9527/mcctl.git && cd mcctl
  63. pip install -e .
  64. mcctl demo # 一键串演:人格→配餐→省钱→下单演练→积分
  65. mcctl whoami # 8 题测麦麦人格
  66. mcctl decide -p FITA # 板烧修行者的命定套餐
  67. ```
  68. 也可以免 clone 一行安装:`pip install git+https://github.com/hulinkang9527/mcctl.git`。
  69. **方式三(PyPI,发布流程中)**:PyPI 包名将是 `mcd-mcctl`(`mcctl` 已被无关项目占用,安装后命令行入口仍是 `mcctl`)。**当前尚未上架,请先用方式二安装**,上架后本节会同步更新。
  70. **方式四(接入真实 MCP)**:到 <https://open.mcd.cn/mcp> 申请 Token,然后 `export MCD_MCP_TOKEN=你的Token && mcctl --live tools`。通用 MCP Client(WorkBuddy / Cursor / VS Code …)直接使用 [`mcp-config.example.json`](mcp-config.example.json)。
  71. ## 📺 终端演示
  72. <p align="center">
  73. <img src="./docs/assets/demo.gif" alt="mcctl 终端演示" width="700" />
  74. </p>
  75. > 安装后一条 `mcctl demo` 即可串演:人格测试 → 配餐 → 领券凑单 → 下单演练 → 积分活动。
  76. ## 🕹️ 网页演示(零安装,手机直接玩)
  77. <p align="center">
  78. <img src="./docs/assets/playground.gif" alt="mcctl 网页演示" width="700" />
  79. </p>
  80. <p align="center">
  81. <a href="https://hulinkang9527.github.io/mcctl/"><b>👉 点我打开在线 Playground</b></a>
  82. · 打开后点「⚡ 一键看完整示例」,即可看到 条件 → 套餐 → 优惠对比 → 推荐理由。
  83. </p>
  84. <p align="center">
  85. <img src="./docs/assets/personas/mcctl-persona-BIGS.png" width="180" />
  86. <img src="./docs/assets/personas/mcctl-persona-SPCY.png" width="180" />
  87. <img src="./docs/assets/personas/mcctl-persona-SQUAD.png" width="180" />
  88. <img src="./docs/assets/personas/mcctl-persona-LOYT.png" width="180" />
  89. </p>
  90. ## 🏗️ 架构速览
  91. ```
  92. mcctl 命令行 (Typer + Rich) 网页 Playground (纯静态)
  93. │ │
  94. ┌────────▼─────────┐ ┌──────────▼──────────┐
  95. │ 业务编排层 service│ │ 内置数据 + 前端逻辑 │
  96. │ decide/diet/save │ │ (无后端,免登录) │
  97. │ party/order/... │ └─────────────────────┘
  98. └────────┬─────────┘
  99. │ 35 个 MCP 工具
  100. ┌────────▼────────────────┐
  101. │ MCP 客户端 (mcp_client) │
  102. │ 实时官方 → 离线 Mock │ 连不上自动降级,不静默出错
  103. └─────────────────────────┘
  104. ```
  105. 完整设计见 [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md)。
  106. ## 🧭 命令速览
  107. | 命令 | 作用 |
  108. |---|---|
  109. | `mcctl whoami` | 8 题麦麦人格测试 + 麦籍卡 |
  110. | `mcctl decide / diet / lunch` | 人格化 / 控卡配餐 |
  111. | `mcctl menu / stores / calendar` | 菜单营养 / 门店 / 活动 |
  112. | `mcctl coupons / save` | 领券 / 凑单 / 到手价 |
  113. | `mcctl order new/track/list/cancel` | 下单 / 跟踪 / 取消 |
  114. | `mcctl points / redeem / lottery` | 积分 / 兑换 / 抽奖 |
  115. | `mcctl party plan` | 🎉 派对策划师:约束求解最优场次 |
  116. | `mcctl tools / config / demo` | 工具清单 / 配置 / 一键演示 |
  117. 完整手册见 [`docs/COMMANDS.md`](docs/COMMANDS.md)。
  118. ## 🃏 八型麦麦人格
  119. | | 代号 | 人格 | 本命餐 |
  120. |---|---|---|---|
  121. | 🍔 | `BIGS` | 巨无霸本霸 | 巨无霸 + 薯条 + 可乐 |
  122. | 🥗 | `FITA` | 板烧修行者 | 板烧鸡腿堡 + 苹果片 + 纯净水 |
  123. | 🌶️ | `SPCY` | 麦辣亡命徒 | 麦辣鸡腿堡 + 辣翅 + 冰红茶 |
  124. | 🍦 | `SWEET` | 麦旋风甜心 | 麦旋风 + 菠萝派 + 橙汁 |
  125. | ☕ | `EARL` | 麦满分绅士 | 猪柳蛋麦满分 + 脆薯饼 + 咖啡 |
  126. | 🌙 | `NITE` | 麦夜骑士 | 脆汁鸡堡 + 麦乐鸡 + 零度可乐 |
  127. | 🎉 | `SQUAD` | 麦乐送团长 | 双堡 + 麦乐鸡 + 大薯 + 双饮 |
  128. | 🪙 | `LOYT` | 麦门省钱主教 | 双层吉士堡 + 薯条 + 零度可乐 |
  129. ## 🛡️ 安全与合规
  130. - 写操作默认 dry-run,无 `--confirm` 不执行;不碰支付与凭证,仓库不含真实密钥。
  131. - 本项目为麦当劳程序员创意开发大赛(M-CODE / 1024)**非官方**开源创意作品,演示数据为非官方示例,餐品 / 价格以官方实时结果为准。
  132. ## 📚 文档
  133. [架构](docs/ARCHITECTURE.md) · [命令手册](docs/COMMANDS.md) · [人格图鉴](docs/PERSONAS.md) · [派对策划师](docs/PARTY.md) · [MCP 集成](MCP_INTEGRATION.md) · [Agent Skill](skill/SKILL.md) · [分享素材包](docs/PROMOTION.md) · [参赛声明(官方原文)](CONTEST_DECLARATION.md)
  134. ## 🧪 开发与测试
  135. ```bash
  136. pip install -e ".[dev]"
  137. pytest # 人格(512 种作答) / 配餐 / 省钱 / 派对策划 / 35 工具状态机 / 字段容错
  138. ```
  139. 测试覆盖的两处要点:
  140. - **512 种作答全枚举**:8 题题库共 2⁷×4=512 种作答,逐一校验「8 型都能被测出」「分布不塌缩」「同分裁决稳定」;
  141. - **网页 ↔ Python 计分一致性(parity)**:网页端题库与计分规则抽在 `web/persona-core.js`,
  142. Node 探针枚举同样 512 种作答与 Python 引擎逐条比对,任一侧改了权重而另一侧没跟上,CI 立刻失败。
  143. 本机无 Node 时该用例自动跳过,其余测试照常运行。
  144. ## 📮 参赛说明
  145. 参加 **2026 麦当劳程序员创意开发大赛(M-CODE / 1024 程序员节)**,官方合作伙伴为腾讯 WorkBuddy。欢迎 ⭐ Star、Fork、提 Issue。**如果你也觉得好玩/有用,点个 Star 就是投票**,比赛以 GitHub Star 排名,谢谢麦门同门 🙏。
  146. > 本项目为麦当劳程序员创意开发大赛**非官方**开源创意作品,与麦当劳无隶属关系;请通过实际体验与正当社区分享支持项目,拒绝任何刷榜行为。
  147. ## 📄 许可证
  148. [MIT](LICENSE)。不授予任何麦当劳商标权利;请遵守麦当劳中国 MCP《使用条款》与《服务规则》。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.