Noteboxd MCP sunucusu
✓ DoğrulandıAI istemcilerini parfümleri, notaları, markaları, parfümörleri ve topluluk incelemelerini aramak için bir koku ansiklopedisine bağlar.
Ayrıca bilinen adı noteboxd/mcp, mcp, @noteboxd/mcp
- Yıldızlar
- 1
- Araçlar
- 13
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.1.4
- Son commit
- 31 Tem 2026
- Lisans
- MIT
Noteboxd MCP nedir?
Noteboxd bir MCP sunucusudur. AI istemcilerini parfümleri, notaları, markaları, parfümörleri ve topluluk incelemelerini aramak için bir koku ansiklopedisine bağlar. 13 araç sunar; örneğin search, search_fragrances, trending.
Özet, projenin README dosyasından oluşturuldu
Noteboxd MCP sunucusu hakkında
Claude, ChatGPT veya Cursor gibi AI istemcileri üzerinden detaylı bir koku ansiklopedisine erişmek, kullanıcıların kokular hakkında konuşurken yapay zekanın tahminlerine dayanmak yerine gerçek verilere ulaşmasını sağlar. Bu server, asistanınızı Noteboxd veritabanına bağlayarak parfümler, markalar, parfümörler ve belirli koku notaları hakkında olgusal bilgiler sunar. Koku meraklıları ve topluluk incelemeleri ile koku profillerini doğrudan konuşma iş akışlarına entegre etmek isteyen geliştiriciler için tasarlanmıştır.
Bu server'ı npx kullanarak yerel olarak çalıştırabilir veya barındırılan bir HTTP seçeneği üzerinden bağlanabilirsiniz. Yerel sürümü kullanmak için bir NOTEBOXD_API_KEY sağlamanız gerekir. Ücretsiz katman, kredi kartı gerektirmeden günde 50 çağrıya izin verir. Server; fiyat veya koku ailesine göre filtreleme yapmak için search_fragrances, yan yana analiz için compare_fragrances ve topluluk görüşlerini hızlıca anlamak için get_review_digest dahil olmak üzere geniş bir okuma amaçlı araç yelpazesi sunar. Ayrıca, mevcut koleksiyonlara dayanarak yeni kokular keşfetmenize yardımcı olmak için get_similar_fragrances ve get_wearing_stats gibi özel fonksiyonlar da sunar.
Neler yapabilirsiniz
- 1Yeni koku önerileri keşfetmeYapay zekanızdan halihazırda sahip olduğunuz belirli kokulara dayanarak yeni parfümler önermesini isteyin.
- 2Farklı parfüm profillerini karşılaştırmaİki spesifik parfümün nasıl farklılaştığını görmek için yan yana karşılaştırma talep edin.
- 3Topluluk görüşlerini analiz etmeGerçek kullanıcıların belirli bir parfüm hakkında neler söylediğine dair bir özet alın.
- 4Koku bileşenlerini incelemeBir parfümün kompozisyonunu anlamak için belirli notaları veya akorları arayın.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Noteboxd MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleNoteboxd MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' mcp -- npx -y @noteboxd/mcpNoteboxd MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Noteboxd MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Noteboxd MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@noteboxd/mcp"],"env":{"NOTEBOXD_API_KEY":"<YOUR_NOTEBOXD_API_KEY>"}}'Noteboxd MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Noteboxd MCP'yi Codex içine yükleyin
$ codex mcp add mcp --env 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' -- npx -y @noteboxd/mcpNoteboxd MCP'yi Codex config.toml içine yükleyin
~/.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'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' mcp npx -- -y @noteboxd/mcpNoteboxd MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Noteboxd MCP araçları 13
README dosyasından algılandısearchsearch_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 aracın tümünü gösterDaha az araç göster
list_accords
| list_accords | — |
Yapılandırma
NOTEBOXD_API_KEYGerekliGizliNoteboxd API key (nb_live_...). Create one free at https://developers.noteboxd.com
| Ad | Açıklama | Sunucu |
|---|---|---|
| NOTEBOXD_API_KEY | Noteboxd API key (nb_live_...). Create one free at https://developers.noteboxd.com | GerekliGizli |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirnoteboxd/mcp is public and reachablegithub.com/noteboxd/mcp ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyor@noteboxd/mcp names noteboxd/mcp as sourcenpmjs.com/package/@noteboxd/mcp ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-07-31github.com/noteboxd/mcp ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from @noteboxd/mcpGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok99 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok13 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişNo tool named like delete, drop or execGeçti
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorinitialize answered with protocol 2025-06-18 in 781 msGeçti
Noteboxd 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 soruları
Noteboxd MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' mcp -- npx -y @noteboxd/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Noteboxd MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Noteboxd MCP hangi araçları sunar?
13 araç sunar; bunlar arasında search, search_fragrances, trending, get_fragrance, get_fragrance_reviews yer alır.
Noteboxd MCP kullanmanın maliyeti nedir?
Sunucu ücretsiz ve açık kaynaklıdır, ancak API kullanımı günde 50 çağrı içeren ücretsiz katmanı da kapsayan Noteboxd geliştirici planınıza bağlıdır.
Sunucuyu yerel olarak çalıştırmadan kullanabilir miyim?
Evet, Noteboxd, OAuth ile giriş yapılan mcp.noteboxd.com adresinde barındırılan bir MCP server sunmaktadır.