Perfume Picks

Perfume Picks MCP サーバー

Claude、またはMCP対応のAIクライアントから、Perfume Picksのフレグランスデータベースを検索できます。13,000種類以上のフレグランスに読み取り専用でアクセスでき、ノートのピラミッド、アコード、厳選されたデュープ、コミュニティの使用データを確認できます。

Perfume Picksは、iOS向けのフレグランスDNAとコレクション記録アプリです — App Storeから入手。

ツール

ツール	機能
search_fragrances	ブランド、ファミリー、性別、希望小売価格（MSRP）のフィルターに対応した全文カタログ検索
get_fragrance	1種類の香水（スラッグまたは名前で指定）の詳細情報：ノートのピラミッド、アコード、コミュニティスコア
find_dupes	よく似た香りの、より安価なフレグランスを厳選して提示し、一致率も表示 — 「価格を抑えてXのような香りを楽しむには」
find_similar	事前計算された類似度ランキングから、最も似ているフレグランスを提示
get_recommendations	ノート／アコードの好み、予算、シーン、性別に基づくおすすめ
compare_fragrances	横並び比較：ノート、共通／異なるアコード、スコア、価格差
trending_fragrances	Perfume Picksユーザーが現在コレクションに加えているフレグランス
what_to_wear_tonight	今すぐ使える香り — デート向けのおすすめにはコミュニティの好感度データを、オフィス向けには職場での使いやすさスコアを使用

すべての応答には、情報源の明記、引用に使える要約文、リンク、データの更新日が含まれます。すべてのスコアリングは決定論的で、サーバー内ではAI呼び出しは行われません。すべてのツールには読み取り専用／冪等の注釈が付いています。

インストール（Claude Desktop）

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

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

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

Claude Desktopを再起動してください。APIキーや設定は不要です — サーバーには一般公開の読み取り専用アクセスが付属しています。

設定（任意）

環境変数でデフォルト値を上書きできます（明示的に設定した環境変数のみ — このパッケージが.envファイルを読み込むことはありません）：

変数	用途
SUPABASE_URL	データベースURLを上書きします
SUPABASE_SERVICE_ROLE_KEY	内部利用専用 — 過去30日間のコレクション追加数に基づくリアルタイムのトレンド情報を利用できます。このキーは決して配布しないでください。

サービスキーがない場合、trending_fragrancesはカタログの人気度に基づく情報を返し、応答内でその方式を示します。

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

URLを指定して利用するウェブエージェントおよびMCPクライアント向けのストリーミング可能なHTTPエンドポイント：

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

Smitheryおよび公式MCPレジストリにもio.github.bguillow-rgb/perfume-picksとして掲載されています。

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

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

• 「Baccarat Rouge 540のような香りで、もっと手頃なものは？」 → find_dupes（一致率付きの厳選デュープ。例：Lattafa Ana Abiyedh Rouge、90%）
• 「夏の結婚式におすすめのフレグランスは？」 → occasion: "wedding"を指定したget_recommendations
• 「ベルガモット、バニラ、アンバーを含むフレグランスは？」 → それらのノートをpreferencesに指定したget_recommendations
• 「Bleu de Chanelに似た香水は？」 → find_similar
• 「今夜のデートには何をつければいい？」 → what_to_wear_tonight（コミュニティの好感度データに基づいてスコアリング）
• 「SauvageとBleu de Chanelを比較して。」 → compare_fragrances

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

{
  "dupes": [
    { "name": "Lattafa Ana Abiyedh Rouge", "match_pct": 90,
      "savings_usd": 200.0, "msrp_usd": 39.99 }
  ],
  "attribution": {
    "source": "Perfume Picks — Fragrance DNA & Collection Journal",
    "links": { "website": "https://perfumepicks.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のみを実行し、呼び出しは毎分60回に制限されています。

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

データと出典表記

香水のデータ、ノートピラミッド、類似香水の一致情報、コミュニティスコアは Perfume Picks が監修しています。出典を明記すれば自由に引用できます。

出典：Perfume Picks — フレグランス DNA & コレクションジャーナル（perfumepicks.app）

各香水に記載されているデータの更新日は、最終更新日を示しています。