Noteboxd MCP server
✓ VerifiedMenghubungkan AI client ke ensiklopedia wewangian untuk mencari parfum, notes, brand, perfumer, dan ulasan komunitas.
Juga dikenal sebagai noteboxd/mcp, mcp, @noteboxd/mcp
- Stars
- 1
- Tools
- 13
- Unduhan, 30 hari
- —
- Versi terbaru
- 0.1.4
- Commit terakhir
- 31 Jul 2026
- Lisensi
- MIT
Apa itu Noteboxd MCP?
Noteboxd adalah MCP server. Menghubungkan AI client ke ensiklopedia wewangian untuk mencari parfum, notes, brand, perfumer, dan ulasan komunitas. Server ini menyediakan 13 tool, seperti search, search_fragrances, trending.
Ringkasan dibuat dari README proyek
Tentang Noteboxd MCP server
Mengakses ensiklopedia wewangian yang mendetail langsung dari dalam AI client seperti Claude, ChatGPT, atau Cursor memungkinkan Anda untuk mendapatkan informasi akurat saat berdiskusi tentang aroma, tanpa perlu menebak-nebak. Server ini menghubungkan asisten Anda ke database Noteboxd, menyediakan informasi faktual tentang parfum, brand, perfumer, dan notes aroma tertentu. Server ini dirancang untuk para pecinta wewangian dan developer yang ingin mengintegrasikan ulasan komunitas serta profil aroma langsung ke dalam workflow percakapan mereka.
Anda dapat menjalankan server ini secara lokal menggunakan npx atau terhubung melalui opsi hosted HTTP. Untuk menggunakan versi lokal, Anda harus menyediakan NOTEBOXD_API_KEY. Tier gratis memungkinkan 50 panggilan per hari tanpa memerlukan kartu kredit. Server ini menyediakan berbagai read-only tools, termasuk search_fragrances untuk memfilter berdasarkan harga atau family, compare_fragrances untuk analisis perbandingan, dan get_review_digest untuk memahami sentimen komunitas dengan cepat. Server ini juga menawarkan fungsi khusus seperti get_similar_fragrances dan get_wearing_stats untuk membantu menemukan aroma baru berdasarkan koleksi yang sudah ada.
Apa yang bisa Anda lakukan dengannya
- 1Menemukan rekomendasi aroma baruMinta AI Anda untuk menyarankan parfum baru berdasarkan aroma spesifik yang sudah Anda miliki.
- 2Membandingkan profil parfum yang berbedaMinta perbandingan berdampingan antara dua parfum spesifik untuk melihat perbedaannya.
- 3Menganalisis sentimen komunitasDapatkan ringkasan mengenai apa yang dikatakan pengguna asli tentang parfum tertentu.
- 4Menjelajahi bahan wewangianCari notes atau accords spesifik untuk memahami komposisi dari sebuah parfum.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal Noteboxd MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal Noteboxd MCP di Claude Code
$ claude mcp add --env 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' mcp -- npx -y @noteboxd/mcpInstal Noteboxd MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Instal Noteboxd MCP di VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Instal Noteboxd MCP di VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@noteboxd/mcp"],"env":{"NOTEBOXD_API_KEY":"<YOUR_NOTEBOXD_API_KEY>"}}'Instal Noteboxd MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Instal Noteboxd MCP di Codex
$ codex mcp add mcp --env 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' -- npx -y @noteboxd/mcpInstal Noteboxd MCP di 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>"
Instal Noteboxd MCP di Gemini CLI
$ gemini mcp add -s user -e 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' mcp npx -- -y @noteboxd/mcpInstal Noteboxd MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Tool Noteboxd MCP 13
Terdeteksi dari 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 | — |
Tampilkan semua 13 toolTampilkan lebih sedikit tool
list_accords
| list_accords | — |
Konfigurasi
NOTEBOXD_API_KEYWajibRahasiaNoteboxd API key (nb_live_...). Create one free at https://developers.noteboxd.com
| Nama | Deskripsi | Tipe |
|---|---|---|
| NOTEBOXD_API_KEY | Noteboxd API key (nb_live_...). Create one free at https://developers.noteboxd.com | WajibRahasia |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkaunoteboxd/mcp is public and reachablegithub.com/noteboxd/mcp ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernya@noteboxd/mcp names noteboxd/mcp as sourcenpmjs.com/package/@noteboxd/mcp ↗Lolos
- Provenance build (atestasi Sigstore)No build attestation published for this releaseTidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-07-31github.com/noteboxd/mcp ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from @noteboxd/mcpLolos
- Tidak ada advisory kritis pada paket atau dependensinya99 resolved dependencies checked; no critical advisoryosv.dev ↗Lolos
- Tidak ada instruksi tersembunyi untuk model13 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelNo tool named like delete, drop or execLolos
- Endpoint remote merespons handshake MCPinitialize answered with protocol 2025-06-18 in 781 msLolos
README
Lihat di 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
Pertanyaan tentang Noteboxd MCP
Bagaimana cara menambahkan Noteboxd MCP ke Claude Code?
Jalankan claude mcp add --env 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' mcp -- npx -y @noteboxd/mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan Noteboxd MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Tool apa yang disediakan Noteboxd MCP?
Server ini menyediakan 13 tool, termasuk search, search_fragrances, trending, get_fragrance, get_fragrance_reviews.
Berapa biaya untuk menggunakan Noteboxd MCP?
Server ini gratis dan open source, namun penggunaan API bergantung pada paket developer Noteboxd Anda, yang mencakup tier gratis sebanyak 50 panggilan per hari.
Bisakah saya menggunakan server ini tanpa menjalankannya secara lokal?
Ya, Noteboxd menawarkan hosted MCP server di mcp.noteboxd.com yang menggunakan OAuth sign-in.