xx20050823xx/McMate

选用指南

AI 根据 README 整理 · 2026/10/25 11:25:54

使用方式

可作为WorkBuddy Skill通过对话交互使用，也可通过命令行运行Python引擎。

查看 README 依据

├── SKILL.md # WorkBuddy Skill 定义（主入口，含四步交互流程） ├── main.py # 项目主体代码：搭配引擎（分类 → 组合 → 打分 → 输出，纯标准库） ├── references/ │ └── mcd-mcp-tools.md # mcd-mcp 工具参数矩阵、真实调用样例、错误处理 ├── assets/ │ └── sample-menu.json # 真实菜单快照（玉溪极中心店），用于离线测试 ├── README.md # 本文件 ├── MCP_INTEGRATION.md # MCP Server / Tool / 调用流程 / 业务价值 └── workbuddy.md # 使用 WorkBuddy 开发本项目的对话上下文 ``` ## 安装 ### 方式一：作为 WorkBuddy Skill（推荐） 1. 把整个目录复制到 `~/.workbuddy/skills/mcmate/` ```bash cp -r mcmate ~/.workbuddy/skills/ ```

> 注意：`Authorization` 必须是 `Bearer <token>`，漏掉 `Bearer ` 前缀会 401。 ## 使用示例 **对话式（WorkBuddy 内）** ``` 你：不知道吃啥，帮我搭配一份麦当劳 AI：附近可以点的麦当劳有这几家： 1. 玉溪极中心餐厅 — 棋阳路极中心购物广场一层 2. 玉溪聂耳广场餐厅 — 聂耳路 12 号 在哪家吃？回复序号即可 你：1 AI：好的，玉溪极中心店。几个人吃？ 你：就我一个 AI：预算大概多少？20-30 吃得简单，30-40 是标准一人食。 你：35 左右 AI：（query-meals → 搭配引擎 → 官方算价） 1. 龙焰鸡腿堡三件套 ¥26.9（省 ¥21.1） 2. 麦香鸡 + 苹果汁 ¥28.0 3. 麦香鸡 + 玉米杯 ¥29.5 你：1 AI：（calculate-price 复核 → create-order）已下单，请扫码支付… 你：支付完成 AI：（query-order）订单已支付，正在备餐… ``` > 如果你一开始就把信息说全（"玉溪极中心那家，两个人，40 块"），skill 会跳过提问直接出方案，只回读确认一次。 **命令行** ```bash python main.py --demo --budget 20-30

部署要求

需要Python 3.8+，若使用真实菜单需配置mcd-mcp服务，并需在open.mcd.cn申请token。

查看 README 依据

2. 确认 `mcd-mcp` 已连接：聊天窗口左下角「+」→ 连接器管理 → 自定义连接器 → 找到 `mcd-mcp` 点「信任」。 3. 新开一个会话，直接说："帮我搭配一份 30-40 元的麦当劳"。 ### 方式二：只用 Python 引擎（不需要 MCP） ```bash # 无依赖，Python 3.8+ python main.py --demo --budget 30-40 ``` 需要真实菜单时，把任意一次 `query-meals` 的 `data` 字段存成 JSON： ```bash python main.py --menu menu.json --budget 30-40 --people 1 ``` ### 方式三：配置 mcp-mcd（MCP 客户端） `~/.workbuddy/mcp.json`： ```json { "mcpServers": { "mcd-mcp": { "type": "streamablehttp", "url": "https://mcp.mcd.cn", "headers": { "Authorization": "Bearer <在 open.mcd.cn 申请的 token>" } } } } ```

已知限制

仅支持中国大陆地区，菜单与价格因门店、时段、会员身份变化，随心配需用户选择子项，支付需在麦当劳APP或小程序完成。

查看 README 依据

- **Agent 开发者**：想看一个 MCP 工具如何被 Skill 封装成可复用的决策流程（`references/mcd-mcp-tools.md` 有完整的参数矩阵和真实响应）。 - **门店/运营同学**：用同样的方法做"预算内推荐"菜单分析。 ## 已知限制 - 只支持中国大陆地区（麦当劳 MCP 服务范围），不含港澳台。 - 菜单与价格随门店、时段、会员身份变化，一切以 `query-meals` / `calculate-price` 实时返回为准。 - 「随心配」类商品需要用户选子项，脚本只做占位提示，不代为选择。 - 下单后支付需用户在麦当劳 APP / 小程序完成，本 skill 不接触任何支付凭证。 ## 免责声明 本项目为开发者个人作品，非麦当劳官方产品。使用麦当劳 MCP 服务需遵守 [open.mcd.cn](https://open.mcd.cn) 的服务条款。