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의 세 기둥

이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.

사용자 의견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는 인터넷에 있는 서버에만 연결할 수 있어요. 다른 앱을 고르세요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

직접 입력할 값

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

이 카테고리의 다른 서버 2554개 중 0%보다 스타가 많아요
이 카테고리의 다른 서버 2554개 중 52%보다 최근에 레지스트리에 공개됐어요
기본 점검 결과가 이 카테고리의 다른 서버 2554개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

CellarTracker, 안전한가요?

해당하는 기본 점검 1개 중 1개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

입력해야 할 값: CT_PASSWORD

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(0.5.4)은 26일 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

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 스타i세 기둥: 리뷰 · 점검 · 사용 정도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성장 중★ 2천12개월 전 업데이트

클라우드에서 실행✓ 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의 세 기둥

할 수 있는 일

설치

설치하기 전에

직접 입력할 값

할 수 있는 일

기본 점검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