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 のインターフェースに応じた 2 つのインストール方法があります。どちらか一方、または両方が必要になる場合があります。

	デスクトップ拡張機能（.mcpb）	Claude Code プラグイン
対応環境	チャット（デスクトップ）、Cowork	Cowork、Code
ツール	セラー用ツール 11 個	全 13 個のツール（`setup-credentials` と `clear-user-data` を含む）
スキル	なし	あり
セットアップ	ワンクリックでダウンロード	マーケットプレイスまたは CLI
認証情報	インストール時に入力し、OS のキーチェーンに保存	インストール後に `setup-credentials` を実行

どちらが必要ですか？

チャット（デスクトップ）のみ → デスクトップ拡張機能
Code のみ → Claude Code プラグイン
Cowork のみ → どちらでも使えます（プラグインにはスキルが追加されます）
すべての環境で使う → 両方をインストール

両方をインストールしても問題ありません。拡張機能はチャット（デスクトップ）に対応し、プラグインは Cowork と Code に対応します。Cowork では、どちらも競合せずに利用できます。なお、claude.ai のウェブチャットセッションには対応していません。

デスクトップ拡張機能（チャットと Cowork）

ワンクリックでインストールできます。ターミナルは不要です。

最新リリースから cellartracker-mcp.mcpb をダウンロードします
ファイルをダブルクリックして Claude Desktop にインストールします
求められたら CellarTracker のユーザー名とパスワードを入力します
チャットを始めます（例：「今月はどのワインを開けるのがおすすめですか？」）

認証情報は OS のキーチェーン（macOS キーチェーン／Windows 資格情報マネージャー）に保存されます。後で更新するには、「カスタマイズ」>「コネクター」>「CellarTracker」の順に移動します。

Claude Code プラグイン（Cowork と Code）

ツールとスキルを備えた、すべての機能を利用できます。

デスクトップアプリから

「Code」タブ >「カスタマイズ」>「プラグインを参照」>「個人用」> + >「GitHub からマーケットプレイスを追加」の順に開き、slavins-co/cellartracker-mcp を入力します
プラグインブラウザーで「CellarTracker MCP」を見つけ、インストールをクリックします
すぐに認証情報を設定します：新しい Code または Cowork セッションで、*「CellarTracker の認証情報を設定して」*と言います

ターミナルから

ステップ 1： マーケットプレイスを追加します

/plugin marketplace add slavins-co/cellartracker-mcp

ステップ 2： プラグインをインストールします

/plugin install cellartracker-mcp@cellartracker-mcp

ステップ 3： すぐに認証情報を設定します。次のように言います：

「CellarTracker の認証情報を設定して」

Claude が認証情報を確認して保存します。再起動は不要です。認証情報がない場合、ツールはエラーを返し、スキルは処理に必要なデータを利用できません。

別の方法： シェルのプロファイルで 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 を返すため、クライアントは結果を直接処理できます。リストを返すツールでは、1 ページあたり 25 件の上限を超えて取得するために、offset によるページネーションを利用できます。

リソース

ツールごとの結果上限なしで一括分析を行えるよう、サーバーはキャッシュされたテーブルのエクスポートも 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 — テーブル間の関連、スコアの略語、飲み頃、クエリの振り分けなど、CellarTracker のデータを解釈する方法を Claude に教えます。

wine-purchase-evaluator — ワインの購入を評価するためのフレームワークです。BUY／CONSIDER／PASS の判定に、2 つのスコア（品質＋個人への適合度）を使用します。セラー内の重複を確認し、価格を検証して、飲み頃を厳密に考慮します。

評価ツールを好みに合わせてカスタマイズするには、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` です。読み取れるのはお使いの OS ユーザーだけです
エラーからの情報除去	ネットワークエラーを捕捉し、認証情報を含む URL を除去してから再スローします
ログ出力なし	認証情報が stdout、stderr、エラーメッセージに出力されることはありません
OS キーチェーン	Desktop Extension（`.mcpb`）は、認証情報を macOS Keychain／Windows Credential Manager に保存します
環境変数のサポート	`CT_USERNAME`／`CT_PASSWORD` 環境変数を設定すると、認証情報をディスクに保存せずに済みます

Claude Code プラグインは、認証情報を平文で ~/.config/cellartracker-mcp/.env に保存します。OS キーチェーンとの連携（#22）を評価しましたが、採用しないことにしました。ネイティブ依存関係（node-gyp／keytar）のコストは、ワインセラーのデータに対するセキュリティ上のメリットを上回り、Desktop Extension ではすでに OS キーチェーンを使用しているためです。

推奨事項

CellarTracker には他で使っていないパスワードを使用してください。他のサービスのパスワードを使い回さないでください。
認証情報をディスクに保存したくない場合は、setup-credentials ツールよりも環境変数を優先してください。
@latest に頼るのではなく、MCP 設定で特定のバージョンを指定してください（例：[email protected]）。

開発

コントリビューター、またはソースから実行したい方へ：

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 は現在、dist/ を自動的に再ビルドする prepare スクリプトを実行するため、新しいクローンは常に最新の状態です。ただし、src/ を直接編集してから npm install または npm run build を再実行しないと、dist/ は気づかないうちに古い状態になります。エラーも出ないまま、サーバーは古いコンパイル済みコードを実行し続けます。開発中に出力がおかしい場合は、バグが src/ にあると判断する前に再ビルドしてください（npm run build）。

AI に関する開示

このプロジェクトは AI の支援を受けて開発されました。

商標に関する開示

このプロジェクトは、CellarTracker! LLC とは一切提携しておらず、関係もありません。「CellarTracker」は CellarTracker! LLC の商標です。

ライセンス

MIT

Markdown 対応

ログインしてコメント

基本情報

作者: slavins-co
言語: node
バージョン: 0.5.4
トランスポート: stdio
掲載日: 2026年3月15日
最終更新: 2 週間前
公式 Registry: io.github.slavins-co/cellartracker-mcp

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。