Cellartracker Wine Cellar MCP

Name: Cellartracker Wine Cellar MCP
Author: slavins-co

本地服务

github.com/slavins-coAI 与智能体72 周前更新

代码仓库

关于 Cellartracker Wine Cellar MCP

CellarTracker MCP 将 CellarTracker 酒窖数据接入 Claude，用于查询酒藏、饮酒建议、购买和品饮记录。它通过账户 CSV 导出读取数据，并提供桌面扩展和 Claude Code 插件两种安装方式。

主要功能

01按名称、产区、年份等搜索酒款
02根据适饮窗口推荐开瓶酒款
03统计酒藏并分析购买记录
04查询到货、待收订单与愿望清单
05读取品饮记录、评分和酒瓶详情
06提供用于数据解读的技能

适用场景

01挑选近期适合开瓶的酒
02查看酒窖库存、位置和瓶数
03分析不同商店或时期的购酒支出
04查看品酒笔记和酒款评分

MCP 相关

MCP 服务提供酒窖查询工具，以及缓存 CSV 表格和缓存时间戳资源。数据通过 CellarTracker 的 CSV 导出端点读取，并在本机缓存。

#wine #cellartracker #claude #claude-code

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cellartracker": {
      "command": "npx",
      "args": [
        "-y",
        "cellartracker-mcp"
      ],
      "env": {
        "CT_USERNAME": "<CT_USERNAME>",
        "CT_PASSWORD": "<CT_PASSWORD>"
      }
    }
  }
}

启动命令npx -y cellartracker-mcp

需要配置的环境变量

CT_USERNAMECellarTracker username. Optional at install: the setup-credentials tool can store login locally instead.

CT_PASSWORD密钥CellarTracker password. Optional at install: the setup-credentials tool can store login locally instead.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmcellartracker-mcp0.5.4stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
color	string	否	按颜色筛选（Red、White、Rosé）
query	string	否	葡萄酒名称搜索词
offset	number	否	分页结果偏移量（默认值为 0）
region	string	否	产区、国家或法定产区
location	string	否	存放位置
varietal	string	否	葡萄品种
vintage_max	number	否	年份上限
vintage_min	number	否	年份下限

详细介绍

CellarTracker MCP

免责声明： 这是一个由社区维护的项目，与 CellarTracker! LLC 无关联，也未获其认可。它代表你自己的账户使用 CellarTracker 的自助式数据导出。

将 Claude 连接到你的 CellarTracker 酒窖。通过自然对话查询库存、获取饮酒建议，并分析购买和饮酒历史。无需刷新库存，也无需分享品鉴笔记。Claude 会直接从你的 CellarTracker 账户中读取这些信息。

安装

针对不同 Claude 界面提供两种安装方式。你可能需要安装其中一种或两种：

	桌面扩展（.mcpb）	Claude Code 插件
适用场景	Chat（桌面版）、Cowork	Cowork、Code
工具	11 个酒窖工具	全部 13 个工具（包括 `setup-credentials` 和 `clear-user-data`）
技能	否	是
设置方式	一键下载	市场或 CLI
凭据	安装时提示输入，存储在操作系统钥匙串中	安装后运行 `setup-credentials`

我需要哪种？

仅使用 Chat（桌面版） → 桌面扩展
仅使用 Code → Claude Code 插件
仅使用 Cowork → 两者均可（插件还提供技能）
全面覆盖 → 两者都安装

同时安装两者是安全的。扩展支持 Chat（桌面版）；插件支持 Cowork 和 Code。在 Cowork 中，两者都可以使用，且不会冲突。请注意，claude.ai 网页聊天会话不受支持。

桌面扩展（Chat 和 Cowork）

一键安装，无需使用终端。

从最新版本下载 cellartracker-mcp.mcpb
双击该文件，在 Claude Desktop 中安装
按提示输入你的 CellarTracker 用户名和密码
开始聊天（例如：“这个月我该开哪些酒？”）

凭据存储在操作系统钥匙串中（macOS 钥匙串 / Windows Credential Manager）。之后如需更新，请前往 Customize > Connectors > CellarTracker。

Claude Code 插件（Cowork 和 Code）

完整体验，包含工具和技能。

通过桌面应用

打开 Code 标签页 > Customize > Browse plugins > Personal > + > Add marketplace from GitHub > 输入 slavins-co/cellartracker-mcp
在插件浏览器中找到“CellarTracker MCP”，然后点击 Install
立即设置凭据：在新的 Code 或 Cowork 会话中说 “设置我的 CellarTracker 凭据”

通过终端

步骤 1： 添加市场

/plugin marketplace add slavins-co/cellartracker-mcp

步骤 2： 安装插件

/plugin install cellartracker-mcp@cellartracker-mcp

步骤 3： 立即设置凭据——说：

“设置我的 CellarTracker 凭据”

Claude 会验证并保存凭据。无需重启。未设置凭据时，工具会返回错误，技能也无法获取数据。

替代方式： 在 shell 配置文件中将 CT_USERNAME 和 CT_PASSWORD 设置为环境变量。

凭据仅存储在你的设备上。使用设置工具时，凭据会作为对话的一部分经过 Anthropic 的服务器，并发送到 CellarTracker 的服务器进行身份验证。

你可以做什么

