Noteboxd MCP server
✓ VerifiziertVerbindet KI-Clients mit einer Duft-Enzyklopädie, um nach Parfüms, Noten, Marken, Parfümeuren und Community-Bewertungen zu suchen.
Auch bekannt als noteboxd/mcp, mcp, @noteboxd/mcp
- Stars
- 1
- Tools
- 13
- Downloads, 30 Tage
- —
- Neueste Version
- 0.1.4
- Letzter Commit
- 31. Juli 2026
- Lizenz
- MIT
Was ist Noteboxd MCP?
Noteboxd ist ein MCP server. Verbindet KI-Clients mit einer Duft-Enzyklopädie, um nach Parfüms, Noten, Marken, Parfümeuren und Community-Bewertungen zu suchen. Er stellt 13 Tools bereit, etwa search, search_fragrances, trending.
Zusammenfassung generiert aus dem README des Projekts
Über Noteboxd MCP server
Der Zugriff auf eine detaillierte Duft-Enzyklopädie direkt aus KI-Clients wie Claude, ChatGPT oder Cursor ermöglicht es Nutzern, bei Diskussionen über Düfte über bloßes Raten der KI hinauszugehen. Dieser Server verbindet deinen Assistenten mit der Noteboxd-Datenbank und liefert Fakten über Parfüms, Marken, Parfümeure und spezifische Duftnoten. Er wurde für Duft-Enthusiasten und Entwickler entwickelt, die Community-Bewertungen und Duftprofile direkt in ihre Conversational Workflows integrieren möchten.
Du kannst diesen Server lokal über npx ausführen oder dich über eine gehostete HTTP-Option verbinden. Um die lokale Version zu nutzen, musst du einen NOTEBOXD_API_KEY bereitstellen. Die kostenlose Stufe erlaubt 50 Aufrufe pro Tag ohne Kreditkarte. Der Server bietet eine breite Palette an Read-only Tools, darunter search_fragrances zum Filtern nach Preis oder Duftfamilie, compare_fragrances für den direkten Vergleich und get_review_digest, um schnell die Stimmung der Community zu erfassen. Er bietet zudem spezialisierte Funktionen wie get_similar_fragrances und get_wearing_stats, um neue Düfte basierend auf bestehenden Kollektionen zu entdecken.
Was du damit machen kannst
- 1Entdeckung neuer DuftempfehlungenBitte deine KI, neue Parfüms basierend auf den spezifischen Düften vorzuschlagen, die du bereits besitzt.
- 2Vergleich verschiedener ParfümprofileFordere einen direkten Vergleich zweier spezifischer Düfte an, um deren Unterschiede zu sehen.
- 3Analyse der Community-StimmungErhalte eine Zusammenfassung dessen, was echte Nutzer über ein bestimmtes Parfüm sagen.
- 4Erkundung von DuftinhaltsstoffenSuche nach spezifischen Noten oder Akkorden, um die Zusammensetzung eines Parfüms zu verstehen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Noteboxd MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenNoteboxd MCP in Claude Code installieren
$ claude mcp add --env 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' mcp -- npx -y @noteboxd/mcpNoteboxd MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Noteboxd MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Noteboxd MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@noteboxd/mcp"],"env":{"NOTEBOXD_API_KEY":"<YOUR_NOTEBOXD_API_KEY>"}}'Noteboxd MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Noteboxd MCP in Codex installieren
$ codex mcp add mcp --env 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' -- npx -y @noteboxd/mcpNoteboxd MCP in Codex config.toml installieren
~/.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 in Gemini CLI installieren
$ gemini mcp add -s user -e 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' mcp npx -- -y @noteboxd/mcpNoteboxd MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Noteboxd MCP tools 13
Erkannt aus dem 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 | — |
Alle 13 Tools anzeigenWeniger Tools anzeigen
list_accords
| list_accords | — |
Konfiguration
NOTEBOXD_API_KEYErforderlichSecretNoteboxd API key (nb_live_...). Create one free at https://developers.noteboxd.com
| Name | Beschreibung | Typ |
|---|---|---|
| NOTEBOXD_API_KEY | Noteboxd API key (nb_live_...). Create one free at https://developers.noteboxd.com | ErforderlichSecret |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarnoteboxd/mcp is public and reachablegithub.com/noteboxd/mcp ↗Bestanden
- Paket nennt dieses Repository als Quelle@noteboxd/mcp names noteboxd/mcp as sourcenpmjs.com/package/@noteboxd/mcp ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)No build attestation published for this releaseNicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-07-31github.com/noteboxd/mcp ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from @noteboxd/mcpBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten99 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell13 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-Handshakeinitialize answered with protocol 2025-06-18 in 781 msBestanden
README
Auf GitHub ansehenNoteboxd 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 Fragen
Wie füge ich Noteboxd MCP zu Claude Code hinzu?
Führe claude mcp add --env 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' mcp -- npx -y @noteboxd/mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Noteboxd MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet Noteboxd MCP?
Er stellt 13 Tools bereit, darunter search, search_fragrances, trending, get_fragrance, get_fragrance_reviews.
Wie viel kostet die Nutzung des Noteboxd MCP?
Der Server ist kostenlos und Open Source, aber die API-Nutzung hängt von deinem Noteboxd-Developer-Plan ab, der eine kostenlose Stufe von 50 Aufrufen pro Tag beinhaltet.
Kann ich den Server nutzen, ohne ihn lokal auszuführen?
Ja, Noteboxd bietet einen gehosteten MCP server unter mcp.noteboxd.com an, der OAuth Sign-in nutzt.