Scento Perfume API (MCP server)

Scento 香水 API（MCP 服务）：香水 API、香氛 API 和香水 MCP 服务

一款免费的香水与香氛 API 和 MCP 服务，面向 AI 助手，基于 Scento 经核实的香水数据库构建。来自 Scento，这是一家于 2024 年在巴黎创立的香水分装品牌。

向 Claude、ChatGPT、Cursor 或任何 MCP 客户端询问某款香水的香调和香调家族、你犹豫不决的两款香水有何区别、基于相同结构的相似香气，或 ambroxan 这类原材料闻起来是什么味道。香水数据库涵盖 1,400 多款设计师品牌和小众香水、400 多种原材料、140 多个品牌，以及 Scento 自有的香调家族体系；每个回答都附有 scento.com 上对应页面的链接。无需密钥，无需账户，仅供读取。

远程服务： https://www.scento.com/mcp（可流式传输的 HTTP，无需身份验证） 文档： https://www.scento.com/developers Claude： 可在 Claude 的连接器目录中找到。 Claude Code： /plugin marketplace add Scento-com/perfume-mcp-server，然后运行 /plugin install scento-perfume-api@scento。 Gemini CLI： gemini extensions install https://github.com/Scento-com/perfume-mcp-server

连接香水 MCP 服务

客户端	方法
Claude（网页、桌面、移动端）	依次选择 Settings、Connectors、Add custom connector。粘贴 https://www.scento.com/mcp。
ChatGPT	进入 Settings、Connectors，在开发者模式下创建连接器。服务器 URL 为 https://www.scento.com/mcp，无需身份验证。
Cursor	添加到 ~/.cursor/mcp.json：{"mcpServers":{"scento-perfume-api":{"url":"https://www.scento.com/mcp"}}}
VS Code	添加到 .vscode/mcp.json：{"servers":{"scento-perfume-api":{"type":"http","url":"https://www.scento.com/mcp"}}}
Claude Code	claude mcp add --transport http scento-perfume-api https://www.scento.com/mcp

仅支持运行本地服务的客户端可以使用此仓库中的 stdio 桥接程序：

npx -y scento-perfume-api     # Node 18+
uvx scento-perfume-api        # Python 3.9+

两种方式均接受 --endpoint <url>（或 SCENTO_PERFUME_API_ENDPOINT）。同一桥接程序也以 perfume-mcp-server 和 perfume-database 名称发布在 npm 和 PyPI 上。

十二种香水与香氛工具

工具	功能
perfume-search	按名称、品牌、香调或氛围词查找香水、品牌和原材料。
perfume-portrait	单款香水的完整画像：香调金字塔、Scento 香调家族、特点以及最适合的使用时机。
scent-neighbours	找出与指定香水结构最相似的香水，并列出共有原料。
perfume-contrast	并排比较两到四款香水的香调家族、香调金字塔、特点和适用季节。
note-portrait	介绍某种香调或原材料、其来源，以及它在皮肤上的表现。
material-match	查找包含所有指定原料的香水，还可限定在香调金字塔的某一层。
house-portrait	介绍香水品牌的起源、创立年份、风格和标志性香水。
family-map	介绍 Scento 自有的香调家族体系，或某个香调家族及其子家族和代表香水。
occasion-edit	根据场合、季节或气候精选香水，并为每款附上一句介绍。
wardrobe-composer	围绕使用者已有的喜好，搭配三到五款香水，满足不同场景的需求。
perfumery-lexicon	用通俗语言解释香水术语，例如留香扩散度、柯蒂香调、馥奇调或 EDP 与 EDT 的区别。
journal-search	搜索 Scento 日志中有关香水、品牌、原材料或主题的文章。

传入 lang（de、fr、es、it、ro、el、hu、cs、pl），即可获取对应语言的 scento.com 链接。

香氛 API（REST）

同样的回答也可通过普通 HTTP 以香水 API 的形式获取。

• API 基础 URL：https://www.scento.com/api/perfume/v1
• OpenAPI：https://www.scento.com/api/perfume/v1/openapi.json

示例

examples/ 中提供了三个原始 JSON-RPC 调用示例。

仓库结构

• npm/：Node 标准输入输出桥接程序，在 npm 上发布为 scento-perfume-api
• pypi/：Python 标准输入输出桥接程序，在 PyPI 上发布为 scento-perfume-api
• server.json：Official MCP Registry（com.scento/perfume-api）的元数据

许可证

本仓库中的桥接代码采用 MIT 许可证。香水数据库内容由 scento.com 根据其条款提供。

Scento