scentindex

scentindex

大規模なフレグランスインデックスを覗く窓です。scentindex は公開されている 10ml Fragrance Index に問い合わせ、香水、その中に含まれるノート、それらを作るメゾン、用語を解説するガイドを検索し、インデックスが返す内容をそのまま返します。アカウントも API キーも必要ありません。公開 API を利用する、薄く誠実なクライアントです。

できること：

• フリーテキスト、メゾン、含める／除外するノート、アコード、ファミリー、性別、季節、シーン、スタイルで香水を検索し、カーソルを使って結果をページ送りできます。
• 香水を 1 つ選んで詳細を開き、ノート、アコード、メタデータを確認できます。
• 香水、ノートのセット、アコードのプロファイルを起点に似た香りを探したり、他のメゾンが作る同じ香りのプロファイルを持つ代替品を探したりできます。
• 1 つのノートで香水を閲覧できます。たとえば、ウードを含むすべての香水を探せます。
• ノートが実際にどのような香りなのか、どのような場面でよく使われるのかを尋ねられます。
• 種類や国で絞り込んでフレグランスのメゾンを一覧表示したり、インデックスのガイドや用語集の内容を検索したりできます。

ほとんどのツールでは、応答言語を指定する locale と、基盤となる操作が対応している場合は concise（API のデフォルト）または detailed の response_format を指定できます。一覧表示ツールは limit（1～100）と、以前の応答から取得した不透明な cursor を使ってページ送りします。

ラベル付きサブセット：15 個中 9 個のツール

この再構築版は、元のツールセット 15 個のうち 9 個のツールを実装しています。公開されている上流の OpenAPI ドキュメントに記載された操作に対応する 9 個です。

search_perfumes、get_perfume、find_similar_perfumes、 find_perfume_alternatives、perfumes_by_note、 explain_note、list_houses、get_house、search_guides。

残りの 6 個は、公開されている OpenAPI に対応する操作がなく、引数の形式もアクセス可能な場所に公開されていないため、省略されています。

compare_perfumes、recommend_perfumes、 explain_perfume_term、suggest_layering、 pick_for_occasion、find_gift。

設定

API のベース URL はデフォルトで https://mcp.10ml.com/api/v1 です。環境変数 PERFUME_API_BASE で上書きできます。API キーは不要です。

CLI

各ツールは、1 つの JSON 引数文字列を受け取るサブコマンドです。

npx @reneturcios/scentindex search_perfumes '{"q":"oud","limit":10}'
npx @reneturcios/scentindex get_perfume '{"id":"<perfume id>"}'
npx @reneturcios/scentindex find_similar_perfumes '{"perfume":"<name>"}'
npx @reneturcios/scentindex find_perfume_alternatives '{"perfume":"<name>"}'
npx @reneturcios/scentindex perfumes_by_note '{"note":"oud"}'
npx @reneturcios/scentindex explain_note '{"id":"oud"}'
npx @reneturcios/scentindex list_houses '{"country":"FR"}'
npx @reneturcios/scentindex get_house '{"id":"<house id>"}'
npx @reneturcios/scentindex search_guides '{"q":"layering"}'
npx @reneturcios/scentindex --version

出力は上流の JSON そのままです。終了コード：成功時は 0、実行時エラー（検証エラーや上流のエラーを含む）時は 1、使用方法のエラー時は 2 です。

MCP サーバー

npx -y @reneturcios/scentindex mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "scentindex": {
      "command": "npx",
      "args": ["-y", "@reneturcios/scentindex", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/scentindex
docker run --rm ghcr.io/cloudcorprecords/scentindex perfumes_by_note '{"note":"oud"}'

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios