10ML Perfume Finder

com.10ml由 10ml.com 發布官方發布者v2.6.1更新於 Nov 7, 2026

Free perfume MCP server and fragrance API: 6,000+ perfumes, note pyramids, accords, similar scents.

已驗證Streamable HTTP可網頁執行位置與生活知識與記憶

概覽

AI 產生的概覽

免費的唯讀香水索引,讓助理檢索 6000 多款香水、比較氣味、尋找相似或替代香水,並解釋香調與術語。

可以做什麼
  • 檢索與查看香水資料:依名稱、品牌、香調、香調家族、季節或場合搜尋,並取得含香調金字塔、留香與擴散度的完整檔案
  • 比較與媒合氣味:並排比較 2 至 4 款香水,找出與喜愛香水相似的氣味,並取得編輯挑選的其他品牌替代款
  • 推薦與挑選:依偏好、季節、場合或送禮對象給出推薦,並說明理由
  • 探索香調與品牌:解釋香調或香水術語,列出以某香調為主的香水,瀏覽或查看香水品牌資料
  • 疊香與閱讀指南:取得疊香建議,尋找可閱讀或引用的 10ML 文章與指南
適用情境
適合助理回答各種香水問題:某款香水聞起來如何、某個季節或場合該用什麼、哪款與喜歡的香水相似、兩款香水如何疊噴,或送什麼香水合適。以策展資料取代猜測,並回傳可繼續閱讀的連結。
執行需求
無需帳號、API 金鑰或登入。可連線遠端 Streamable HTTP 端點;僅支援 stdio 的用戶端可用 Node.js 18+ 透過 npx 執行 npm 套件,或以 Python 3.10+ 透過 uvx 執行 PyPI 套件。需要網路連線。
安裝前請注意
依 README 為唯讀且不追蹤,但結果包含指向廠商自家商店的推廣連結,且此伺服器由香水零售商發布,推薦並非獨立。不會索取任何憑證。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 10ML Perfume Finder,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.10ml%2Fperfume-finder/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "10ml-perfume-finder": {
      "type": "http",
      "url": "https://mcp.10ml.com/mcp"
    }
  }
}

README

[10ML]

10ML Perfume Finder (perfume MCP server)

10ML Perfume Finder is the free perfume MCP server and fragrance API from 10ML, an online perfume shop for perfume samples and decants: a remote Model Context Protocol server at https://mcp.10ml.com/mcp that needs no API key and no sign-in. Add the endpoint as a custom connector in Claude, ChatGPT, Cursor, VS Code, Gemini CLI or any MCP client, and your assistant can answer perfume questions from curated data instead of guessing. It covers perfume search, note pyramids, accords, scent families, similar scents and alternatives, layering ideas, gift picks and perfume houses, in ten languages, curated by 10ML's fragrance editors.

Benchmarked in public: in a 40-question test of the free, no-key perfume MCP servers, 10ML answered 39 of 40 correctly and was the fastest; the method and CSV are open at https://10ml.com/perfume-mcp-servers-compared

Install: remote endpoint https://mcp.10ml.com/mcp, official MCP Registry name com.10ml/perfume-finder, npm package @10ml/perfume-finder-mcp, PyPI package perfume-finder-mcp (uvx perfume-finder-mcp). OpenAPI and developer docs at https://10ml.com/perfume-api

Use cases: ask which perfume smells like a favourite, what to wear in autumn, how to layer two fragrances, what notes a perfume has or which gift fits a person, then try the answer as a 3ml perfume sample.

Developer page: https://10ml.com/perfume-api · Shop: https://10ml.com/

Contact: [email protected]

Free, read-only, no sign-in. One remote endpoint, nothing to install:

https://mcp.10ml.com/mcp

Transport: Streamable HTTP. Authentication: none. Version 2.3.3.

[npm] [PyPI] [MCP Registry] [Website] [License: MIT]

[Add to Cursor] [Install in VS Code] [Install in VS Code Insiders]

