Fragrance & Perfume MCP (Noteboxd)

Noteboxd フレグランス＆香水 MCP

フレグランスと香水のデータを扱うModel Context Protocolサーバー（および API）です。Claude、ChatGPT、Cursor などの MCP クライアントをNoteboxdのフレグランス百科事典に接続できます。フレグランス、香料、アコード、ブランド、調香師、コミュニティのレビュー、ランキングを利用できます。

接続すると、次のような質問ができます。

• 「Oud Wood と Aventus を持っています。寒い季節のフォーマルな装いに合う、ほかの香水を教えてください」
• 「Bleu de Chanel と Dior Sauvage を比較してください」
• 「Baccarat Rouge 540 について、レビューではどのような意見が寄せられていますか？」

アシスタントは推測ではなく、Noteboxd のデータに基づいて回答します。

クイックスタート

1. developers.noteboxd.comで API キーを作成します。無料プランは 1 日あたり 50 回利用でき、カードは不要です。
2. MCP クライアントにサーバーを追加します（下記を参照）。
3. アシスタントにフレグランスについて質問します。

NOTEBOXD_API_KEY=nb_live_your_key npx -y @noteboxd/mcp

インストール

どのクライアントでも、NOTEBOXD_API_KEY にキーを設定して、同じコマンド（npx -y @noteboxd/mcp）を使用します。

Claude Desktop / Claude Code

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "noteboxd": {
      "command": "npx",
      "args": ["-y", "@noteboxd/mcp"],
      "env": { "NOTEBOXD_API_KEY": "nb_live_your_key" }
    }
  }
}

Cursor

その後、実際のキーを設定します。または、上記の JSON ブロックを ~/.cursor/mcp.json に追加します。

VS Code

{
  "servers": {
    "noteboxd": {
      "command": "npx",
      "args": ["-y", "@noteboxd/mcp"],
      "env": { "NOTEBOXD_API_KEY": "nb_live_your_key" }
    }
  }
}

ホスト型の代替手段

ローカルで何も実行したくない場合は、Noteboxd のホスト型 MCP サーバー（Streamable HTTP、OAuth サインイン対応）https://mcp.noteboxd.com/mcp も利用できます。このパッケージは、ローカルで実行するオープンソースの選択肢です。

ツール

すべてのツールは読み取り専用で、JSON を返します。各呼び出しはキーで認証され、Noteboxd の開発者プランの利用回数に加算されます（無料プランでは 1 日あたり 50 回まで利用できます）。

検索と探索

ツール	説明
search	フレグランス、ブランド、香料、調香師、コレクションを横断して検索します
search_fragrances	クエリ、ブランド、香料、系統、価格帯でフレグランスを絞り込みます
trending	トレンドの検索語と、最もよく着用されているフレグランスを表示します
list_charts, get_chart	ランキングとリーダーボードを表示します

フレグランス

ツール	説明
get_fragrance	香料、アコード、調香師、コミュニティスコアを含む詳細プロフィール
get_fragrance_reviews	ページ分割されたコミュニティレビュー
get_similar_fragrances	アコードの構成が似たフレグランス
get_wearing_stats	直近の期間ごとの着用数
compare_fragrances	2 つのフレグランスを並べて比較します
get_review_digest	フレグランスのレビューを簡潔に要約します
batch_get_fragrances	1 回の呼び出しで ID を指定して最大 50 件のフレグランスを取得します
enrich_fragrance	1 回の呼び出しで、プロフィールに加えて香料、アコード、レビュー、類似品を取得します

ブランド、調香師、香料

ツール	説明
get_brand, list_brand_fragrances	ブランドのプロフィールとカタログ
get_perfumer	調香師のプロフィールと代表作
list_notes, get_note	香料の一覧と個々の香料のプロフィール
list_accords	アコードの系統一覧

設定

変数	必須	説明
NOTEBOXD_API_KEY	はい	developers.noteboxd.comで取得した nb_live_ キー
NOTEBOXD_API_BASE_URL	いいえ	API のオリジンを上書きします（デフォルトは https://api.noteboxd.com）

--api-key nb_live_... を使ってキーを渡すこともできます。

仕組み

これは薄いローカルサーバーです。stdio 経由でクライアントと MCP で通信し、各ツール呼び出しをキーを使って api.noteboxd.com/v1 に転送します。データは保存せず、指定したキー以外の認証情報も保持しません。

AI client  --stdio-->  noteboxd-mcp  --HTTPS + your key-->  api.noteboxd.com/v1

使用例

実行可能なコード（curl、TypeScript、Python）は examples/ をご覧ください。

料金

このサーバーは無料でオープンソースです。API の利用料金は Noteboxd の開発者プランに従います。無料枠（1 日あたり 50 回）を超えると、呼び出しごとの従量課金となります。読み取りの大半は 0.01 ドルで、AI ツールは数セントです。詳しくは developers.noteboxd.com/#pricing をご覧ください。

ライセンス

MIT