Noteboxd MCP server
✓ 인증됨AI 클라이언트를 향수 백과사전과 연결하여 향수, 노트, 브랜드, 조향사 및 커뮤니티 리뷰를 검색합니다.
다른 이름 noteboxd/mcp, mcp, @noteboxd/mcp
- 스타
- 1
- Tools
- 13
- 다운로드, 30일
- —
- 최신 버전
- 0.1.4
- 마지막 커밋
- 2026년 7월 31일
- 라이선스
- MIT
Noteboxd MCP란?
Noteboxd은(는) MCP server입니다. AI 클라이언트를 향수 백과사전과 연결하여 향수, 노트, 브랜드, 조향사 및 커뮤니티 리뷰를 검색합니다. 13개 도구를 제공합니다. 예: search, search_fragrances, trending.
프로젝트 README에서 생성된 요약
Noteboxd MCP server 정보
Claude, ChatGPT 또는 Cursor와 같은 AI 클라이언트 내에서 상세한 향수 백과사전에 접근하면, 향기에 대해 논의할 때 AI의 추측에 의존하지 않고 정확한 정보를 확인할 수 있습니다. 이 서버는 어시스턴트를 Noteboxd 데이터베이스에 연결하여 향수, 브랜드, 조향사 및 특정 향 노트에 대한 사실적인 정보를 제공합니다. 커뮤니티 리뷰와 향기 프로필을 대화형 워크플로우에 직접 통합하려는 향수 애호가와 개발자를 위해 설계되었습니다.
npx를 사용하여 이 서버를 로컬에서 실행하거나 호스팅된 HTTP 옵션을 통해 연결할 수 있습니다. 로컬 버전을 사용하려면 NOTEBOXD_API_KEY를 제공해야 합니다. 무료 티어는 신용카드 등록 없이 하루 50회 호출을 허용합니다. 서버는 가격이나 계열별 필터링을 위한 search_fragrances, 병렬 분석을 위한 compare_fragrances, 커뮤니티 여론을 빠르게 파악하기 위한 get_review_digest를 포함하여 다양한 읽기 전용 도구를 제공합니다. 또한 기존 컬렉션을 기반으로 새로운 향을 발견할 수 있도록 돕는 get_similar_fragrances 및 get_wearing_stats와 같은 특화된 기능도 제공합니다.
활용 사례
- 1새로운 향 추천 받기현재 보유 중인 특정 향기를 바탕으로 AI에게 새로운 향수를 추천해 달라고 요청합니다.
- 2서로 다른 향수 프로필 비교두 가지 특정 향수의 차이점을 확인하기 위해 병렬 비교를 요청합니다.
- 3커뮤니티 여론 분석특정 향수에 대해 실제 사용자들이 어떻게 말하고 있는지 요약 정보를 얻습니다.
- 4향수 성분 탐색특정 노트나 어코드(accord)를 검색하여 향수의 구성을 이해합니다.
프로젝트의 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를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Noteboxd MCP는 어떤 도구를 제공하나요?
13개 도구를 제공합니다. 예: search, search_fragrances, trending, get_fragrance, get_fragrance_reviews.
Noteboxd MCP 사용 비용은 얼마인가요?
서버는 무료 오픈 소스이지만, API 사용량은 Noteboxd 개발자 플랜에 따라 다릅니다. 하루 50회 호출까지 가능한 무료 티어가 포함되어 있습니다.
서버를 로컬에서 실행하지 않고 사용할 수 있나요?
네, Noteboxd는 OAuth 로그인을 사용하는 mcp.noteboxd.com의 호스팅된 MCP 서버를 제공합니다.