xkx121029/mcd-vibe-commit

选用指南

AI 根据 README 整理 · 2026/10/24 19:56:31

使用方式

将整个目录放入 Agent 的 skills 目录，通过对话方式使用，例如说“测一下我的麦门人格”。

查看 README 依据

├── verify.py # 交付自检脚本 └── workbuddy.md # WorkBuddy 开发过程记录 ``` ## 🚀 安装方式 把整个 `mcd-vibe-commit/` 目录放入你的 Agent skills 目录即可，例如： ```bash # WorkBuddy / CodeBuddy 类 Agent cp -r mcd-vibe-commit ~/.codebuddy/skills/ # 或其他遵循 Agent Skills 标准的客户端, 放入其 skills 目录 ``` 无需安装第三方依赖（Python 3.10+ 标准库即可运行全部脚本）。 ## ⚙️ 配置说明 ### 方式一：对话配置（推荐，最省事） 直接对 Agent 说：`测一下我的麦门人格`，首次运行时会引导你： ```text 🍔 欢迎使用麦门人格 Commit 生成器！ 检测到你还没有配置麦当劳 MCP Token。... ① 直接把 Token 发给我（我会帮你保存到本地 .env） ② 回复「跳过」先用 mock 数据体验 获取 Token：https://open.mcd.cn/mcp （手机号登录 → 控制台激活） ```

部署要求

需要 Python 3.10+ 标准库，无需第三方依赖。可选配置麦当劳 MCP Token，未配置时使用内置 mock 菜单。

查看 README 依据

├── verify.py # 交付自检脚本 └── workbuddy.md # WorkBuddy 开发过程记录 ``` ## 🚀 安装方式 把整个 `mcd-vibe-commit/` 目录放入你的 Agent skills 目录即可，例如： ```bash # WorkBuddy / CodeBuddy 类 Agent cp -r mcd-vibe-commit ~/.codebuddy/skills/ # 或其他遵循 Agent Skills 标准的客户端, 放入其 skills 目录 ``` 无需安装第三方依赖（Python 3.10+ 标准库即可运行全部脚本）。 ## ⚙️ 配置说明 ### 方式一：对话配置（推荐，最省事） 直接对 Agent 说：`测一下我的麦门人格`，首次运行时会引导你： ```text 🍔 欢迎使用麦门人格 Commit 生成器！ 检测到你还没有配置麦当劳 MCP Token。... ① 直接把 Token 发给我（我会帮你保存到本地 .env） ② 回复「跳过」先用 mock 数据体验 获取 Token：https://open.mcd.cn/mcp （手机号登录 → 控制台激活） ```

把 Token 直接发给 Agent，它会自动写入本地 `.env`（chmod 600）并立即生效， 全程只显示掩码（前 4 位 + `****`），不回显完整 Token。之后随时可以说 「配置 Token」或「换 Token」重新配置。 ### 方式二：手动配置 `.env` ```bash cp .env.example .env # 编辑 .env, 填入你申请的 Token: # MCP_TOKEN=your_token_here ``` ### 方式三：MCP 客户端配置（可选） 把 `mcp-config.example.json` 内容复制到你本机 MCP 客户端 （WorkBuddy：连接器 → 自定义连接器 → 配置 MCP），替换 `${MCP_TOKEN}`： ```json { "mcpServers": { "mcd-mcp": { "type": "streamablehttp", "url": "https://mcp.mcd.cn", "headers": { "Authorization": "Bearer ${MCP_TOKEN}" } } } } ```

已知限制

仅使用只读 MCP 工具，拒绝所有写操作；无 Token 或网络异常时自动降级为 mock 模式。

查看 README 依据

- **只读工具**：`query-meals`（必用，拉在售餐品名）、`list-nutrition-foods`（可选）、 `query-nearby-stores`（辅助，获取 `query-meals` 必需的 `storeCode`） - **写操作一律拒绝**：下单、领券、建地址、支付、取消订单、抽奖等，见 `references/tools.md` 拒绝清单 - **降级策略**：无 Token / 网络不可达 / 超时 8s / 401 / 429 / 400 参数错误时， 自动切换内置 mock 菜单，答题、人格判定、commit 生成、彩蛋全部不受影响 - 详见 [MCP_INTEGRATION.md](MCP_INTEGRATION.md) ## 🏆 参赛信息 - 大赛：麦当劳程序员创意开发大赛（MCP 专项） - 主仓库（规则 / 报名 / 排行榜）：https://github.com/M-China/mcd-developer-innovation-challenge - 活动指南：https://github.com/M-China/mcd-developer-innovation-challenge/blob/main/activityGuidelines.md