Model Context Protocol · AI Native

瑞幸咖啡
MCP 开放平台

让 AI 帮你点咖啡。标准 MCP 协议，一句话下单，智能优惠，7 大能力全面开放。

StreamableHTTP 7 Tools Bearer Token Auth

02 — Background

什么是 MCP？

Model Context Protocol（模型上下文协议）是 AI 应用连接外部工具的标准接口。就像 USB 让电脑连接外设，MCP 让 AI 连接真实世界的服务。

🔌

标准协议

统一的 JSON-RPC 通信格式，任何支持 MCP 的 AI 客户端都能即插即用

🤖

AI 原生

专为 LLM Agent 设计，AI 可自主决定调用哪个工具、传什么参数

☕

瑞幸首批接入

瑞幸咖啡是国内首批开放 MCP 接口的消费品牌，支持完整点单链路

03 — Capabilities

7 大核心能力

覆盖从「想喝什么」到「拿到咖啡」的完整链路

queryShopList

查询门店

按经纬度搜索附近门店，返回距离、营业时间、状态

searchProduct

搜索商品

自然语言搜索菜单，智能匹配商品推荐

queryDetail

商品详情

获取杯型、温度、糖度、奶基等全部可选属性

switchProduct

切换商品

在订单中替换为其他商品

previewOrder

预览订单

下单前预览价格、优惠、配送方式

createOrder

创建订单

确认下单，支持自取和外卖

queryOrder

查询订单

查看订单状态、制作进度

04 — Live Demo

实时门店查询

通过 MCP 实时获取附近门店信息（以下为望京地区真实数据）

// AI 调用
queryShopList({ longitude: 116.4767, latitude: 39.9959 })

211m合生麒麟新天地店营业中

310m望京SOHO-2塔店营业中

325m望京SOHO-3塔店营业中

427m首开广场店营业中

454m望京SOHO-1塔店营业中

05 — Live Demo

智能商品搜索

自然语言搜索，AI 自动匹配最佳商品（真实菜单数据）

// 用户说："来杯生椰拿铁"
searchProductForMcp({ deptId: 5101, query: "生椰" })

生椰拿铁（首创）¥9.9

冰吸生椰拿铁（首创）¥9.9

大西瓜生椰冷萃¥12.9

小黄油拿铁（首创）¥17.43

橙C美式（首创）¥9.9

标准美式¥9.9

06 — Use Case

一句话下单

对 AI 说一句话，自动完成「搜店 → 选品 → 定制 → 下单」全流程

👤 用户

帮我在望京SOHO那家瑞幸点一杯冰的生椰拿铁，大杯，不要太甜

🤖 AI Agent

已为你下单：
☕ 生椰拿铁（首创）· 大杯 · 冰 · 不另外加糖
📍 望京SOHO-2塔店（距你310m）
💰 优惠后 ¥9.9
⏱ 预计 5 分钟后可取

4 步

AI 自动编排的调用链

~3 秒

从说话到下单完成

自动优惠

AI 自动选择最优券

07 — Scenarios

3 分钟接入

任何支持 MCP 的 AI 客户端都能接入瑞幸咖啡

1

获取 Token

访问 open.lkcoffee.com，用瑞幸 App 手机号登录，生成 API Token（有效期 30 天）

2

配置 MCP 客户端

在你的 AI 工具中添加 MCP 服务器配置：

{
  "mcpServers": {
    "luckin-coffee": {
      "type": "streamablehttp",
      "url": "https://gwmcp.lkcoffee.com/order/user/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

3

开始对话

对 AI 说"帮我点杯咖啡"，剩下的交给 Agent 自动编排

09 — Ecosystem

全平台支持

标准 MCP 协议，一次配置，处处可用

💻

QoderWork

自定义 MCP 连接器
设置 → 连接器 → 添加

🟣

Claude Desktop

claude_desktop_config.json
mcpServers 字段

📝

Cursor

~/.cursor/mcp.json
type: "http"

🔧

Claude Code

.mcp.json 项目配置
团队共享

⚡

任何 MCP Client

Windsurf / Continue / Cline
支持 StreamableHTTP 即可

🐍

Python SDK

mcp 库直接调用
自定义 Agent 工作流

10 — Technical

技术规格

协议信息

传输StreamableHTTP (POST)

端点gwmcp.lkcoffee.com/order/user/mcp

认证Bearer Token (30天有效)

格式JSON-RPC 2.0

注意事项

⚠️ 需关闭 sampling（握手兼容问题）

⚠️ switchProduct 偶现「非法参数」

✅ 支持自动优惠计算

✅ 支持自取 + 外卖两种模式

# 快速测试（curl）
curl -X POST https://gwmcp.lkcoffee.com/order/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

11 — Get Started

让 AI 成为你的
咖啡管家

从今天起，点咖啡只需要一句话。

获取 Token → 官方文档

Powered by 瑞幸咖啡 AI 开放平台 · MCP Protocol · wwei.ai

瑞幸咖啡MCP 开放平台