Fragrance & Perfume MCP (Noteboxd)

Noteboxd 香氛与香水 MCP

一个用于香氛与香水数据的模型上下文协议服务（和 API）。将 Claude、ChatGPT、Cursor 或任何 MCP 客户端连接到 Noteboxd 香氛百科：香氛、香调、香韵、品牌、调香师、社区评价和排行榜。

连接后，你可以询问：

• “我有 Oud Wood 和 Aventus。寒冷天气的正式场合，我还可以试试什么？”
• “比较一下 Bleu de Chanel 和 Dior Sauvage。”
• “评论者对 Baccarat Rouge 540 有什么看法？”

助手会根据 Noteboxd 的数据作答，而不是凭空猜测。

快速开始

1. 在 developers.noteboxd.com 创建 API 密钥。免费套餐每天可调用 50 次，无需银行卡。
2. 将服务添加到 MCP 客户端（见下文）。
3. 向助手询问香氛相关问题。

NOTEBOXD_API_KEY=nb_live_your_key npx -y @noteboxd/mcp

安装

所有客户端都使用同一条命令（npx -y @noteboxd/mcp），并通过 NOTEBOXD_API_KEY 提供密钥。

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 服务，地址为 https://mcp.noteboxd.com/mcp（Streamable HTTP，支持 OAuth 登录），如果你不想在本地运行任何内容，可以使用它。此软件包是本地开源选项。

工具

所有工具均为只读，并返回 JSON。每次调用都会使用你的密钥进行身份验证，并计入你的 Noteboxd 开发者套餐用量（免费套餐每天可调用 50 次）。

搜索与发现

工具	描述
search	搜索香氛、品牌、香调、调香师和系列
search_fragrances	按查询词、品牌、香调、香调家族或价格范围筛选香氛
trending	热门搜索和最常穿用的香氛
list_charts, get_chart	排行榜和排名列表

香氛

工具	描述
get_fragrance	完整档案：香调、香韵、调香师、社区评分
get_fragrance_reviews	分页显示社区评价
get_similar_fragrances	香韵特征相似的香氛
get_wearing_stats	近期各时间段的穿用次数
compare_fragrances	并排比较两款香氛
get_review_digest	香氛评价的简短摘要
batch_get_fragrances	单次调用按 ID 获取最多 50 款香氛
enrich_fragrance	单次调用获取档案以及香调、香韵、评价和相似香氛

品牌、调香师、香调

工具	描述
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_... 传入密钥。

工作原理

这是一个轻量级本地服务。它通过标准输入/输出与客户端进行 MCP 通信，并使用你的密钥将每次工具调用转发到 api.noteboxd.com/v1。它不存储任何数据，也不会保留你提供的密钥以外的凭据。

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

示例

请参阅 examples/ 中可运行的代码：curl、TypeScript 和 Python。

定价

此服务免费且开源。API 使用量遵循你的 Noteboxd 开发者套餐：免费层级（每天 50 次调用），之后按调用次数付费。大多数读取操作为 $0.01；AI 工具的费用为几美分。 请参阅 developers.noteboxd.com/#pricing。

许可证

MIT