CellarTracker

Name: CellarTracker
Author: slavins-co

作者：slavins-coバージョン 0.5.4i★ –iパソコンで動く

レジストリ名io.github.slavins-co/cellartracker-mcp

インストール

概要

作者による説明（英語の原文）

Read-only access to your CellarTracker wine cellar: inventory, drinking windows, purchases, notes.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況iとても新しい↓ 143/週 · ★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: ネットショップ・決済
入力が必要なもの：CT_PASSWORD

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
自分で入力するもの： CT_USERNAME, CT_PASSWORD

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

npmNode.jsのインストール（npxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

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

ターミナルでこれを実行します

claude mcp add cellartracker --env CT_USERNAME=your-value --env CT_PASSWORD=your-value -- npx -y cellartracker-mcp

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

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

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "cellartracker": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "cellartracker-mcp"
      ],
      "env": {
        "CT_USERNAME": "your-value",
        "CT_PASSWORD": "your-value"
      }
    }
  }
}

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

CT_USERNAME env
CellarTracker username. Optional at install: the setup-credentials tool can store login locally instead.
CT_PASSWORD 秘密 env
CellarTracker password. Optional at install: the setup-credentials tool can store login locally instead.

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月8日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント slavins-co で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

ネットショップ・決済のほかのサーバーとの比較i

このカテゴリのほかの2565件のうち0%よりスターが多い
このカテゴリのほかの2565件のうち52%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの2565件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

CellarTrackerは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

入力が必要なもの：CT_PASSWORD

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（0.5.4）がレジストリに届いたのは27 日前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは？

同じカテゴリには：Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：↓ 週あたりのダウンロードi★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

Spree Commerce: open-source B2B and marketplace ecommerce

Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.

作者：spree広く使われている★ 1.6万9 日前更新

クラウドで動く

インストール

Stripe MCP

MCP server integrating with Stripe - tools for customers, products, payments, and more.

作者：stripe広く使われている★ 204313 か月前更新

クラウドで動く✓ stripe.com

インストール

MCP Cn Commerce

8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending

作者：TonyWang-hub初期↓ 73/週★ 9629 日前更新

パソコンで動く

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

CellarTracker MCP

Disclaimer: This is a community-maintained project with no affiliation to, or endorsement by, CellarTracker! LLC. It uses CellarTracker's self-serve data export on your own account's behalf.

Connect Claude to your CellarTracker wine cellar. Query your inventory, get drinking recommendations, and analyze purchases and drinking history, all through natural conversation. No need to refresh your inventory, or share your tasting notes. Claude pulls them directly from your CellarTracker account.

Install

Two install methods for different Claude interfaces. You may need one or both:

	Desktop Extension (.mcpb)	Claude Code Plugin
Works in	Chat (Desktop), Cowork	Cowork, Code
Tools	11 cellar tools	All 13 tools (includes `setup-credentials` and `clear-user-data`)
Skills	No	Yes
Setup	One-click download	Marketplace or CLI
Credentials	Prompted on install, stored in OS keychain	Run `setup-credentials` after install

Which do I need?

Chat (Desktop) only → Desktop Extension
Code only → Claude Code Plugin
Cowork only → Either works (plugin adds skills)
Full coverage → Install both

Installing both is safe. The extension covers Chat (Desktop); the plugin covers Cowork and Code. In Cowork, both are accessible without conflict. Note, there is no coverage for claude.ai web chat sessions.

Desktop Extension (Chat & Cowork)

One-click install. No terminal needed.

Download cellartracker-mcp.mcpb from the latest release
Double-click the file to install in Claude Desktop
Enter your CellarTracker username and password when prompted
Start chatting (e.g. *"What wines should I open this month?"*)

Credentials are stored in your OS keychain (macOS Keychain / Windows Credential Manager). To update them later, go to Customize > Connectors > CellarTracker.

Claude Code Plugin (Cowork & Code)

Full experience with tools and skills.

Via Desktop app

Open the Code tab > Customize > Browse plugins > Personal > + > Add marketplace from GitHub > enter slavins-co/cellartracker-mcp
Find "CellarTracker MCP" in the plugin browser and click Install
Set up credentials immediately: In a new Code or Cowork session, say *"Set up my CellarTracker credentials"*

Via terminal

Step 1: Add the marketplace

/plugin marketplace add slavins-co/cellartracker-mcp

Step 2: Install the plugin

/plugin install cellartracker-mcp@cellartracker-mcp

Step 3: Set up credentials immediately — say:

*"Set up my CellarTracker credentials"*

Claude will verify and save them. No restart needed. Without credentials, tools will return errors and skills won't have data to work with.

Alternative: Set CT_USERNAME and CT_PASSWORD as environment variables in your shell profile.

Credentials are stored only on your machine. When using the setup tool, they pass through Anthropic's servers as part of the conversation. They are sent to CellarTracker's servers for authentication.

What you can do

