MCP server Noteboxd
✓ ПровереноПодключает ИИ-клиенты к энциклопедии ароматов для поиска парфюмерии, нот, брендов, парфюмеров и отзывов сообщества.
Также известен как noteboxd/mcp, mcp, @noteboxd/mcp
- Звёзды
- 1
- Инструменты
- 13
- Загрузки, 30 дней
- —
- Последняя версия
- 0.1.4
- Последний коммит
- 31 июл. 2026 г.
- Лицензия
- MIT
Что такое Noteboxd MCP?
Noteboxd — это MCP server. Подключает ИИ-клиенты к энциклопедии ароматов для поиска парфюмерии, нот, брендов, парфюмеров и отзывов сообщества. Он предоставляет 13 инструментов, например search, search_fragrances, trending.
Сводка сгенерирована из README проекта
О Noteboxd MCP server
Доступ к подробной энциклопедии ароматов прямо из таких ИИ-клиентов, как Claude, ChatGPT или Cursor, позволяет пользователям не полагаться на догадки ИИ при обсуждении парфюмерии. Этот сервер подключает вашего ассистента к базе данных Noteboxd, предоставляя фактическую информацию о парфюмерии, брендах, парфюмерах и конкретных ольфакторных нотах. Он разработан для любителей парфюмерии и разработчиков, которые хотят интегрировать отзывы сообщества и профили ароматов непосредственно в свои рабочие процессы общения.
Вы можете запустить этот сервер локально с помощью npx или подключиться через вариант с хостингом по HTTP. Для использования локальной версии необходимо предоставить NOTEBOXD_API_KEY. Бесплатный уровень позволяет выполнять до 50 вызовов в день без необходимости привязки банковской карты. Сервер предоставляет широкий спектр инструментов только для чтения, включая search_fragrances для фильтрации по цене или семейству ароматов, compare_fragrances для сравнительного анализа и get_review_digest для быстрого понимания мнений сообщества. Он также предлагает специализированные функции, такие как get_similar_fragrances и get_wearing_stats, которые помогают находить новые ароматы на основе существующих коллекций.
Что вы можете с ним делать
- 1Поиск новых рекомендаций по ароматамПопросите ваш ИИ предложить новые парфюмы на основе конкретных ароматов, которые у вас уже есть.
- 2Сравнение различных парфюмерных профилейЗапросите сравнительный анализ двух конкретных ароматов, чтобы увидеть их различия.
- 3Анализ мнений сообществаПолучите краткую сводку того, что реальные пользователи говорят о конкретном аромате.
- 4Изучение ингредиентов парфюмерииИщите конкретные ноты или аккорды, чтобы понять состав парфюма.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить Noteboxd MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка Noteboxd MCP в Claude Code
$ claude mcp add --env 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' mcp -- npx -y @noteboxd/mcpУстановка Noteboxd MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Установка Noteboxd MCP в VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Установка Noteboxd MCP в VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@noteboxd/mcp"],"env":{"NOTEBOXD_API_KEY":"<YOUR_NOTEBOXD_API_KEY>"}}'Установка Noteboxd MCP в Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Установка Noteboxd MCP в Codex
$ codex mcp add mcp --env 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' -- npx -y @noteboxd/mcpУстановка Noteboxd MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@noteboxd/mcp"] [mcp_servers.mcp.env] NOTEBOXD_API_KEY = "<YOUR_NOTEBOXD_API_KEY>"
Установка Noteboxd MCP в Gemini CLI
$ gemini mcp add -s user -e 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' mcp npx -- -y @noteboxd/mcpУстановка Noteboxd MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Инструменты Noteboxd MCP 13
Определено из READMEsearchsearch_fragrancestrendingget_fragranceget_fragrance_reviewsget_similar_fragrancesget_wearing_statscompare_fragrancesget_review_digestbatch_get_fragrancesenrich_fragranceget_perfumer
| search | — | |
| search_fragrances | — | |
| trending | — | |
| get_fragrance | — | |
| get_fragrance_reviews | — | |
| get_similar_fragrances | — | |
| get_wearing_stats | — | |
| compare_fragrances | — | |
| get_review_digest | — | |
| batch_get_fragrances | — | |
| enrich_fragrance | — | |
| get_perfumer | — |
Показать все 13 инструментовПоказать меньше инструментов
list_accords
| list_accords | — |
Конфигурация
NOTEBOXD_API_KEYОбязательноСекретNoteboxd API key (nb_live_...). Create one free at https://developers.noteboxd.com
| Название | Описание | Тип |
|---|---|---|
| NOTEBOXD_API_KEY | Noteboxd API key (nb_live_...). Create one free at https://developers.noteboxd.com | ОбязательноСекрет |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Прошло наши автоматизированные проверки. Это не аудит безопасности: изучите код и предоставьте серверу минимально необходимый доступ. Как работают проверки
- Связанный и доступный исходный репозиторийnoteboxd/mcp is public and reachablegithub.com/noteboxd/mcp ↗Пройдено
- Пакет указывает этот репозиторий как источник@noteboxd/mcp names noteboxd/mcp as sourcenpmjs.com/package/@noteboxd/mcp ↗Пройдено
- Происхождение сборки (аттестация Sigstore)No build attestation published for this releaseНе проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-07-31github.com/noteboxd/mcp ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетNo popular package one edit away from @noteboxd/mcpПройдено
- Нет критических предупреждений в пакете или его зависимостях99 resolved dependencies checked; no critical advisoryosv.dev ↗Пройдено
- Нет скрытых инструкций для модели13 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыNo tool named like delete, drop or execПройдено
- Удалённая конечная точка отвечает на рукопожатие MCPinitialize answered with protocol 2025-06-18 in 781 msПройдено
README
Открыть на GitHubNoteboxd Fragrance & Perfume MCP
A Model Context Protocol server (and API) for fragrance and perfume data. Connect Claude, ChatGPT, Cursor, or any MCP client to the Noteboxd fragrance encyclopedia: fragrances, notes, accords, brands, perfumers, community reviews, and charts.
Once connected, you can ask things like:
- "I own Oud Wood and Aventus. What else should I try for cold-weather formal wear?"
- "Compare Bleu de Chanel and Dior Sauvage."
- "What are reviewers saying about Baccarat Rouge 540?"
The assistant answers from Noteboxd's data instead of guessing.
Quickstart
- Create an API key at developers.noteboxd.com. The free tier is 50 calls/day and needs no card.
- Add the server to your MCP client (see below).
- Ask your assistant about fragrance.
NOTEBOXD_API_KEY=nb_live_your_key npx -y @noteboxd/mcp
Install
Every client uses the same command (npx -y @noteboxd/mcp) with your key in NOTEBOXD_API_KEY.
Claude Desktop / Claude Code
Add to claude_desktop_config.json:
{
"mcpServers": {
"noteboxd": {
"command": "npx",
"args": ["-y", "@noteboxd/mcp"],
"env": { "NOTEBOXD_API_KEY": "nb_live_your_key" }
}
}
}
Cursor
Then set your real key. Or add the JSON block above to ~/.cursor/mcp.json.
VS Code
{
"servers": {
"noteboxd": {
"command": "npx",
"args": ["-y", "@noteboxd/mcp"],
"env": { "NOTEBOXD_API_KEY": "nb_live_your_key" }
}
}
}
Hosted alternative
Noteboxd also runs a hosted MCP server at https://mcp.noteboxd.com/mcp (Streamable HTTP, with
OAuth sign-in) if you would rather not run anything locally. This package is the local,
open-source option.
Tools
All tools are read-only and return JSON. Each call is authenticated with your key and counts against your Noteboxd developer plan (the free tier covers 50 calls/day).
Search and discovery
| Tool | Description |
|---|---|
search |
Search across fragrances, brands, notes, perfumers, collections |
search_fragrances |
Filter fragrances by query, brand, note, family, or price range |
trending |
Trending searches and most-worn fragrances |
list_charts, get_chart |
Chart rankings and leaderboards |
Fragrances
| Tool | Description |
|---|---|
get_fragrance |
Full profile: notes, accords, perfumer, community score |
get_fragrance_reviews |
Paginated community reviews |
get_similar_fragrances |
Fragrances with a similar accord profile |
get_wearing_stats |
Wearing counts over recent windows |
compare_fragrances |
Two fragrances compared side by side |
get_review_digest |
Short summary of a fragrance's reviews |
batch_get_fragrances |
Up to 50 fragrances by id in one call |
enrich_fragrance |
Profile plus notes, accords, reviews, and similar in one call |
Brands, perfumers, notes
| Tool | Description |
|---|---|
get_brand, list_brand_fragrances |
Brand profile and catalogue |
get_perfumer |
Perfumer profile and top creations |
list_notes, get_note |
Browse notes and single-note profiles |
list_accords |
List accord families |
Configuration
| Variable | Required | Description |
|---|---|---|
NOTEBOXD_API_KEY |
yes | Your nb_live_ key from developers.noteboxd.com |
NOTEBOXD_API_BASE_URL |
no | Override the API origin (default https://api.noteboxd.com) |
You can also pass the key with --api-key nb_live_....
How it works
This is a thin local server. It speaks MCP to your client over stdio and forwards each tool call
to api.noteboxd.com/v1 using your key. It stores no data and holds no credentials beyond the key
you provide.
AI client --stdio--> noteboxd-mcp --HTTPS + your key--> api.noteboxd.com/v1
Examples
See examples/ for runnable code: curl, TypeScript, and Python.
Pricing
The server is free and open source. API usage follows your Noteboxd developer plan: a free tier (50 calls/day), then pay-as-you-go per call. Most reads are $0.01; the AI tools cost a few cents. See developers.noteboxd.com/#pricing.
License
Вопросы о Noteboxd MCP
Как добавить Noteboxd MCP в Claude Code?
Выполните claude mcp add --env 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' mcp -- npx -y @noteboxd/mcp в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить Noteboxd MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Какие инструменты предоставляет Noteboxd MCP?
Он предоставляет 13 инструментов, включая search, search_fragrances, trending, get_fragrance, get_fragrance_reviews.
Сколько стоит использование Noteboxd MCP?
Сервер является бесплатным и имеет открытый исходный код, но использование API зависит от вашего тарифного плана Noteboxd для разработчиков, который включает бесплатный уровень до 50 вызовов в день.
Можно ли использовать сервер без локального запуска?
Да, Noteboxd предлагает хостинг MCP сервера по адресу mcp.noteboxd.com с использованием авторизации через OAuth.