English Français العربية

Fragrance & Perfume MCP (Noteboxd)

السجل الرسمي البحث والويب

Fragrance & perfume MCP: search fragrances, notes, accords, brands, perfumers, reviews & charts.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http fragrance-perfume-mcp-noteboxd 'https://mcp.noteboxd.com/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "fragrance-perfume-mcp-noteboxd": {
            "type": "http",
            "url": "https://mcp.noteboxd.com/mcp"
        }
    }
}
NPM package @noteboxd/mcp
Claude Code 
claude mcp add fragrance-perfume-mcp-noteboxd -e 'NOTEBOXD_API_KEY=<your noteboxd_api_key>' -- npx -y @noteboxd/mcp@0.1.4
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "fragrance-perfume-mcp-noteboxd": {
            "command": "npx",
            "args": [
                "-y",
                "@noteboxd/mcp@0.1.4"
            ],
            "env": {
                "NOTEBOXD_API_KEY": "<your noteboxd_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • NOTEBOXD_API_KEY إلزامي سري Noteboxd API key (nb_live_...). Create one free at https://developers.noteboxd.com

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Noteboxd Fragrance & Perfume MCP
  2. Quickstart
  3. Install
  4. Tools
  5. Configuration
  6. How it works
  7. Examples
  8. Pricing
  9. License

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

  1. Create an API key at developers.noteboxd.com. The free tier is 50 calls/day and needs no card.
  2. Add the server to your MCP client (see below).
  3. 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
ToolDescription
searchSearch across fragrances, brands, notes, perfumers, collections
search_fragrancesFilter fragrances by query, brand, note, family, or price range
trendingTrending searches and most-worn fragrances
list_charts, get_chartChart rankings and leaderboards
Fragrances
ToolDescription
get_fragranceFull profile: notes, accords, perfumer, community score
get_fragrance_reviewsPaginated community reviews
get_similar_fragrancesFragrances with a similar accord profile
get_wearing_statsWearing counts over recent windows
compare_fragrancesTwo fragrances compared side by side
get_review_digestShort summary of a fragrance's reviews
batch_get_fragrancesUp to 50 fragrances by id in one call
enrich_fragranceProfile plus notes, accords, reviews, and similar in one call
Brands, perfumers, notes
ToolDescription
get_brand, list_brand_fragrancesBrand profile and catalogue
get_perfumerPerfumer profile and top creations
list_notes, get_noteBrowse notes and single-note profiles
list_accordsList accord families

Configuration

VariableRequiredDescription
NOTEBOXD_API_KEYyesYour nb_live_ key from developers.noteboxd.com
NOTEBOXD_API_BASE_URLnoOverride 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

MIT

الأسئلة الشائعة

ما هو Fragrance & Perfume MCP (Noteboxd)؟

Fragrance & perfume MCP: search fragrances, notes, accords, brands, perfumers, reviews & charts.

كيف أثبّت Fragrance & Perfume MCP (Noteboxd)؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http fragrance-perfume-mcp-noteboxd 'https://mcp.noteboxd.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Fragrance & Perfume MCP (Noteboxd) إلى مفتاح API؟

نعم. يتطلب NOTEBOXD_API_KEY، وتضبطها في إعداداته.

هل Fragrance & Perfume MCP (Noteboxd) مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Fragrance & Perfume MCP (Noteboxd)؟

ينشره noteboxd. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.