luckin-mcp-proxy

luckin-mcp-proxy

A local proxy for Luckin Coffee's official MCP, enabling natural language ordering, reordering, and shop/product search with automatic retry and memory.

Category
Visit Server

README

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

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured