瑞幸咖啡AI开放平台深度拆解：MCP Server + Skill 如何让AI帮你点咖啡

2026年，瑞幸咖啡正式上线AI开放平台（open.lkcoffee.com），面向AI Agent、智能应用与业务协作场景，提供标准化 MCP Server、CLI 与 Skill 能力。这不是一个传统的API开放平台——它允许任何AI Agent直接通过自然语言搜索门店、点单下单、查取餐码，全程无需打开瑞幸APP。

本文将从架构层面，深入拆解这套系统的设计逻辑、技术实现和可复用的架构模式。

一、架构全景：三件套

瑞幸AI开放平台由三个核心组件构成，三者各司其职，形成完整闭环：

组件	定位	用户面对什么
开放平台	文档 + Token 管理	SPA 网页，登录后生成 Token
MCP Server	业务能力暴露	8个标准化下单工具
Skill 包	交互流程编排	SKILL.md 纯指令文件

二、组件一：开放平台（open.lkcoffee.com）

开放平台是一个 SPA 单页应用，文档内容内嵌在 JavaScript bundle 中，纯客户端渲染。核心功能有两个：

• 文档展示：展示 MCP Server 的 8 个工具定义、参数说明、返回值格式
• Token 管理：用户登录后在线生成 Token，支持一键复制和删除

Token 的 Key 设计值得关注：

• Token 在 MCP 与 CLI 之间共用——用户只需取一次 Token，能在多个场景使用
• 与瑞幸账号会话绑定，登录状态保留约 1 个月，省去频繁登录
• 严禁泄露/分享，泄露后可立即删除重新生成
• 生成入口：https://open.lkcoffee.com/mcp

三、组件二：MCP Server（核心业务能力）

MCP Server 是整个系统的核心，部署在 https://gwmcp.lkcoffee.com/order/user/mcp，使用 Streamable HTTP 传输协议，Bearer Token 认证。共暴露 8 个工具，分三组：

3.1 门店相关

queryShopList — 查询瑞幸门店列表。

• 必填参数：longitude（经度）、latitude（纬度）
• 可选参数：deptName（门店名称，支持模糊搜索）
• 返回字段：deptId（门店ID）、deptName、address、longitude、latitude、workTimeStart、workTimeEnd、distance（千米）、deptTags（门店标签）、number（门店编号）

3.2 商品相关

searchProductForMcp — 根据用户输入匹配商品。

• 必填：deptId、query（用户原始查询文本）
• 返回商品列表，含 productId、productName、skuCode、pictureUrl、initialPrice（面价）、estimatePrice（预估到手价）
• 商品属性以嵌套结构返回：属性组 → 属性值 → 是否选中/加价金额

switchProduct — 切换商品属性。

• 用于切换杯型、温度、糖度、奶基等属性
• 参数：deptId、productId、skuCode、attrOperationParam（属性切换参数）、amount（数量）
• 属性切换操作码：选中传 3

queryProductDetailInfo — 查询商品详情。

• 必填：deptId、productId
• 返回完整的属性树，用于在切换属性前确认可选范围

支持的定制属性覆盖面很广：

• 杯型：16oz、大杯、特大杯、小黑杯、特调杯
• 温度：冰、热、冰沙、去冰、少冰
• 糖度：不另外加糖、微甜、少甜、标准甜
• 奶基：鲜牛奶、燕麦奶、特仑苏
• 咖啡豆：埃塞、深烘拼配、意式拼配、云南、曼特宁
• 以及奶油、奶盖、小料、茶风味、酒精等 20+ 属性维度

3.3 订单相关

previewOrder — 订单预览，创建订单前必须调用。

• 必填：deptId、productList（每项含 amount、productId、skuCode）
• 返回：totalInitialPrice（原价）、privilegeMoney（减免金额）、discountPrice（应付金额）、couponCodeList（可用优惠券列表）

createOrder — 创建订单。

• 必填：deptId、productList、longitude、latitude
• 可选：couponCodeList（来自 previewOrder 的返回）
• 返回：orderId、payOrderUrl（支付链接）、payOrderQrCodeUrl（支付二维码链接）、discountPrice

queryOrderDetailInfo — 查询订单状态、取餐码等信息。

cancelOrder — 取消订单（传 orderId）。

四、组件三：Skill 包（交互编排层）

