# 瑞幸

咖啡点单与门店查询。

- 类型：MCP · Skill · CLI
- 权限：涉及资金
- 门槛：需授权账号、需 API Key
- 官方入口：https://open.lkcoffee.com/docs
- 网页详情：https://guanmo-ai.github.io/awesome-agent-mcp/s/luckin/

仅供参考，官方身份核验不代表接入实测；以厂商文档为准，密钥和登录在本地完成。下单、付款前须用户确认。

## 接入前准备

需在瑞幸 AI 开放平台登录并取得 Token；下单会创建真实咖啡订单，返回支付链接不等于尚未下单。

## 接入步骤

1. 在官方平台登录并按 MCP 指引取得本人 Token。 [官方入口](https://open.lkcoffee.com/docs)
2. 依所选客户端配置官方 MCP，或按官网选择 CLI/Skill；在本地保管凭据。 [官方入口](https://open.lkcoffee.com/docs)

## 验证方法

先查询公开门店或商品信息；不要调用 createOrder 验证连接。

指引核对于 2026-11-05，不是本项目实测结果。

## 费用

下单会创建真实咖啡订单；具体商品费用以订单为准。MCP 调用费用尚未核实，官方页面当前无法读取。 [官方来源](https://open.lkcoffee.com/mcp)（核对日期：2026-11-05）

## 安装配置

### JSON

```
{
  "mcpServers": {
    "luckin": {
      "type": "http",
      "url": "https://gwmcp.lkcoffee.com/order/user/mcp",
      "headers": {
        "Authorization": "Bearer ${LUCKIN_TOKEN}"
      }
    }
  }
}
```

### Claude Code

```
claude mcp add --header 'Authorization: Bearer ${LUCKIN_TOKEN}' --transport http 'luckin' 'https://gwmcp.lkcoffee.com/order/user/mcp'
```

### Codex

```
# ~/.codex/config.toml
[mcp_servers.luckin]
url = "https://gwmcp.lkcoffee.com/order/user/mcp"
bearer_token_env_var = "LUCKIN_TOKEN"
```

### CLI

```
curl -fsSL https://open.lkcoffee.com/install | bash
```

这条命令会直接执行官方脚本，请让 Agent 先读脚本内容再运行。

JSON 示例用于 Claude Code 的 .mcp.json；${VAR} 从启动客户端的环境读取。Codex 的环境变量也须在启动进程中可用，不能将变量名替换成密钥值。

Codex 的 bearer_token_env_var 对应变量只填 Token，不带 Bearer；env_http_headers 对应变量提供完整请求头值。

命令会进入 shell 历史，请在本地执行，不要分享。保留命令中的 ${VAR} 引用；Codex 不支持在 URL 或命令参数中展开这些引用，此处保留待本地处理的占位符。

- [官方 Skill](https://unpkg.luckincoffeecdn.com/@luckin/my-coffee-skill@latest/dist/my-coffee-skill.zip)

## 核验与来源

2026-11-05 核对官方身份：[依据](https://open.lkcoffee.com/mcp)。瑞幸自有域名；createOrder 返回订单 ID 和支付链接，属于创建订单而非仅生成跳转地址。

官方原文摘录（2026-11-05，来自上述依据）：

```
"url": "https://gwmcp.lkcoffee.com/order/user/mcp",
```

官方页 Agent 可能读不到；上述原文摘录已覆盖的内容无需再读取官方页，未覆盖的信息仍须核实，不要猜测。

- [厂商官方复核来源](https://open.lkcoffee.com/docs)

[使用说明与免责声明](https://guanmo-ai.github.io/awesome-agent-mcp/#disclaimer)