工具	功能
`setup-credentials`	连接你的 CellarTracker 账户（仅限 Claude Code 插件 — Desktop Extension 会在安装时处理凭据）
`search-cellar`	按名称、颜色、产区、葡萄品种、位置或年份查找葡萄酒
`drinking-recommendations`	按适饮期紧迫程度排序，推荐现在适合开瓶的葡萄酒
`cellar-stats`	收藏概览 — 总数及按任意维度细分的数据
`purchase-history`	按商店、日期范围或葡萄酒分析消费情况
`recent-deliveries`	按送达日期列出某个日期范围内实际收到的葡萄酒（不是下单日期）
`incoming-orders`	已下单但尚未收到的葡萄酒 — 查看即将送达的葡萄酒
`get-wishlist`	你的愿望清单，附有添加每款葡萄酒的原因说明和最高价格
`consumption-history`	你已开瓶的葡萄酒 — 按名称、颜色或日期范围查询
`tasting-notes`	你的品酒笔记和评价，包含评级和分数
`bottle-details`	按名称、位置、酒窖格位、容量或条形码查找单瓶葡萄酒 — 包括酒窖库存和已饮用的葡萄酒
`refresh-data`	强制刷新数据（每 24 小时自动刷新）
`clear-user-data`	从此设备中删除已存储的凭据和缓存数据（仅限 Claude Code 插件）

每个工具都会返回结构化 JSON 和易读文本，客户端可直接对结果进行计算。列表工具支持使用 offset 分页，突破每页 25 条的限制。

资源

如需批量分析且不受单个工具的结果数量限制，服务还会将缓存的表格导出内容作为 MCP 资源公开：cellartracker://tables/<Table>（原始 CSV，每张表一个 — List、Notes、Purchase、Consumed、Availability、Tag、Bottles、Pending）和 cellartracker://meta/cache（每张表的 JSON 数据新鲜度时间戳及服务版本，无需凭据即可读取）。

内置技能

注意： 可通过 Claude Code 插件在 Cowork 和 Code 模式下使用技能。Chat 模式（Desktop Extension）仅提供工具。

cellartracker-data — 教 Claude 解读 CellarTracker 数据：表格关系、评分缩写、适饮期和查询路由。

wine-purchase-evaluator — 用于评估葡萄酒购买的框架。采用双评分系统（品质 + 个人匹配度），给出 BUY/CONSIDER/PASS 结论。检查你的酒窖是否有重复库存、验证价格，并遵循适饮期准则。

如需根据自己的偏好自定义评估器，请将 skills/wine-purchase-evaluator/references/preferences-example.md 复制到同一目录下的 preferences.md，然后进行编辑。

工作原理

CellarTracker 没有官方 API。此服务使用其 CSV 导出接口，通过 HTTPS 使用你的用户名和密码进行身份验证。数据缓存在本地，并每 24 小时自动刷新。

服务只能访问你的数据 — 库存、购买记录、笔记和愿望清单。它无法搜索 CellarTracker 的完整葡萄酒数据库。

安全与凭据

CellarTracker API 的局限性

CellarTracker 不支持 OAuth、API 密钥或作用域令牌。身份验证需要使用你实际的账户用户名和密码，并通过 HTTPS 作为 URL 查询参数发送。虽然传输过程中经过加密，但查询参数通常会记录在 CellarTracker 基础设施的服务器端访问日志中。无法创建只读或访问受限的凭据，因此，此 MCP 仅执行读取操作，但使用的是你的完整账户进行身份验证。

此服务如何保护你的凭据

保护措施	详情
文件权限	配置目录为 `0700`，`.env` 文件为 `0600`——只有你的操作系统用户可以读取
错误剥离	捕获网络错误并重新抛出时移除 URL，因为其中包含凭据
不记录日志	凭据绝不会出现在 stdout、stderr 或错误消息中
操作系统钥匙串	桌面扩展（`.mcpb`）会将凭据存储在 macOS 钥匙串 / Windows 凭据管理器中
支持环境变量	设置 `CT_USERNAME` / `CT_PASSWORD` 环境变量，避免将凭据存储在磁盘上

Claude Code 插件会将凭据以明文形式存储在 ~/.config/cellartracker-mcp/.env 中。我们评估了操作系统钥匙串集成（#22），并决定不采用。原生依赖（node-gyp / keytar）的成本高于其对葡萄酒酒窖数据带来的安全收益，而且桌面扩展路径已经使用操作系统钥匙串。

建议

使用独立密码登录 CellarTracker。不要重复使用其他服务的密码。
如果想避免将凭据持久化到磁盘，优先使用环境变量，而不是 setup-credentials 工具。
在 MCP 配置中固定到特定版本（例如 [email protected]），不要依赖 @latest。

开发

适用于贡献者或任何想从源码运行的人：

git clone https://github.com/slavins-co/cellartracker-mcp.git
cd cellartracker-mcp
npm install
npm run build

# Set credentials
cp .env.example .env
# Edit .env with your CT login

# Test as Claude Code plugin
claude --plugin-dir .

npx 本地解析陷阱

如果你在本仓库的本地检出目录中运行 npx -y cellartracker-mcp（例如通过 MCP 客户端配置），npm 可能会将未限定的包名解析为该本地目录，而不是从注册表下载；因此实际提供服务的是磁盘上 dist/ 中的内容，而非已发布的版本。现在，npm install/npm ci 会运行 prepare 脚本自动重建 dist/，因此新克隆的仓库始终是最新的。但如果你直接编辑 src/，却没有再次运行 npm install 或 npm run build，dist/ 就会悄悄变得过时——服务会在没有任何错误的情况下继续运行旧的编译代码。如果开发时输出看起来不正确，请先重新构建（npm run build），再判断问题是否出在 src/ 中。

AI 披露

本项目在 AI 的协助下开发。

商标声明

本项目与 CellarTracker! LLC 毫无关联。"CellarTracker" 是 CellarTracker! LLC 的商标。

许可证

MIT

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。