Hermes接入瑞幸咖啡——AI点单实战指南

📂 技术笔记 📝 2305 字 ⏱️ 5 min

用过 AI 写代码、记日常、记账等等,但你让 AI 帮你点过咖啡吗?

今天分享一下怎么给 Hermes Agent(爱马仕智能体)装上瑞幸咖啡技能,让它直接帮你下单买咖啡——从选门店、选商品到支付二维码生成,一条龙搞定。

先看效果:

我: 可以点咖啡吗?

Hermes: 好嘞!你在哪个位置?我去查附近的门店~还有想喝什么?

我: 成都XXX X号楼

Hermes: 找到了!附近有好几家… XXX号楼店,营业中,07:00-19:00

……(选商品、下单)

Hermes: 订单创建成功! XXX号楼店 — 加浓美式(超大杯/冰) 原价 ¥21.00 → 优惠 ¥8.10 应付:¥12.90 [支付二维码]

我: 已支付

Hermes: 取餐码 579,去拿吧飞哥 ☕


在AI Agent时代真的是越来越方便了🤙🤙👍,以后可能会接入更多的生活场景内的服务,通过 Skills(技能)MCP(Model Context Protocol)协议 来扩展Agent的能力。每项技能就是一份详细的指南,告诉 AI 怎么完成特定任务;MCP 则是 AI 跟外部服务(比如瑞幸的订单系统)通信的标准协议。

以下是接入瑞幸MCP的步骤和流程。

开始之前:准备瑞幸 MCP Token

要让 Hermes 调用瑞幸的订单系统,需要先拿到一个 MCP Token,相当于 API 密钥。

  1. 打开 瑞幸开放平台 MCP
  2. 点击「登录」(用你的瑞幸账号登录)
  3. 在页面创建 Token,复制保存好

这个 Token 是后续一切操作的基础,先放一边,等会儿配置要用。

以下👇是喂给Agent配置:

请下载安装 My Coffee Skill:https://unpkg.luckincoffeecdn.com/@luckin/my-coffee-skill@latest/dist/my-coffee-skill.zip


手动配置步骤

1. 安装 My-Coffee 技能

Hermes 的技能系统非常灵活,技能文件存在 ~/.hermes/skills/ 下。如果你从社区拉取:

# 通过 Hermes CLI 安装技能
hermes skills install my-coffee

安装后你会看到 ~/.hermes/skills/my-coffee/SKILL.md,里面包含了完整的下单流程、注意事项和 API 参数参考。

2. 配置 MCP Server

在 Hermes 的配置文件(~/.hermes/config.yaml)中找到 MCP 配置段,添加瑞幸的 MCP Server:

mcp:
  servers:
    my-coffee:
      type: streamableHttp
      url: "https://gwmcp.lkcoffee.com/order/user/mcp"
      headers:
        Authorization: "Bearer ${LUCKIN_MCP_TOKEN}"

这里的 ${LUCKIN_MCP_TOKEN} 会从环境变量读取,你也可以直接把 Token 填进去。

3. 保存 Token

两种方式:

方式一:环境变量

export LUCKIN_MCP_TOKEN="你的token"

可以写到 ~/.config/fish/config.fish(飞哥用 fish shell)或 ~/.zshrc

方式二:本地文件(更推荐)

mkdir -p ~/.my-coffee
echo "你的token" > ~/.my-coffee/LUCKIN_MCP_TOKEN
chmod 600 ~/.my-coffee/LUCKIN_MCP_TOKEN

配置完成后重启 Hermes 会话或者 /reset 重置当前会话,技能就生效了。


使用流程:从头下单一次

配置好后对话有多自然?下面是一镜到底实录:

1. 告诉 AI 想喝咖啡

你: 可以点咖啡吗?

Hermes: 好嘞!你在哪个位置?我去查附近的门店~还有想喝什么?

Hermes 加载了 my-coffee 技能后,知道该查门店、搜商品,不会傻傻地回复"我无法帮你点咖啡"。

2. 说出位置

你: 成都XXX X号楼

Hermes: 找到了。XXX X号楼店 — 高新区XXX街XXX X号楼一层大堂

Hermes 背后调用了 maps 地理编码技能,把中文地名转成经纬度,再通过 MCP 查到附近门店列表。

3. 选商品

你: 点一杯冰的特大杯加浓美式

Hermes: 找到了!加浓美式,超大杯冰,默认意式拼配,不另外加糖。预估价 ¥12.9

它会识别你话里的"冰"“特大杯"等属性词,查询商品详情确认属性是否可选,帮你匹配到正确的 SKU。

4. 确认下单

你: 下单

Hermes: 先预览订单 → 原价 ¥21,优惠 ¥8.10 → 应付 ¥12.90,价格不变,直接创建订单!

这里 Hermes 严格遵循下单流程:先预览(previewOrder)→ 校验价格 → 再创建(createOrder),不会跳步。

5. 支付

Hermes 发来支付二维码图片

你: 已支付

Hermes: 查询订单 → 等待取餐状态,取餐码 579 🎉


背后的逻辑

这个技能不仅仅是"调个 API 点单"那么简单,它做了很多细节处理:

严格的下单顺序

确认门店 → 确认商品 → previewOrder → 校验价格 → createOrder

每一步都不可跳过,预览后如果价格不涨就直接创建,不用你确认两次。

智能属性匹配

你说"冰的特大杯”,它能自动映射到 MCP 接口里的 attributeId: 57(冰)attributeId: 594(超大杯),调用 switchProduct 切换 SKU。

优惠券自动使用

预览接口返回了优惠券列表,创建订单时会原样透传,确保你享受到应有的优惠——上面这单原价 ¥21 优惠到 ¥12.9,省了 8 块多。

外送保护

如果你说"送到家里",它会告诉你"目前仅支持到店自取哦",不会傻傻地建一个没法配送的订单。

Token 安全

Token 存本地文件,权限设 600,每次调用从文件读取完整 Token,不会用 *** 占位导致鉴权失败。


拓展一下

同样的思路,Hermes 还支持很多其他 MCP 技能:

技能功能
my-coffee🫘 瑞幸咖啡下单
agently-mail📧 邮件收发管理
wechat-article-publisher📝 发布公众号文章
notion📒 Notion 笔记操作
imessage💬 iMessage 收发
spotify🎵 Spotify 播放控制

每个技能都是类似的结构:一段技能描述 + MCP 配置 + AI 自动按流程执行。


最后的感想

让 AI 帮你点咖啡,听起来像个噱头,但当你真的坐在工位上,说一句"点杯冰美式"然后继续敲代码,几分钟后手机弹出取餐通知——这种感觉还挺爽的。

关键在于 Hermes Agent 把 AI 从"对话机器人"变成了"能办事的助手"。它知道去哪查门店、怎么选商品、什么时候该预览什么时候该下单,甚至知道支付完成后才可以告诉你取餐码——这些业务逻辑都写在技能里,不需要你每一步都手把手教。

技能驱动的 AI,才是真正有用的 AI。


本文中所有操作均基于 Hermes Agent + my-coffee skill v0.8.2,配置环境为 macOS。如果你也在玩 Hermes,欢迎留言交流。