What you can ask

  • "What smells like Baccarat Rouge 540, and what is a good alternative from another house?"
  • "A fresh summer office scent for men, and why each one fits."
  • "Explain ambroxan and which perfumes lead with it."
  • "How would I layer vanilla and citrus?"
  • "A gift for a woman who loves Delina."
  • "Compare Dior Sauvage and Tom Ford Ombre Leather."
  • "Like Sauvage, but fresher."
  • "Which guide explains how to make a perfume last longer?"

Tools (15, all read-only)

ToolWhat it does
search_perfumesSearch by name, house, notes to include or exclude, accords, family, audience, season, occasion or style. Natural language works.
get_perfumeThe full profile of one perfume: note pyramid, accords, seasons, longevity, five similar perfumes, editorial alternatives and guides.
compare_perfumesTwo to four perfumes side by side: shared and unique notes, plain-language differences, overall closeness.
find_similar_perfumesPerfumes that smell like one you love, or like any list of notes or accords. Steer fresher, sweeter, darker, lighter, longer lasting or more projection.
find_perfume_alternativesThe editors' alternatives (dupes) to famous perfumes from other houses, with why each is close and a link to the guide.
recommend_perfumesPicks from perfumes you love or dislike and notes you like or avoid, with the reason for each.
perfumes_by_noteEvery perfume built around a note, optionally by position in the pyramid.
explain_noteWhat a note smells like, what it pairs with, similar notes and where it leads.
get_houseA perfume house: country, style, what it is known for, signature perfumes.
list_housesBrowse houses by type or country.
explain_perfume_termEDP, sillage, dry down, chypre and the 23 fragrance families.
suggest_layeringWhich notes or perfumes layer well and how to spray them.
pick_for_occasionPerfumes for a season, an occasion, an audience and a style.
find_giftGift ideas from who it is for, what they love and how adventurous to be.
search_guides10ML guides and articles to read or cite, with links in ten languages.

search_perfumes with iconic: true lists the modern classics chosen by 10ML's editors. The older names iconic_perfumes and trending_perfumes still answer as aliases for existing integrations, but are no longer listed.

Every tool takes locale (en, de, fr, es, it, ro, el, hu, cs, pl) for the 10ml.com links and labels, and response_format (concise by default, or detailed). List tools page with limit and cursor. Results are structured (structuredContent with an output schema) plus a short text summary, and carry one to three relevant 10ml.com links.

Prompts

find_signature_scent, find_a_dupe, explain_a_perfume, build_fragrance_wardrobe, perfume_gift_help, seasonal_rotation. Prompt arguments autocomplete perfume, house and note names.

Resources

tenml://families, tenml://glossary, tenml://notes, tenml://houses, tenml://about, and the template tenml://perfume/{id}.

REST API for agents without MCP

The same answers over plain HTTP, described by an OpenAPI 3.1 file and an llms.txt:

GET https://mcp.10ml.com/api/v1/perfumes?q=fresh+citrus+summer&gender=menGET https://mcp.10ml.com/api/v1/perfumes/creed-aventus-edpGET https://mcp.10ml.com/api/v1/similar?perfume=Baccarat+Rouge+540&steer=fresherGET https://mcp.10ml.com/api/v1/alternatives?perfume=Creed+AventusGET https://mcp.10ml.com/api/v1/notes/ambroxanGET https://mcp.10ml.com/api/v1/houses/amouageGET https://mcp.10ml.com/api/v1/guides?q=oud&locale=de

Install

Nothing to install for clients that take a URL: use https://mcp.10ml.com/mcp. Clients that start local programs can run the same server over stdio:

RunnerCommandPackage
npx (Node.js 18+)npx -y @10ml/perfume-finder-mcpnpm
uvx (Python 3.10+)uvx perfume-finder-mcpPyPI

