qimuzhenxingchen/mcscene

选用指南

AI 根据 README 整理 · 2026/10/19 03:26:31

使用方式

作为 Agent Skill 安装在 WorkBuddy 中使用，也可通过命令行脚本离线试用，或通过浏览器打开在线演示。

查看 README 依据

把 `skill/` 目录复制到 `~/.workbuddy/skills/mcscene/`，重启会话即生效。 > ⚠️ Token 只放在客户端配置里。仓库中的示例配置只使用 `${MCD_MCP_TOKEN}` 占位符。 --- ## 离线试用（不需要 Token） 引擎是纯标准库、零依赖，可以直接跑： ```bash # 单人要 60 元，看三个方案 python skill/scripts/mcsc_plan.py --items skill/fixtures/meals.sample.json --budget 60 # 两个人 100 元，看边际取舍 python skill/scripts/mcsc_plan.py --items skill/fixtures/meals.sample.json --budget 100 --headcount 2 # 儿童模式：自动排除辣与含咖啡因 python skill/scripts/mcsc_plan.py --items skill/fixtures/meals.sample.json --budget 40 --kid # 文案红线检测 python skill/scripts/mcsc_copyguard.py "生日快乐，吃了就会开心起来的" # 回归测试（127 条断言）

├── SKILL.md 技能定义：槽位、工作流 S0-S5、边界 ├── data/personas.json 10 类对象 × 12 类场合 × 5 种语气 ├── docs/COPY-GUARD.md 文案红线（人读版） ├── scripts/ │ ├── mcsc_plan.py 预算配餐引擎（零依赖） │ └── mcsc_copyguard.py 文案红线检测（零依赖） ├── fixtures/meals.sample.json 离线演示数据（SIMULATED） └── tests/test_engine.py 127 条断言 ``` --- ## 互动演示（无需 Token，打开即玩） **在线版**：<https://qimuzhenxingchen.github.io/mcscene/>（GitHub Pages，源为本仓库根目录 `index.html`） **本地版**：直接用浏览器打开根目录的 [`index.html`](index.html) Demo 内嵌龙洞第二餐厅 2026-10-18 真实菜单快照，可以：

部署要求

需要申请麦当劳 MCP Token 并配置到 WorkBuddy 连接器中；离线试用和演示不需要 Token。

查看 README 依据

本地引擎只做**筛选与排序**，不做定价。任何出现在方案里的金额，都能追溯到一次真实的 `calculate-price`。预排价格和核价不一致时，以核价为准并说明差额——不会"先报个好看的数再说"。 同理，热量缺项一律标"热量未知"，合计写成 `>= N kcal`，**绝不按 0 算**。 --- ## 安装 ### 前置：申请麦当劳 MCP Token 1. 打开 <https://open.mcd.cn/mcp>，手机号登录 2. 右上角「控制台」→「激活」→ 同意协议 → 复制 Token ### 接入 WorkBuddy 在 WorkBuddy 左侧「专家 · 技能 · 连接器」→「连接器」→ 右上「自定义连接器」→「配置 MCP」，填入（详见 `mcp-config.example.json`）： ```json { "mcpServers": { "mcd-mcp": { "type": "streamablehttp", "url": "https://mcp.mcd.cn", "headers": { "Authorization": "Bearer 你的Token" } } } } ``` 保存后回到连接器列表**启用** `mcd-mcp`。 ### 安装 Skill

把 `skill/` 目录复制到 `~/.workbuddy/skills/mcscene/`，重启会话即生效。 > ⚠️ Token 只放在客户端配置里。仓库中的示例配置只使用 `${MCD_MCP_TOKEN}` 占位符。 --- ## 离线试用（不需要 Token） 引擎是纯标准库、零依赖，可以直接跑： ```bash # 单人要 60 元，看三个方案 python skill/scripts/mcsc_plan.py --items skill/fixtures/meals.sample.json --budget 60 # 两个人 100 元，看边际取舍 python skill/scripts/mcsc_plan.py --items skill/fixtures/meals.sample.json --budget 100 --headcount 2 # 儿童模式：自动排除辣与含咖啡因 python skill/scripts/mcsc_plan.py --items skill/fixtures/meals.sample.json --budget 40 --kid # 文案红线检测 python skill/scripts/mcsc_copyguard.py "生日快乐，吃了就会开心起来的" # 回归测试（127 条断言）

已知限制

热量覆盖率取决于营养表，过敏原只能按名称粗筛，儿童模式不构成营养建议，预算极紧时不出方案，且不代付。

查看 README 依据

1. **热量覆盖率取决于营养表**。`list-nutrition-foods` 未收录的餐品会标"未知"，方案里可能出现"≥ 1150 kcal"这类表述。 2. **过敏原与忌口只能按名称/标签粗筛**。菜单接口没有配料表，涉及过敏时一律提示"以门店确认为准"。 3. **儿童模式**只排除辣与含咖啡因项，不构成营养建议。 4. **预算极紧时宁可不出方案**。5 元配不出完整一餐，脚本会直接说"配不出"，而不是硬凑一个三件套。 5. **不代付**。下单后返回的支付链接由用户自己完成支付。 --- ## 关于本次比赛 麦当劳程序员创意开发大赛（M-CODE）参赛作品，由个人独立开发，非麦当劳官方产品。 菜品信息、价格及供应状态以麦当劳官方渠道实时结果为准。 ## License MIT（`CONTEST_DECLARATION.md` 按赛事要求原样保留）