Pour Picks

Pour Picks MCP サーバー

Claude や、MCP 互換の AI クライアントから、Pour Picks のバーボンとウイスキーのデータベースを検索できます。テイスティングプロファイル、価格、ペアリング、コミュニティ評価が構造化された 4,700 本以上のボトルに、読み取り専用でアクセスできます。

Pour Picks は、iOS 向けのバーボンコレクターの日誌です — App Store から入手できます。

ツール

ツール	機能
search_bottles	カテゴリー、価格、アルコール度数のフィルターに対応したカタログ全文検索
get_bottle	1 本のボトルの全記録（ID または名前で指定）：テイスティングプロファイル、価格、ペアリング、コミュニティ評価
find_similar	風味プロファイルが似たボトルを、共通するノートとボディ／甘さ／チャーの近さに基づいてランキング表示
find_cheaper_alternative	同じスタイルで、プロファイルが似ていて、価格の安いボトル
get_recommendations	風味の好み＋予算＋シーンに基づいたおすすめ
compare_bottles	度数、熟成年数、価格、共通する風味と異なる風味、評価を並べて比較
trending_bottles	Pour Picks のユーザーが今セラーに加えているボトル
pour_tonight_suggestion	気分、シーン、季節に合わせた今夜の一杯

すべての応答には、出典、引用用の要約文、リンク、データの鮮度を示す日付が含まれます。スコアリングはすべて決定論的で、サーバー内部では AI 呼び出しは行われません。

インストール（Claude Desktop）

Node.js 18 以降が必要です。

claude_desktop_config.json に追加します（Claude Desktop → Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "pour-picks": {
      "command": "npx",
      "args": ["-y", "pour-picks-mcp"]
    }
  }
}

Claude Desktop を再起動します。API キーや設定は不要です — サーバーにはパブリックな読み取り専用アクセスが組み込まれています。

ローカルのチェックアウトから

{
  "mcpServers": {
    "pour-picks": {
      "command": "node",
      "args": ["/path/to/pour-picks/mcp-server/dist/index.js"]
    }
  }
}

設定（任意）

Pour Picks のパブリックな読み取り専用キーを使用するため、設定なしで動作します。環境変数を設定すると、デフォルト値が上書きされます。

変数	用途
SUPABASE_URL	データベース URL を上書きします
SUPABASE_SERVICE_ROLE_KEY	内部使用のみ — 直近 30 日間のセラーへの追加状況をリアルタイムで取得できます。このキーを決して配布しないでください。

サービスキーがない場合、trending_bottles はカタログの人気度にフォールバックし、応答内で使用した方法を示します（method: "catalog_popularity_tier" と "cellar_adds_last_30_days"）。

リモートエンドポイント（インストール不要）

URL を指定して利用するウェブエージェントや MCP クライアント向けのストリーマブル HTTP：

https://nqnigdqkcvrziwcbgily.supabase.co/functions/v1/mcp

Smithery（ゲートウェイ pour-picks--bguillow.run.tools）および公式 MCP レジストリにも、io.github.bguillow-rgb/pour-picks として掲載されています。

エージェントへのリクエスト例

エージェントがこれらのツールで回答できる質問：

• 「Eagle Rare に似ていて、もっと見つけやすいバーボンは？」 → find_similar
• 「バニラ、オーク、キャラメルのノートがある、60 ドル未満のバーボンをおすすめして。」 → taste_preferences: ["vanilla","oak","caramel"], budget: 60 を指定して get_recommendations
• 「価格は高くないけれど、Blanton's のような味のものは？」 → find_cheaper_alternative
• 「Eagle Rare と Buffalo Trace を比較して。」 → compare_bottles
• 「寒い夜に飲むバーボンは何がおすすめ？」 → season: "winter" を指定して pour_tonight_suggestion
• 「コレクターが今追加しているボトルは？」 → trending_bottles

応答例の形式（一部省略）：

{
  "cheaper_alternatives": [
    { "name": "Buffalo Trace W.L. Weller 12 Year", "price_usd": 49.99,
      "similarity": 0.78, "savings_usd": 15.0,
      "shared_flavors": ["caramel", "oak"] }
  ],
  "attribution": {
    "source": "Pour Picks — The Bourbon Collector's Journal",
    "links": { "website": "https://pourpicks.app/" }
  }
}

開発

npm install
npm run dev     # run from TypeScript via tsx
npm run build   # compile to dist/
npm start       # run compiled server

このサーバーは stdio 経由で MCP を使用します。カタログへのアクセスは構造上、読み取り専用です。すべてのクエリ経路で、行レベルセキュリティにより一般公開されているテーブルに対して SELECT のみを実行し、呼び出しは 1 分あたり 60 回に制限されています。

利用状況のテレメトリー：各ツール呼び出しについて、ツール名、引数、クライアント名／バージョン、処理時間、成功／失敗を、書き込み専用のログテーブルに記録します（RLS により挿入のみ可能で、内容は一般公開されません）。ユーザーの身元、アカウントデータ、会話内容は収集しません。ログ記録は応答を妨げないよう、非同期で実行されます。

公開

• npm：このディレクトリから npm publish を実行します（package.json の mcpName フィールドがパッケージをレジストリエントリーに紐付けます）。
• MCP Registry：このディレクトリの server.json はレジストリマニフェストです。npm パッケージが公開された後、mcp-publisher CLI を使って公開します：mcp-publisher login github && mcp-publisher publish。

データとクレジット表記

ボトルのデータ、テイスティングプロフィール、ペアリングは Pour Picks が厳選しています。クレジットを表記すれば、自由に引用できます。

出典：Pour Picks — The Bourbon Collector's Journal（pourpicks.app）

コミュニティの評価数は各評価に含まれているため、サンプル数を判断できます。各ボトルの鮮度日付は、最後に情報を補完した日付を示しています。