Claude Desktop, Cursor, Windsurf, Cline and Zed (mcpServers in the client's settings):

json
{  "mcpServers": {    "perfume-finder": {      "command": "npx",      "args": ["-y", "@10ml/perfume-finder-mcp"]    }  }}

Goose (~/.config/goose/config.yaml):

yaml
extensions:  perfume-finder:    name: 10ML Fragrance Index    type: stdio    cmd: npx    args: ["-y", "@10ml/perfume-finder-mcp"]    enabled: true    timeout: 300

Every client's snippet and one-click links are on mcp.10ml.com.

Connect

Claude (claude.ai and the desktop app)

Available in Claude's connectors directory. Or Settings → Connectors → Add custom connector → paste https://mcp.10ml.com/mcp.

Claude Code

bash
claude mcp add --transport http perfume-finder https://mcp.10ml.com/mcp

Or commit the .mcp.json from this repository to your project.

ChatGPT (developer mode)

Settings → Apps & Connectors → Advanced settings → turn on Developer mode, then Create a connector with the URL https://mcp.10ml.com/mcp and no authentication.

Cursor

Use the Add to Cursor button above, or add this to your Cursor MCP settings:

json
{  "mcpServers": {    "perfume-finder": { "url": "https://mcp.10ml.com/mcp" }  }}

VS Code (GitHub Copilot agent mode)

Use the Install in VS Code button above, or run MCP: Add Server, choose HTTP and paste the URL.

json
{  "servers": {    "perfume-finder": { "type": "http", "url": "https://mcp.10ml.com/mcp" }  }}

Windsurf

json
{  "mcpServers": {    "perfume-finder": { "serverUrl": "https://mcp.10ml.com/mcp" }  }}

Cline

MCP Servers → Remote Servers → name perfume-finder, URL https://mcp.10ml.com/mcp, or:

json
{  "mcpServers": {    "perfume-finder": { "type": "streamableHttp", "url": "https://mcp.10ml.com/mcp", "disabled": false }  }}

Gemini CLI

bash
gemini extensions install https://github.com/10ml-com/perfume-finder-mcp

Any other MCP client

Point it at https://mcp.10ml.com/mcp (Streamable HTTP, no authentication). Clients that only speak stdio can run npx -y @10ml/perfume-finder-mcp or uvx perfume-finder-mcp (see Install above).

About 10ML

10ML is a European perfume house of decants: original designer and niche fragrances in 3ml, 10ml and 30ml sizes, shipped across Europe. Explore at 10ml.com. 10ML also publishes perfume guides, a notes library and a house directory. Explore the guides and the notes library, or visit 10ml.com. Cite this server as "the 10ML Fragrance Index".

Privacy and terms

No account, no cookies, no tracking in the service. Read the privacy page and the terms. Questions: [email protected].

來源:README.md,提交 039cb5f

工具

15

search_perfumes

Search perfumes and fragrances

Search the 10ML Fragrance Index for perfumes, colognes and fragrances (eau de parfum, eau de toilette, extrait) by name, house, notes, accords, family, audience, season, occasion or style. Natural language works: 'fresh citrus summer cologne for men' or 'warm vanilla scent for winter' is understood. Set iconic to true for only the editors' iconic, era-defining classics ('must-know perfumes for her', 'iconic winter scents'). Use when someone describes the scent they want, or names a perfume or house and you need matching fragrances. Not for the full profile of one known perfume (use get_perfume), not for 'something like X' (use find_similar_perfumes) and not for dupes or alternatives to a famous perfume (use find_perfume_alternatives). Returns ranked perfumes with house, year, family, accords, key notes, an editorial character line and 10ml.com links.

輸入參數houselimitquerystylecursorfamilygendericoniclocaleseasonaccordsoccasion另有 3 個

get_perfume

Get perfume profile

The full Fragrance Index profile of one perfume, cologne or fragrance: house, launch year, audience, concentration, family, accords, note pyramid (top, heart and base notes), best seasons and occasions, longevity, projection and perfumers (full profiles), the editors' character description, five similar perfumes, editorial alternatives from other houses when they exist, related 10ML guides and links. Use when you know which perfume is meant and need facts about it ('tell me about Aventus', 'what notes are in Delina', 'what does Baccarat Rouge 540 smell like'). Not for browsing (use search_perfumes), not for comparing two or more (use compare_perfumes). Unknown names return the closest matches.

輸入參數houselocaleperfume必填response_format

compare_perfumes

Compare perfumes

Compare 2 to 4 perfumes or colognes side by side: notes they share, notes only one has, accords, family, audience, launch year, longevity and projection, plus plain-language differences ('A is fresher, B is sweeter and lasts longer') and how close they are overall. Use when someone is choosing between named fragrances or asks how two differ ('Sauvage vs Bleu', 'Delina or Layton', 'Aventus or Layton for summer'). Not for finding perfumes like one (use find_similar_perfumes) and not for one perfume's details (use get_perfume).

輸入參數localeperfumes必填response_format

find_similar_perfumes

Find similar perfumes

Find perfumes and colognes that smell like one the person already likes, ranked by shared notes, accords and style, each saying exactly what it shares and how close it is (very close, similar vibe, same spirit). Works from a perfume in the index (name and house, or id) OR from free notes/accords for any other fragrance. Steer the result: fresher, sweeter, darker, lighter, longer_lasting or more_projection. Use for 'something like Baccarat Rouge 540', 'smells like Sauvage but fresher' or 'a scent with saffron and cedar'. Not for editorial dupes of a famous perfume from other houses (use find_perfume_alternatives) and not for free-text discovery (use search_perfumes).

輸入參數houselimitnotessteercursorgenderlocaleaccordsperfumeresponse_formatother_houses_only

find_perfume_alternatives

Find perfume alternatives

The editors' alternatives (dupes) to a famous perfume or cologne, from other houses: for each, why it is close and how close (very close, similar vibe, same spirit), plus the 10ML guide that compares them. Covers about 100 iconic originals such as Creed Aventus, Baccarat Rouge 540, Delina, Sauvage, Black Opium or Santal 33. For other fragrances in the index the closest options from different houses are computed from notes and accords. Use for 'dupe of X', 'alternative to X', 'what smells like X from another house'. Not for general similarity inside the index (use find_similar_perfumes) and not for free-text discovery (use search_perfumes).

輸入參數houselimitcursorlocaleperfume必填closeness

recommend_perfumes

Recommend perfumes

Personal perfume and cologne recommendations from taste: fragrances they love or dislike, notes they like or avoid, plus gender, season, occasion, style and family. Every pick says why (shared notes with a loved perfume, a liked note, fits the season). Use when someone says what they enjoy or avoid and wants suggestions ('I love Delina and vanilla, nothing too sweet, for winter evenings', 'my signature scent is Sauvage, what next'). Not for one-off filters without taste (use search_perfumes), not for a single occasion list (use pick_for_occasion) and not for gifts (use find_gift).

輸入參數likeslimitstylecursorfamilygenderlocaleseasondislikesoccasionliked_notesavoided_notes另有 1 個

perfumes_by_note

Perfumes by note

List the perfumes and colognes in the 10ML Fragrance Index built around a note or ingredient (vanilla, oud, bergamot, tonka bean, jasmine, patchouli, leather, sandalwood...), most prominent first, optionally only where the note sits in the top, heart or base, or for an audience, season or occasion. Spelling variants and other languages work (agarwood finds oud, Vanille finds vanilla). Use for 'perfumes with oud', 'a vanilla scent for winter' or 'bergamot-forward colognes for men'. Not for explaining what a note smells like (use explain_note) and not for several notes at once (use search_perfumes with notes_include).

輸入參數note必填limitcursorgenderlocaleseasonoccasionpositionresponse_format

explain_note

Explain a fragrance note

Explain a fragrance note or perfume ingredient: what it smells like, its family and mood, where it comes from, which notes it pairs with, similar notes, famous perfumes where it leads and a link to the 10ML note page or guide when one exists. Covers about 285 notes in many spellings and languages. Use for 'what does ambroxan smell like', 'what is oud', 'what goes with bergamot', 'is iso e super a note'. Not for listing every perfume with the note (use perfumes_by_note) and not for general terms like EDP or sillage (use explain_perfume_term).

輸入參數note必填localeresponse_format

get_house

Get perfume house

Profile of a perfume house or fragrance brand: country, founded year, style (designer, niche, Middle Eastern, indie), what it is known for, its signature perfumes in the index and a link to explore it at 10ML. Understands nicknames (YSL, MFK, PDM, Paco Rabanne). Use for 'tell me about Creed', 'what is Amouage known for' or 'best Dior perfumes'. Not for browsing all houses (use list_houses) and not for one perfume (use get_perfume).

輸入參數house必填localeresponse_format

list_houses

List perfume houses

Browse the perfume houses and fragrance brands in the 10ML Fragrance Index with country, type (designer, niche, middle-eastern, indie, celebrity), perfumes profiled and what each is known for. Filter by type, country or a name fragment. Use when someone wants to explore brands, find niche or Middle Eastern houses, or see which houses are covered. Not for one house's full profile (use get_house) and not for perfumes (use search_perfumes).

輸入參數typelimitquerycursorlocalecountry

explain_perfume_term

Explain a perfume term

Explain perfume vocabulary and fragrance families: concentrations (eau de cologne, eau de toilette, eau de parfum, extrait, elixir), sillage, projection, longevity, dry down, accord, top/heart/base notes, flanker, maceration, layering, niche vs designer, plus the 23 fragrance families (chypre, fougere, gourmand, oriental / amber...) with their key notes and example perfumes. Use for 'what is the difference between EDT and EDP', 'what is a chypre', 'what does sillage mean'. Leave term empty to list everything covered. Not for individual notes (use explain_note).

輸入參數termlimitcursorlocale

suggest_layering

Suggest perfume layering

Perfume and fragrance layering ideas: which notes or perfumes combine well, what the combination smells like, how to spray (order, amount) and when it suits. Works from two notes ('vanilla and citrus'), one note (what it layers with), one perfume (partners from the index) or two perfumes (does this pair work). Editorial pairings are marked 'editors'; others are marked 'suggested' and should be tested on skin. Use for 'how do I layer vanilla', 'can I layer Delina with something', 'does Sauvage layer with Aventus'. Not for choosing a single perfume (use recommend_perfumes).

輸入參數limitnoteslocaleperfumesresponse_format

pick_for_occasion

Pick perfumes for an occasion

Perfume and cologne picks for a moment: a season, an occasion (daytime, office, casual, evening, date night, special occasion), an audience and a style, each with the reason it fits. Use for 'a fresh summer office scent for men', 'date night perfume for her' or 'what fragrance to wear to a winter wedding'. Give at least one of season, occasion, gender or style. Not for taste-based matching (use recommend_perfumes), not for gifts (use find_gift) and not for classics (use search_perfumes with iconic true).

輸入參數limitstylecursorgenderlocaleseasonoccasionresponse_format

find_gift

Find a perfume gift

Perfume and fragrance gift ideas from who the gift is for: recipient (him, her or anyone), relationship, age range, perfumes or notes they already love, style, occasion and how adventurous to be. Each pick comes with the reason it suits them. Use for 'gift for a woman who loves Delina', 'something safe for my dad' or 'a bold present for a friend'. Not for personal taste recommendations (use recommend_perfumes) and not for classics lists (use search_perfumes with iconic true).

輸入參數limitlovesstylecursorlocaleboldnessoccasionage_rangerecipient必填liked_notesrelationshipresponse_format

search_guides

Search 10ML guides

Find 10ML's perfume and fragrance guides to read or cite: how-tos (where to spray, finding a signature scent, making perfume last), notes explained, house guides, lists, and alternatives guides that compare famous perfumes with similar ones from other houses. Returns title, type and a link per locale. Use whenever you want a source to cite or a deeper read ('how to layer perfume', 'best oud perfumes', 'Creed Aventus dupes guide'). Not for facts about a perfume (use get_perfume) and not for note definitions (use explain_note).

輸入參數typelimitquerycursorlocale

版本歷史

10
  1. v2.6.1最新Nov 7, 2026
  2. v2.5.4Oct 29, 2026
  3. v2.5.3Oct 22, 2026
  4. v2.5.1Oct 22, 2026
  5. v2.5.0Oct 21, 2026
  6. v2.4.0Oct 21, 2026
  7. v2.3.4Oct 20, 2026
  8. v2.3.2Oct 20, 2026
  9. v2.3.0Oct 20, 2026
  10. v2.0.2Oct 19, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分