Noteboxd MCPサーバー
✓ 検証済みConnects AI clients to a fragrance encyclopedia to search for perfumes, notes, brands, perfumers, and community reviews.
別名 noteboxd/mcp, mcp, @noteboxd/mcp
- スター
- 1
- ツール
- 13
- ダウンロード数(30日間)
- —
- 最新バージョン
- 0.1.4
- 最終コミット
- 2026年7月31日
- ライセンス
- MIT
Noteboxd MCPとは
Connects AI clients to a fragrance encyclopedia to search for perfumes, notes, brands, perfumers, and community reviews. 13個のツールを提供しており、search, search_fragrances, trendingなどがあります。
プロジェクトのREADMEから生成された概要
Noteboxd MCP server について
Accessing a detailed fragrance encyclopedia from within AI clients like Claude, ChatGPT, or Cursor allows users to move beyond AI guesswork when discussing scents. This server connects your assistant to the Noteboxd database, providing factual information about perfumes, brands, perfumers, and specific scent notes. It is designed for fragrance enthusiasts and developers who want to integrate community reviews and scent profiles directly into their conversational workflows.
You can run this server locally using npx or connect via a hosted HTTP option. To use the local version, you must provide a NOTEBOXD_API_KEY. The free tier allows for 50 calls per day without requiring a credit card. The server provides a wide range of read-only tools, including search_fragrances for filtering by price or family, compare_fragrances for side-by-side analysis, and get_review_digest to quickly understand community sentiment. It also offers specialized functions like get_similar_fragrances and get_wearing_stats to help discover new scents based on existing collections.
できること
- 1Discovering new scent recommendationsAsk your AI to suggest new perfumes based on the specific scents you already own.
- 2Comparing different perfume profilesRequest a side-by-side comparison of two specific fragrances to see how they differ.
- 3Analyzing community sentimentGet a summary of what actual users are saying about a particular fragrance.
- 4Exploring fragrance ingredientsSearch for specific notes or accords to understand the composition of a perfume.
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Noteboxd MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにNoteboxd MCPをインストール
$ claude mcp add --env 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' mcp -- npx -y @noteboxd/mcpCursorにNoteboxd MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}VS CodeにNoteboxd MCPをインストール
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}VS Code CLIにNoteboxd MCPをインストール
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@noteboxd/mcp"],"env":{"NOTEBOXD_API_KEY":"<YOUR_NOTEBOXD_API_KEY>"}}'Claude DesktopにNoteboxd MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}CodexにNoteboxd MCPをインストール
$ codex mcp add mcp --env 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' -- npx -y @noteboxd/mcpCodex config.tomlにNoteboxd MCPをインストール
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@noteboxd/mcp"] [mcp_servers.mcp.env] NOTEBOXD_API_KEY = "<YOUR_NOTEBOXD_API_KEY>"
Gemini CLIにNoteboxd MCPをインストール
$ gemini mcp add -s user -e 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' mcp npx -- -y @noteboxd/mcpGemini settings.jsonにNoteboxd MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@noteboxd/mcp"
],
"env": {
"NOTEBOXD_API_KEY": "<YOUR_NOTEBOXD_API_KEY>"
}
}
}
}Noteboxd MCPツール 13
READMEから検出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個のツールをすべて表示ツールを折りたたむ
list_accords
| list_accords | — |
設定
NOTEBOXD_API_KEY必須シークレットNoteboxd API key (nb_live_...). Create one free at https://developers.noteboxd.com
| 名前 | 説明 | 種類 |
|---|---|---|
| NOTEBOXD_API_KEY | Noteboxd API key (nb_live_...). Create one free at https://developers.noteboxd.com | 必須シークレット |
自動チェック
実行日 2026年11月14日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能noteboxd/mcp is public and reachablegithub.com/noteboxd/mcp ↗合格
- パッケージがこのリポジトリをソースとして指定@noteboxd/mcp names noteboxd/mcp as sourcenpmjs.com/package/@noteboxd/mcp ↗合格
- ビルドの来歴 (Sigstore 証明)No build attestation published for this release未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-07-31github.com/noteboxd/mcp ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していないNo popular package one edit away from @noteboxd/mcp合格
- パッケージおよびその依存関係に重大な勧告なし99 resolved dependencies checked; no critical advisoryosv.dev ↗合格
- モデルへの隠れた指示がない13 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされているNo tool named like delete, drop or exec合格
- リモートエンドポイントが MCP ハンドシェイクに応答initialize answered with protocol 2025-06-18 in 781 ms合格
README
GitHubで見る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のよくある質問
Noteboxd MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --env 'NOTEBOXD_API_KEY=<YOUR_NOTEBOXD_API_KEY>' mcp -- npx -y @noteboxd/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Noteboxd MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
Noteboxd MCPが提供するツールは
13個のツールを提供しており、search, search_fragrances, trending, get_fragrance, get_fragrance_reviewsなどがあります。
How much does it cost to use the Noteboxd MCP?
The server is free and open source, but API usage depends on your Noteboxd developer plan, which includes a free tier of 50 calls per day.
Can I use the server without running it locally?
Yes, Noteboxd offers a hosted MCP server at mcp.noteboxd.com that uses OAuth sign-in.