luckin-mcp-proxy

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

• ☕ 一句话点单（quickOrder）：「大杯冰美式不加糖」一步到预览

• 🔁 一键复购（reorder）

• 🧠 记忆：常用门店、口味偏好自动学习（存 ~/.luckin-mcp/config.json）

• 🛠 修复上游缺陷：搜索失败自动重试；绕过 switchProduct 的「非法参数」bug

准备：获取瑞幸 MCP token

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

Related MCP server: FastMCP

安装

需要 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 返回价格预览 → 「确认」 → confirmOrder 返回支付二维码 「再来一杯昨天那个」 → reorder 「到哪了」 → orderStatus 返回取餐码

环境变量

开发

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