Tool	What it does
`setup-credentials`	Connect your CellarTracker account (Claude Code plugin only — Desktop Extension handles credentials during install)
`search-cellar`	Find wines by name, color, region, varietal, location, or vintage
`drinking-recommendations`	Wines to open now, sorted by drinking window urgency
`cellar-stats`	Collection overview — totals and breakdowns by any dimension
`purchase-history`	Spending analysis by store, date range, or wine
`recent-deliveries`	Wines actually received in a date range, by delivery date (not order date)
`incoming-orders`	Wines ordered but not yet received — what's on the way
`get-wishlist`	Your wishlist with notes on why each wine was added and a max price
`consumption-history`	Wines you've opened — by name, color, or date range
`tasting-notes`	Your tasting notes and reviews with ratings and scores
`bottle-details`	Find individual bottles by name, location, bin, size, or barcode — cellar and consumed
`refresh-data`	Force a fresh pull (auto-refreshes every 24 hours)
`clear-user-data`	Remove stored credentials and cached data from this machine (Claude Code plugin only)

Every tool returns structured JSON alongside its readable text, so clients can compute over results directly. List tools support offset pagination past the 25-per-page cap.

Resources

For bulk analysis without per-tool result caps, the server also exposes the cached table exports as MCP resources: cellartracker://tables/ (raw CSV, one per table — List, Notes, Purchase, Consumed, Availability, Tag, Bottles, Pending) and cellartracker://meta/cache (JSON freshness timestamps per table plus the server version, readable without credentials).

Included skills

Note: Skills are available in Cowork and Code modes via the Claude Code plugin. Chat mode (Desktop Extension) provides tools only.

cellartracker-data — Teaches Claude to interpret CellarTracker data: table relationships, score abbreviations, drinking windows, and query routing.

wine-purchase-evaluator — Framework for evaluating wine purchases. Two-score system (Quality + Personal Fit) with BUY/CONSIDER/PASS verdicts. Checks your cellar for redundancy, verifies pricing, and applies drinking window discipline.

To customize the evaluator for your preferences, copy skills/wine-purchase-evaluator/references/preferences-example.md to preferences.md in the same directory and edit it.

How it works

CellarTracker has no official API. This server uses their CSV export endpoint, which authenticates with your username and password over HTTPS. Data is cached locally and auto-refreshes every 24 hours.

The server can only access your data — inventory, purchases, notes, and wishlist. It cannot search CellarTracker's full wine database.

Security & credentials

CellarTracker API limitations

CellarTracker has no OAuth, API keys, or scoped tokens. Authentication requires your actual account username and password, sent as URL query parameters over HTTPS. While encrypted on the wire, query parameters are routinely logged in server-side access logs on CellarTracker's infrastructure. There is no way to create read-only or limited-access credentials, therefore, this MCP only performs read operations, but it authenticates with your full account.

How this server protects your credentials

Protection	Details
File permissions	Config directory `0700`, `.env` file `0600` — only your OS user can read
Error stripping	Network errors are caught and re-thrown without the URL, which contains credentials
No logging	Credentials never appear in stdout, stderr, or error messages
OS keychain	Desktop Extension (`.mcpb`) stores credentials in macOS Keychain / Windows Credential Manager
Env var support	Set `CT_USERNAME` / `CT_PASSWORD` environment variables to avoid storing credentials on disk

The Claude Code plugin stores credentials as plaintext in ~/.config/cellartracker-mcp/.env. We evaluated OS keychain integration (#22) and decided against it. The native dependency cost (node-gyp / keytar) outweighs the security benefit for wine cellar data, and the Desktop Extension path already uses the OS keychain.

Recommendations

Use a unique password for CellarTracker. Do not reuse a password from other services.
Prefer environment variables over the setup-credentials tool if you want to avoid persisting credentials to disk.
Pin to a specific version in your MCP config (e.g., cellartracker-mcp@0.5.2) rather than relying on @latest.

Development

For contributors or anyone who wants to run from source:

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 local-resolution footgun

If you run npx -y cellartracker-mcp (e.g. via an MCP client config) with your working directory inside a local checkout of this repo, npm can resolve the bare package name to that local folder instead of downloading it from the registry — so whatever is on disk in dist/ gets served, not the published version. npm install/npm ci now runs a prepare script that rebuilds dist/ automatically, so a fresh clone is always current. But if you edit src/ directly and don't run npm install or npm run build again, dist/ will silently go stale — the server keeps running the old compiled code with no error. If output looks wrong while developing, rebuild (npm run build) before assuming the bug is in src/.

AI Disclosure

This project was developed with AI assistance.

Trademark Disclosure

This project is in no way affiliated or connected to CellarTracker! LLC. "CellarTracker" is a trademark of CellarTracker! LLC.

License

MIT

CellarTracker

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

ネットショップ・決済のほかのサーバーとの比較i

よくある質問

代わりの候補

Spree Commerce: open-source B2B and marketplace ecommerce

Stripe MCP

MCP Cn Commerce

作者のREADME

CellarTracker MCP

Install

Desktop Extension (Chat & Cowork)

Claude Code Plugin (Cowork & Code)

Via Desktop app

Via terminal

What you can do

Resources

Included skills

How it works

Security & credentials

CellarTracker API limitations

How this server protects your credentials

Recommendations

Development

Set credentials

Edit .env with your CT login

Test as Claude Code plugin

npx local-resolution footgun

AI Disclosure

Trademark Disclosure

License