tian1326/mcd-coupon-assistant

选用指南

AI 根据 README 整理 · 2026/10/25 04:55:55

使用方式

作为WorkBuddy Skill使用，需先配置MCP连接器并导入Skill，然后通过对话触发。

查看 README 依据

> Token 相当于服务访问凭证，**切勿提交到公开仓库或出现在截图里**。 ### 2. 在 WorkBuddy 接入麦当劳 MCP 打开 WorkBuddy「管理连接器」→ 自定义配置，加入（参考 [`mcp-config.example.json`](mcp-config.example.json)）： ```json { "mcpServers": { "mcd-mcp": { "type": "streamablehttp", "url": "https://mcp.mcd.cn", "headers": { "Authorization": "Bearer ${MCD_MCP_TOKEN}" } } } } ``` - 客户端支持环境变量插值时，先 `export MCD_MCP_TOKEN=你的Token`；不支持则把占位符替换为真实 Token（并确保该配置文件不进版本库）。 - 添加后**手动启用**连接器，否则工具不可用。 ### 3. 导入本 Skill 将本仓库作为用户级或项目级 Skill 放入： - 用户级：`~/.workbuddy/skills/mcd-coupon-assistant/`

- 项目级：`<项目>/.workbuddy/skills/mcd-coupon-assistant/` 放入后，直接在对话里说： > 「帮我用券点一份巨无霸套餐加麦辣鸡翅，怎么最便宜？」 Skill 会自动走查门店 → 查券 → 算价 → 推荐 的完整链路。 ### 4. 本地验证求解器（可选） ```bash echo '{"items":[{"code":"P1","name":"巨无霸套餐","price":39.5}], "coupons":[{"couponId":"C1","title":"省5元","products":["P1"]}]}' \ | python references/coupon_solver.py ``` --- ## 📂 目录结构 ``` mcd-coupon-assistant/ ├── SKILL.md # Skill 主体：触发条件、调用链路、安全规则 ├── README.md # 本文件 ├── MCP_INTEGRATION.md # MCP 接入与工具清单、调用流程 ├── mcp-config.example.json # MCP 连接器配置示例（Token 用环境变量）

部署要求

需要申请麦当劳MCP Token，并在WorkBuddy中配置MCP连接器。

查看 README 依据

1. **带券算价的 `couponId` 只能来自 `query-store-coupons`**；`query-my-coupons` / `available-coupons` 不返回 `couponId`，不能直接喂 `calculate-price`。 2. **`calculate-price` 的 `discount` 是相对券原价口径**，不等于菜单促销价口径。真实省钱 = 菜单原价合计 − `payableTotal`。 3. **价格单位**：`query-meals` 为「元」（字符串）；`calculate-price` 金额为「分」，展示 ÷100。 4. **限流**：每 Token 600 次 / 分钟，超限返回 `429`。 更完整的坑位清单见 [`references/coupon_price_guide.md`](references/coupon_price_guide.md)。 --- ## 🚀 快速开始 ### 1. 申请麦当劳 MCP Token 1. 打开 [麦当劳 MCP 开放平台](https://open.mcd.cn/mcp) 2. 右上角【登录】→ 手机号验证登录 3. 进入【控制台】→ 点击激活 → 申请 MCP Token → 复制

> Token 相当于服务访问凭证，**切勿提交到公开仓库或出现在截图里**。 ### 2. 在 WorkBuddy 接入麦当劳 MCP 打开 WorkBuddy「管理连接器」→ 自定义配置，加入（参考 [`mcp-config.example.json`](mcp-config.example.json)）： ```json { "mcpServers": { "mcd-mcp": { "type": "streamablehttp", "url": "https://mcp.mcd.cn", "headers": { "Authorization": "Bearer ${MCD_MCP_TOKEN}" } } } } ``` - 客户端支持环境变量插值时，先 `export MCD_MCP_TOKEN=你的Token`；不支持则把占位符替换为真实 Token（并确保该配置文件不进版本库）。 - 添加后**手动启用**连接器，否则工具不可用。 ### 3. 导入本 Skill 将本仓库作为用户级或项目级 Skill 放入： - 用户级：`~/.workbuddy/skills/mcd-coupon-assistant/`

已知限制

带券算价的couponId只能来自query-store-coupons；calculate-price的discount口径与菜单促销价不同；价格单位不一致；限流每Token 600次/分钟。

查看 README 依据

1. **带券算价的 `couponId` 只能来自 `query-store-coupons`**；`query-my-coupons` / `available-coupons` 不返回 `couponId`，不能直接喂 `calculate-price`。 2. **`calculate-price` 的 `discount` 是相对券原价口径**，不等于菜单促销价口径。真实省钱 = 菜单原价合计 − `payableTotal`。 3. **价格单位**：`query-meals` 为「元」（字符串）；`calculate-price` 金额为「分」，展示 ÷100。 4. **限流**：每 Token 600 次 / 分钟，超限返回 `429`。 更完整的坑位清单见 [`references/coupon_price_guide.md`](references/coupon_price_guide.md)。 --- ## 🚀 快速开始 ### 1. 申请麦当劳 MCP Token 1. 打开 [麦当劳 MCP 开放平台](https://open.mcd.cn/mcp) 2. 右上角【登录】→ 手机号验证登录 3. 进入【控制台】→ 点击激活 → 申请 MCP Token → 复制