Skill 包是纯指令文件，不包含可执行代码。它通过 SKILL.md 定义 Agent 的交互逻辑，采用 instruction-only 模式。这种设计让业务逻辑与实现完全解耦：

• packageType: instruction-skill — 无代码，只有文字指令
• instructionOnly: true — 纯引导，不依赖运行时
• requiredMcp — 声明依赖的 MCP Server
• 版本号 0.8.2，License 为 CC BY-ND 4.0

4.1 下单流程

Skill 定义了下单的强约束流程，不可跳步：

确认门店 → 搜索商品 → 确认下单意图 → previewOrder → createOrder → 支付二维码

关键约束：

• previewOrder 不可跳过：必须 preview 后才能 createOrder，确保用户看到最终价格
• 优惠券透传：previewOrder 返回的 couponCodeList 非空时，createOrder 必须原样传入
• 价格自动确认：如果预览后应付金额不高于预估价、商品明细一致，直接创建订单，不再二次询问用户
• 仅展示二维码：payOrderUrl 和 payOrderQrCodeUrl 分两个字段返回，只向用户展示二维码
• 不支持配送：用户有外送意图时，统一回复"目前仅支持到店自取"

4.2 Token 安全规范

Skill 对 Token 有严格的生命周期管理：

• 读取优先级：环境变量 LUCKIN_MCP_TOKEN > 用户对话中提供的 Token > 本地文件 ~/.my-coffee/LUCKIN_MCP_TOKEN
• 用户在对话中首次发送 Token 时，必须先询问是否保存到本地文件，禁止静默写入
• Token 删除前必须二次确认，并告知后果
• 真实 API 调用必须使用完整 Token，禁止占位符或脱敏字符串

五、架构亮点与设计哲学

这套架构有几个值得深入学习的设计：

5.1 SPA 文档站 + CDN 分发 Skill 包

开放平台文档站是 SPA，内容内嵌在 JS bundle 中。真正的交付物——Skill 安装包——走 CDN 分发：https://unpkg.luckincoffeecdn.com/@luckin/my-coffee-skill@latest/dist/my-coffee-skill.zip。文档是入口，Skill 包是产出，两者分离。

5.2 Token/CLI/MCP 三合一

用户只需要取一次 Token，就能在 MCP Server（AI Agent 调用）和 CLI（开发者手动调用）两种模式下使用。Token 与会话绑定，登录一次管一个月。

5.3 版本管理

Skill 包走 unpkg CDN，采用 @luckin scope 的 npm 包结构，latest 标签指向最新版本，dist 目录内是可直接下载的 zip。这样既做了版本管理，又支持了直接分发。

5.4 订单状态机

订单状态清晰枚举：

10 → 待付款
20 → 下单成功
30 → 制作中
60 → 等待取餐
80 → 已完成
100 → 已取消

5.5 支付安全设计

payOrderUrl 和 payOrderQrCodeUrl 分两个字段返回，Skill 约束只展示二维码图片和可点击链接。即使 Agent 被恶意利用，也无法获取支付 URL 进行中间人攻击。

六、对开发者的意义

这套架构代表了一种新的商业—AI 集成范式：

1. 商家方：实现一个 MCP Server（Node.js 或 Python），暴露门店、商品、订单等业务工具
2. Skill 方：写一个 instruction-only 的 SKILL.md，定义交互流程、约束规则、话术模板
3. 用户方：在任意兼容 MCP 的 AI 客户端中安装 Skill，配置 Token，一句话就能完成下单

瑞幸咖啡迈出了第一步，但可以预见——咖啡店、奶茶店、快餐店、便利店……未来每个高频消费场景都可能拥有自己的 MCP Server + Skill。这不仅仅是"让 AI 帮你点咖啡"，而是 AI 时代的标准化商业接入协议正在成型。

七、总结

瑞幸咖啡AI开放平台采用了 MCP Server + instruction-only Skill + SPA 文档站的经典架构。MCP Server 作为业务能力的标准化暴露层，SKILL.md 作为交互编排层，开放平台作为用户入口层。三层分离的设计让业务逻辑、交互逻辑和用户管理各自独立演进。

对于开发者而言，这套架构的价值在于标准化——MCP 是协议层标准，Skill 是交互层规范，两者组合使得任何兼容 MCP 的 AI Agent 都能丝滑接入。未来当我们搭建类似系统时，这套架构就是最好的参考模板。

参见：瑞幸咖啡AI开放平台 · MCP 协议规范