lk-order MCP Skill

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

触发条件

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

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

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

🛒 下单相关

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

🏪 门店查询

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

📋 订单管理

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

🛒 购物车

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

🎫 优惠券/卡券

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

📍 地址管理

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

触发示例

自动触发场景：

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

核心能力

1. 一键下单（最常用）

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

示例:

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

2. 门店查询

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

3. 商品浏览

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

4. 购物车管理

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

5. 订单管理

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

6. 优惠券/卡券

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

7. 地址管理

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

MCP 服务配置

可用工具（35 个）

🚀 下单相关（6 个）

🏪 门店/商品（5 个）

🛒 购物车（5 个）

🎫 优惠券/卡券（4 个）

📍 地址管理（5 个）

📋 订单管理（3 个）

⚙️ 其他（7 个）

使用示例

一键下单（推荐）

# 调用脚本
/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 \x3C方法名> '[参数 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

错误处理

注意事项

1. 首次使用必须先初始化：执行 init 获取 Session ID
2. Session ID 必须携带：所有后续请求需包含 mcp-session-id header
3. 参数格式严格：JSON 参数必须符合 schema 定义
4. 坐标系统：经纬度使用 GCJ-02 标准（国内）
5. 支付方式：
   • 1 = 支付宝（返回支付链接）
   • 2 = 微信（返回支付链接）
   • 7 = 余额（直接扣款，推荐）
6. 取餐方式：
   • 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"}'

相关文件

安全提醒

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

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

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