Cellarion

cellarion-mcp

将 AI 连接到你的酒窖。这是 Cellarion 的 MCP 桥接程序，可让基于 stdio 的 MCP 客户端（Claude Desktop、Cursor 等）连接到你的 Cellarion 账户，让你可以向助手询问：

• “今晚该开哪瓶，免得它过了最佳饮用期？”
• “我还剩 Barolo 吗？存放在哪里？”
• “我上个月喝了什么？评分是多少？”

它完全运行在你的机器上，并使用个人且可撤销的 API 令牌代理到 Cellarion 服务的 /api/mcp 端点。工具和资源由服务定义——更新 Cellarion 后，AI 可执行的操作也会自动更新；这个桥接程序无需了解这些内容。

设置

1. 在 Cellarion 中创建令牌：Settings → API tokens → 创建一个具有 read 权限范围的令牌。复制 cel_… 值（只会显示一次）。
2. 将服务添加到客户端。 Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "cellarion": {
      "command": "npx",
      "args": ["-y", "cellarion-mcp"],
      "env": {
        "CELLARION_TOKEN": "cel_your_token_here"
      }
    }
  }
}

3. 重启客户端。向它询问你的酒窖信息。

自行托管 Cellarion？ 将桥接程序指向你的实例：

      "env": {
        "CELLARION_TOKEN": "cel_your_token_here",
        "CELLARION_URL": "https://cellarion.your-domain.example"
      }

（也可以使用命令行参数 --token / --url。）

安全说明

• 该令牌的权限范围有限，可在 Cellarion 中立即撤销——撤销后，此桥接程序会在会话中途失去访问权限。
• 具有 read 权限范围的令牌只能读取你自己的酒窖数据。它不能修改任何内容、读取其他账户的数据，也不能管理令牌。
• 令牌只会发送到 CELLARION_URL 中的主机，不会发送到其他任何地方。不会记录任何内容。
• 如果连接在请求过程中断开，桥接程序会重新连接，并再次获取工具和资源列表。对于服务标记为只读的工具调用，也会再次发送。对于任何其他工具调用（可能会更改你的酒窖），只有在携带 idempotency_key 时才会再次发送，因为服务届时会返回首次调用的结果，而不会重复执行。否则，AI 会收到错误，并可先确认发生了什么，再决定是否重试。如果服务因桥接程序的会话已过期而拒绝了请求，该请求就从未执行过，因此桥接程序会开启新会话并重新发送请求。

许可证

与 Cellarion 本身一样，采用 AGPL-3.0。源代码：https://github.com/jagduvi1/Cellarion（cellarion-mcp/）。