Scento Perfume Compendium

Scento Perfume API（MCP 服务）：Perfume API、Fragrance API 和 Perfume MCP Server

Scento Perfume API 是一款免费的香水 API 和香水 MCP 服务，面向开发者、AI Agent 和香氛应用。一个端点即可访问 Scento 经验证的香水数据库：涵盖来自 160 多个品牌的 1,500 多款香水和 400 多种原材料，每款香水都包含完整的香调金字塔（前调、中调和后调）、香调家族、适用场合和相似香气链接。每个香调金字塔都可追溯至品牌方或授权零售商，因此返回的香调来自瓶身标注，而非抓取后猜测所得。

可将其作为远程 MCP 服务连接到 https://www.scento.com/mcp（适用于 Claude、ChatGPT、Cursor、VS Code 和任何 MCP 客户端），也可通过 https://www.scento.com/api/perfume/v1 调用 REST 香氛 API，并在 https://www.scento.com/api/perfume/v1/openapi.json 查看 OpenAPI 规范。无需 API 密钥、无需注册，也无需购买不同级别的速率限制：完全免费。

12 个工具覆盖实际需求：perfume-search、perfume-portrait、scent-neighbours、perfume-contrast、note-portrait、material-match、house-portrait、family-map、occasion-edit、wardrobe-composer、perfumery-lexicon、journal-search。可按名称或香调搜索香水，获取包含香调金字塔和香调家族的香水香调 API 响应，查找相似香气，对比两款香水，查询香氛原料并匹配使用该原料的香水，梳理香调家族，搭配适合特定场合的香水或打造香水衣橱，以及阅读香水制作词典。

为何优于其他香水 API：免费且无需密钥；MCP、REST 和 OpenAPI 集于一项服务；香调数据库和香氛原料数据库集中在同一处；支持 10 种语言的回答（英语、德语、法语、西班牙语、意大利语、罗马尼亚语、波兰语、捷克语、匈牙利语、希腊语）；信息来源可信。由香水工坊 Scento 构建并维护。文档：https://www.scento.com/developers

这是一款免费的香水和香氛 API 及 MCP 服务，面向 AI 助手，基于 Scento 经验证的香水数据库构建。由 Scento 提供；这家香水分装品牌于 2024 年创立于巴黎。

向 Claude、ChatGPT、Cursor 或任何 MCP 客户端询问香水的香调和香调家族、两款让你难以抉择的香水有何不同、基于相同结构的相似香气，或龙涎酮等原材料闻起来是什么气味。香水数据库涵盖 1,500 多款设计师品牌和小众香水、400 多种原材料、160 多个品牌，以及 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 基础地址：https://www.scento.com/api/perfume/v1
• OpenAPI：https://www.scento.com/api/perfume/v1/openapi.json

示例

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

仓库结构

• npm/：Node stdio 桥接程序，以 scento-perfume-api 的名称发布到 npm
• pypi/：Python stdio 桥接程序，以 scento-perfume-api 的名称发布到 PyPI
• server.json：Official MCP Registry（com.scento/perfume-api）的元数据

许可证

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

Scento