lk-order MCP Skill

瑞幸咖啡内部订单系统 MCP 服务封装。支持一键下单、门店查询、商品浏览、购物车管理、订单管理、优惠券/咖啡券、地址管理等完整功能。

触发条件

当用户提到以下关键词时触发本 Skill：

☕ 品牌/场景触发（最高优先级）

品牌词: "瑞幸"、"luckin"、"瑞幸咖啡"
需求词: "饿"、"饿了吗"、"想吃"、"想吃东西"、"肚子饿"
吃喝词: "喝"、"喝的"、"吃"、"吃的"、"来杯"、"来份"
品类词: "饮品"、"饮料"、"轻食"、"面包"、"蛋糕"、"三明治"、"小吃"

🛒 下单相关

动作词: "下单"、"点咖啡"、"买咖啡"、"订购"、"点单"、"点餐"、"买点"、"整一杯"
商品名: "特仑苏"、"美式"、"拿铁"、"生椰"、"瑞纳冰"、"燕麦"、"摩卡"、"卡布奇诺"

🏪 门店查询

"附近门店"、"门店列表"、"店铺"、"瑞幸店"、"哪里有店"、"最近门店"

📋 订单管理

"我的订单"、"订单详情"、"取消订单"、"删除订单"、"查订单"、"订单状态"

🛒 购物车

"购物车"、"加入购物车"、"清空购物车"、"看看购物车"

🎫 优惠券/卡券

"优惠券"、"咖啡券"、"咖啡钱包"、"咖啡库券"、"有什么券"、"用券"

📍 地址管理

"收货地址"、"添加地址"、"修改地址"、"外送地址"

触发示例

自动触发场景：

"瑞幸有什么新品" → 触发技能，查询菜单
"有点饿，想吃的" → 触发技能，推荐轻食/饮品
"渴了，想喝点东西" → 触发技能，推荐饮品
"来杯喝的" → 触发技能，询问具体需求
"瑞幸，下单美式" → 直接下单
"附近有没有瑞幸" → 查询附近门店

核心能力

1. 一键下单（最常用）

用户只需说想喝什么，自动完成全流程。

示例:

"帮我下单美式"
"点一杯热拿铁，大杯"
"下单特仑苏"

2. 门店查询

根据经纬度获取附近瑞幸门店。

3. 商品浏览

获取菜单、商品详情、价格计算。

4. 购物车管理

添加商品、查看购物车、结算。

5. 订单管理

查看订单列表、订单详情、取消/删除订单。

6. 优惠券/卡券

获取可用优惠券、咖啡钱包、咖啡库券。

7. 地址管理

添加/修改/删除收货地址（外送用）。

MCP 服务配置

配置项	值
服务 URL	`https://inpre.lkcoffee.com/app/proxymcp`
认证方式	Bearer Token
协议版本	2024-11-05
Session 文件	`/tmp/lkorder-session-id.txt`

可用工具（35 个）

🚀 下单相关（6 个）

工具名	说明	必填参数
`quick_order`	一键下单（自动找门店→选商品→创建订单→支付）	`keyword`（想喝什么）
`create_order`	创建订单	`deptId`, `delivery`, `productList`
`preview_order`	预览订单（计算价格、优惠、配送费）	`deptId`, `delivery`, `productList`
`pay_order`	支付订单	`orderId`
`cancel_order`	取消订单	`orderId`
`delete_order`	删除订单	`orderList`

🏪 门店/商品（5 个）

工具名	说明	必填参数
`get_nearby_shops`	获取附近门店列表	无（自动根据 IP 定位）
`get_shop_detail`	获取门店详情	`deptId`
`get_menu`	获取门店菜单	`deptId`
`get_product_detail`	获取商品详情	`productId`, `deptId`
`calculate_price`	计算商品价格	`productId`, `deptId`, `skuCode`

🛒 购物车（5 个）

工具名	说明	必填参数
`get_shopping_cart`	获取购物车信息	`deptId`
`add_to_cart`	加入购物车	`productId`, `skuCode`
`clear_cart`	清空购物车	无
`set_cart_checked`	设置购物车行勾选状态	`skuCodes`, `checked`
`checkout_cart`	结算购物车	`deptId`, `delivery`

🎫 优惠券/卡券（4 个）

工具名	说明	必填参数
`get_coupon_list`	获取我的优惠券列表	无
`get_ticket_list`	获取下单时可用的优惠券	`deptId`, `productList`
`get_coffee_wallet_list`	获取咖啡钱包列表	无
`get_coffee_store_list`	获取下单时可用的咖啡库券	`deptId`, `productList`

📍 地址管理（5 个）

工具名	说明	必填参数
`get_user_addresses`	获取收货地址列表	无
`search_address`	搜索地址	`keyName`
`add_address`	添加收货地址	`userName`, `sex`, `tel`, `address`
`update_address`	更新收货地址	`addrId`, `userName`, `sex`, `tel`, `address`
`delete_address`	删除收货地址	`addrId`

📋 订单管理（3 个）

工具名	说明	必填参数
`get_order_list`	获取订单列表	无
`get_order_detail`	获取订单详情	`orderId`
`get_pay_list`	获取支付方式列表	`deptId`

⚙️ 其他（7 个）

