MCP server de Noteboxd
✓ VerificadoConecta clientes de IA a una enciclopedia de fragancias para buscar perfumes, notas, marcas, perfumistas y reseñas de la comunidad.
También conocido como noteboxd/mcp, mcp, @noteboxd/mcp
- Stars
- 1
- Herramientas
- 13
- Descargas, 30 días
- —
- Última versión
- 0.1.4
- Último commit
- 31 jul 2026
- Licencia
- MIT
¿Qué es Noteboxd MCP?
Noteboxd es un MCP server. Conecta clientes de IA a una enciclopedia de fragancias para buscar perfumes, notas, marcas, perfumistas y reseñas de la comunidad. Expone 13 herramientas, como search, search_fragrances, trending.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Noteboxd
Acceder a una enciclopedia de fragancias detallada desde clientes de IA como Claude, ChatGPT o Cursor permite a los usuarios ir más allá de las suposiciones de la IA al hablar de aromas. Este servidor conecta a tu asistente con la base de datos de Noteboxd, proporcionando información real sobre perfumes, marcas, perfumistas y notas olfativas específicas. Está diseñado para entusiastas de las fragancias y desarrolladores que quieran integrar reseñas de la comunidad y perfiles de aromas directamente en sus flujos de trabajo conversacionales.
Puedes ejecutar este servidor localmente usando npx o conectarte a través de una opción de HTTP alojado. Para usar la versión local, debes proporcionar una NOTEBOXD_API_KEY. El nivel gratuito permite 50 llamadas al día sin necesidad de una tarjeta de crédito. El servidor ofrece una amplia gama de herramientas de solo lectura, incluyendo search_fragrances para filtrar por precio o familia, compare_fragrances para análisis comparativos y get_review_digest para entender rápidamente el sentimiento de la comunidad. También ofrece funciones especializadas como get_similar_fragrances y get_wearing_stats para ayudar a descubrir nuevos aromas basados en colecciones existentes.
Qué puedes hacer con él
- 1Descubrir nuevas recomendaciones de aromasPide a tu IA que sugiera nuevos perfumes basados en los aromas específicos que ya posees.
- 2Comparar diferentes perfiles de perfumeSolicita una comparación detallada de dos fragancias específicas para ver en qué se diferencian.
- 3Analizar el sentimiento de la comunidadObtén un resumen de lo que los usuarios reales están diciendo sobre una fragancia en particular.
- 4Explorar ingredientes de fraganciasBusca notas o acordes específicos para entender la composición de un perfume.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Noteboxd MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Noteboxd MCP en Claude Code
$ claude mcp add --env 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' mcp -- npx -y @noteboxd/mcpInstalar Noteboxd MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Instalar Noteboxd MCP en VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Instalar Noteboxd MCP en VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@noteboxd/mcp"],"env":{"NOTEBOXD_API_KEY":"<YOUR_NOTEBOXD_API_KEY>"}}'Instalar Noteboxd MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Instalar Noteboxd MCP en Codex
$ codex mcp add mcp --env 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' -- npx -y @noteboxd/mcpInstalar Noteboxd MCP en 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>"
Instalar Noteboxd MCP en Gemini CLI
$ gemini mcp add -s user -e 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' mcp npx -- -y @noteboxd/mcpInstalar Noteboxd MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Herramientas de Noteboxd MCP 13
Detectado desde el 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 | — |
Mostrar las 13 herramientasMostrar menos herramientas
list_accords
| list_accords | — |
Configuración
NOTEBOXD_API_KEYObligatorioSecretoNoteboxd API key (nb_live_...). Create one free at https://developers.noteboxd.com
| Nombre | Descripción | Tipo |
|---|---|---|
| NOTEBOXD_API_KEY | Noteboxd API key (nb_live_...). Create one free at https://developers.noteboxd.com | ObligatorioSecreto |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesiblenoteboxd/mcp is public and reachablegithub.com/noteboxd/mcp ↗Aprobado
- El paquete indica este repositorio como su origen@noteboxd/mcp names noteboxd/mcp as sourcenpmjs.com/package/@noteboxd/mcp ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-07-31github.com/noteboxd/mcp ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from @noteboxd/mcpAprobado
- No hay avisos críticos en el paquete ni en sus dependencias99 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo13 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo tool named like delete, drop or execAprobado
- El endpoint remoto responde al handshake de MCPinitialize answered with protocol 2025-06-18 in 781 msAprobado
README
Ver en 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
Preguntas sobre Noteboxd MCP
¿Cómo agrego Noteboxd MCP a Claude Code?
Ejecuta claude mcp add --env 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' mcp -- npx -y @noteboxd/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Noteboxd MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona Noteboxd MCP?
Expone 13 herramientas, incluidas search, search_fragrances, trending, get_fragrance, get_fragrance_reviews.
¿Cuánto cuesta usar el Noteboxd MCP?
El servidor es gratuito y de código abierto, pero el uso de la API depende de tu plan de desarrollador de Noteboxd, que incluye un nivel gratuito de 50 llamadas al día.
¿Puedo usar el servidor sin ejecutarlo localmente?
Sí, Noteboxd ofrece un MCP server alojado en mcp.noteboxd.com que utiliza inicio de sesión mediante OAuth.