luckin-mcp-proxy

瑞幸咖啡 MCP 本地代理。包装瑞幸官方远程 MCP，提供：

• ☕ 一句话点单（quickOrder）：「大杯冰美式不加糖」一步到预览
• 🔁 一键复购（reorder）
• 🧠 记忆：常用门店、口味偏好自动学习（存 ~/.luckin-mcp/config.json）
• 🛠 修复上游缺陷：搜索失败自动重试；绕过 switchProduct 的「非法参数」bug

准备：获取瑞幸 MCP token

在瑞幸 App / 官方渠道开通 MCP 服务获取 Bearer token（一段以 LUCKIN_MCP_AI 结尾的长字符串）。 ⚠️ token 等同于你的点单权限，不要提交到 git、不要分享给他人。

安装

需要 Node.js >= 20。

方式一：一行命令（推荐）

无需 clone、无需构建，npx 直接从 GitHub 安装：

claude mcp add my-coffee -e LUCKIN_MCP_TOKEN=<你的token> -- npx -y github:wyhAcc/luckin-mcp-proxy

首次启动会自动下载并构建（约半分钟），之后走本地缓存秒启。

其他 MCP 客户端（JSON 配置）：

{
  "mcpServers": {
    "my-coffee": {
      "command": "npx",
      "args": ["-y", "github:wyhAcc/luckin-mcp-proxy"],
      "env": { "LUCKIN_MCP_TOKEN": "<你的token>" }
    }
  }
}

方式二：本地 clone（需要改代码时用）

git clone https://github.com/wyhAcc/luckin-mcp-proxy.git
cd luckin-mcp-proxy
npm install   # 会自动构建 dist/
claude mcp add my-coffee -e LUCKIN_MCP_TOKEN=<你的token> -- node "$PWD/dist/index.js"

工具列表

工具	说明
quickOrder	一句话点单 → 返回预览 + draftId（不直接下单）
confirmOrder	确认 draftId 下单，返回支付链接
reorder	复购上次订单
orderStatus	查订单/取餐码（缺省查最近一单）
cancelOrder	取消订单
searchProduct	搜商品（自动重试）
findShop	搜门店（首次需经纬度，之后自动记忆）
preferences	查看/设置常用门店与口味
rawCall	透传瑞幸原始工具（createOrder 除外，调试用）

示例对话

「点一杯大杯冰美式不加糖」 → quickOrder 返回价格预览 → 「确认」 → confirmOrder 返回支付二维码 「再来一杯昨天那个」 → reorder 「到哪了」 → orderStatus 返回取餐码

环境变量

变量	必填	说明
LUCKIN_MCP_TOKEN	是	瑞幸 MCP Bearer token
LUCKIN_MCP_URL	否	上游地址，默认官方 https://gwmcp.lkcoffee.com/order/user/mcp

开发

npm test          # 单元测试
npm run smoke     # 集成冒烟（需真实 token，只读+预览，不下单）
npm run build