Serveur MCP Noteboxd
✓ VérifiéConnecte les clients IA à une encyclopédie de la parfumerie pour rechercher des parfums, des notes, des marques, des parfumeurs et des avis de la communauté.
Aussi connu sous noteboxd/mcp, mcp, @noteboxd/mcp
- Étoiles
- 1
- Outils
- 13
- Téléchargements, 30 jours
- —
- Dernière version
- 0.1.4
- Dernier commit
- 31 juil. 2026
- Licence
- MIT
Qu'est-ce que Noteboxd MCP ?
Noteboxd est un serveur MCP. Connecte les clients IA à une encyclopédie de la parfumerie pour rechercher des parfums, des notes, des marques, des parfumeurs et des avis de la communauté. Il expose 13 outils, comme search, search_fragrances, trending.
Résumé généré à partir du README du projet
À propos du MCP server Noteboxd
Accéder à une encyclopédie détaillée de la parfumerie directement depuis des clients IA comme Claude, ChatGPT ou Cursor permet aux utilisateurs de dépasser les suppositions de l'IA lorsqu'ils discutent de senteurs. Ce serveur connecte votre assistant à la base de données Noteboxd, fournissant des informations factuelles sur les parfums, les marques, les parfumeurs et des notes olfactives spécifiques. Il est conçu pour les passionnés de parfums et les développeurs qui souhaitent intégrer des avis de la communauté et des profils olfactifs directement dans leurs flux de travail conversationnels.
Vous pouvez exécuter ce serveur localement via npx ou vous connecter via une option HTTP hébergée. Pour utiliser la version locale, vous devez fournir une NOTEBOXD_API_KEY. Le niveau gratuit permet 50 appels par jour sans nécessiter de carte bancaire. Le serveur propose une large gamme d'outils en lecture seule, notamment search_fragrances pour filtrer par prix ou par famille, compare_fragrances pour une analyse comparative, et get_review_digest pour comprendre rapidement le sentiment de la communauté. Il offre également des fonctions spécialisées comme get_similar_fragrances et get_wearing_stats pour aider à découvrir de nouvelles senteurs basées sur des collections existantes.
Ce que vous pouvez faire avec
- 1Découverte de nouvelles recommandations olfactivesDemandez à votre IA de suggérer de nouveaux parfums basés sur les senteurs spécifiques que vous possédez déjà.
- 2Comparaison de différents profils de parfumDemandez une comparaison côte à côte de deux fragrances spécifiques pour voir leurs différences.
- 3Analyse du sentiment de la communautéObtenez un résumé de ce que les utilisateurs réels disent d'une fragrance particulière.
- 4Exploration des ingrédients de parfumerieRecherchez des notes ou des accords spécifiques pour comprendre la composition d'un parfum.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer Noteboxd MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller Noteboxd MCP dans Claude Code
$ claude mcp add --env 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' mcp -- npx -y @noteboxd/mcpInstaller Noteboxd MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Installer Noteboxd MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Installer Noteboxd MCP dans VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@noteboxd/mcp"],"env":{"NOTEBOXD_API_KEY":"<YOUR_NOTEBOXD_API_KEY>"}}'Installer Noteboxd MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Installer Noteboxd MCP dans Codex
$ codex mcp add mcp --env 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' -- npx -y @noteboxd/mcpInstaller Noteboxd MCP dans 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>"
Installer Noteboxd MCP dans Gemini CLI
$ gemini mcp add -s user -e 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' mcp npx -- -y @noteboxd/mcpInstaller Noteboxd MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Outils MCP Noteboxd 13
Détectés depuis le 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 | — |
Afficher les 13 outilsAfficher moins d'outils
list_accords
| list_accords | — |
Configuration
NOTEBOXD_API_KEYRequisSecretNoteboxd API key (nb_live_...). Create one free at https://developers.noteboxd.com
| Nom | Description | Type |
|---|---|---|
| NOTEBOXD_API_KEY | Noteboxd API key (nb_live_...). Create one free at https://developers.noteboxd.com | RequisSecret |
Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessiblenoteboxd/mcp is public and reachablegithub.com/noteboxd/mcp ↗Réussi
- Le nom du package correspond au dépôt source@noteboxd/mcp names noteboxd/mcp as sourcenpmjs.com/package/@noteboxd/mcp ↗Réussi
- Provenance du build (attestation Sigstore)No build attestation published for this releaseNon vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-07-31github.com/noteboxd/mcp ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from @noteboxd/mcpRéussi
- Aucun avis critique dans le package ou ses dépendances99 resolved dependencies checked; no critical advisoryosv.dev ↗Réussi
- Aucune instruction cachée destinée au modèle13 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNo tool named like delete, drop or execRéussi
- Le point de terminaison distant répond à la poignée de main MCPinitialize answered with protocol 2025-06-18 in 781 msRéussi
README
Voir sur 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
Questions sur Noteboxd MCP
Comment ajouter Noteboxd MCP à Claude Code ?
Exécutez claude mcp add --env 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' mcp -- npx -y @noteboxd/mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter Noteboxd MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Quels outils Noteboxd MCP fournit-il ?
Il expose 13 outils, dont search, search_fragrances, trending, get_fragrance, get_fragrance_reviews.
Combien coûte l'utilisation du MCP Noteboxd ?
Le serveur est gratuit et open source, mais l'utilisation de l'API dépend de votre forfait développeur Noteboxd, qui inclut un niveau gratuit de 50 appels par jour.
Puis-je utiliser le serveur sans l'exécuter localement ?
Oui, Noteboxd propose un MCP server hébergé sur mcp.noteboxd.com qui utilise une connexion OAuth.