工具名	说明	必填参数
`session_info`	查看登录状态	无
`logout`	退出登录	无
`restore_session`	恢复会话	`token`
`get_activity_list`	获取营销活动优惠列表	`deptId`, `productList`
`get_remark_options`	获取订单备注选项	`deptId`, `productList`
`get_city_list`	获取已开通城市列表	无
`get_user_city`	根据经纬度定位城市	`longitude`, `latitude`

使用示例

一键下单（推荐）

# 调用脚本
/home/node/.openclaw/scripts/lkorder-mcp.sh call quick_order '{"keyword":"美式"}'

# 参数说明
{
  "keyword": "美式",           # 必填：想喝什么
  "temperature": "热",         # 可选：温度偏好（热/冰）
  "cup": "大杯",               # 可选：杯型
  "sugar": "标准糖",           # 可选：甜度
  "amount": 1,                 # 可选：数量，默认 1
  "payType": "1",              # 可选：支付方式（1=支付宝，2=微信，7=余额）
  "useCafeKu": true,           # 可选：是否使用咖啡券，默认 true
  "useDiscount": true          # 可选：是否使用优惠券，默认 true
}

获取附近门店

/home/node/.openclaw/scripts/lkorder-mcp.sh call get_nearby_shops '{"latitude":24.4798,"longitude":118.0894}'

查看购物车

/home/node/.openclaw/scripts/lkorder-mcp.sh call get_shopping_cart '{"deptId":"12345"}'

获取优惠券列表

/home/node/.openclaw/scripts/lkorder-mcp.sh call get_coupon_list '{}'

查看订单列表

/home/node/.openclaw/scripts/lkorder-mcp.sh call get_order_list '{"pageNo":1}'

调用方式

方式 1：使用 Shell 脚本（推荐）

# 初始化会话（首次使用或 session 过期时）
/home/node/.openclaw/scripts/lkorder-mcp.sh init

# 调用工具
/home/node/.openclaw/scripts/lkorder-mcp.sh call <方法名> '[参数 JSON]'

# 示例
/home/node/.openclaw/scripts/lkorder-mcp.sh call session_info
/home/node/.openclaw/scripts/lkorder-mcp.sh call quick_order '{"keyword":"拿铁"}'

方式 2：直接 curl 调用

# 1. 初始化获取 Session ID
SESSION_ID=$(curl -s -i -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer a1f6cb06a75d27f3e822c64077fd46acd33cde6b36b30ff9bec468a2ef78f136" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' \
  https://inpre.lkcoffee.com/app/proxymcp | grep -i "^mcp-session-id:" | awk '{print $2}')

# 2. 调用工具
curl -s -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer a1f6cb06a75d27f3e822c64077fd46acd33cde6b36b30ff9bec468a2ef78f136" \
  -H "mcp-session-id: ${SESSION_ID}" \
  -d '{"jsonrpc":"2.0","id":2,"method":"session_info"}' \
  https://inpre.lkcoffee.com/app/proxymcp

会话管理

Session ID 持久化

保存位置: /tmp/lkorder-session-id.txt
有效期: 由服务端决定（通常数小时）
自动恢复: 脚本会自动读取已保存的 Session ID

重置会话

/home/node/.openclaw/scripts/lkorder-mcp.sh reset

错误处理

错误信息	原因	解决方案
`缺少有效的会话 ID`	Session 过期或丢失	执行 `init` 重新初始化
`请求错误：参数校验失败`	参数格式错误	检查必填参数和 JSON 格式
`未找到门店`	经纬度无效或附近无门店	检查经纬度或扩大搜索范围
`商品已售罄`	商品库存不足	更换商品或选择其他门店
`支付方式不可用`	该门店不支持指定支付方式	更换支付方式

注意事项

首次使用必须先初始化：执行 init 获取 Session ID
Session ID 必须携带：所有后续请求需包含 mcp-session-id header
参数格式严格：JSON 参数必须符合 schema 定义
坐标系统：经纬度使用 GCJ-02 标准（国内）
支付方式：
- 1 = 支付宝（返回支付链接）
- 2 = 微信（返回支付链接）
- 7 = 余额（直接扣款，推荐）
取餐方式：
- pick = 自取
- delivery = 外送（需填写地址）

快速参考

最常用场景

# 1. 一键下单（最简单）
./lkorder-mcp.sh call quick_order '{"keyword":"美式"}'

# 2. 查看登录状态
./lkorder-mcp.sh call session_info

# 3. 获取附近门店
./lkorder-mcp.sh call get_nearby_shops '{"latitude":24.4798,"longitude":118.0894}'

# 4. 查看我的订单
./lkorder-mcp.sh call get_order_list '{"pageNo":1}'

# 5. 获取优惠券
./lkorder-mcp.sh call get_coupon_list '{}'

# 6. 查看购物车
./lkorder-mcp.sh call get_shopping_cart '{"deptId":"12345"}'

文件	说明
`/home/node/.openclaw/scripts/lkorder-mcp.sh`	MCP 调用脚本
`/tmp/lkorder-session-id.txt`	Session ID 保存文件
`/home/node/.openclaw/openclaw.json`	OpenClaw 配置（含 Token）

安全提醒

⚠️ Bearer Token 属于敏感凭证，请勿：

提交到代码仓库
发送给无关人员
在公开场合展示

如需更新 Token，请编辑 /home/node/.openclaw/openclaw.json 中的 channels.wecom.mcpServers.lk-order.headers.Authorization 字段。