AI 클라이언트가 디지털 에셋을 검색하고, 프로젝트에 적합한 제품을 추천하며, 소유한 파일을 다운로드하고 구매 링크를 제공할 수 있도록 합니다.
다른 이름 kadalcc/store-cli, store-cli, @kadal/store
- 스타
- 0
- Tools
- 2
- 다운로드, 30일
- 1,030
- 최신 버전
- 0.1.1
- 마지막 커밋
- 2026년 11월 14일
- 라이선스
- AGPL-3.0
Kadal Store MCP란?
Kadal Store은(는) MCP server입니다. AI 클라이언트가 디지털 에셋을 검색하고, 프로젝트에 적합한 제품을 추천하며, 소유한 파일을 다운로드하고 구매 링크를 제공할 수 있도록 합니다. 2개 도구를 제공합니다. 예: create_buy_link, whoami.
프로젝트 README에서 생성된 요약
Kadal Store MCP server 정보
Kadal Store는 AI 에이전트 또는 터미널 인터페이스를 통해 3D 모델, 사운드 효과, 셰이더와 같은 디지털 에셋을 찾을 수 있게 해줍니다. 개발자와 크리에이터는 이 도구를 사용하여 플래너, 아트, 음악, 비디오 FX 라이브러리를 검색하고, 현재 프로젝트 문맥에 맞는 맞춤형 제품 추천을 받으며, 기존 디지털 라이브러리를 관리할 수 있습니다.
사용자는 보안을 위해 브라우저에서 진행되는 로그인 프로세스를 통해 자신의 스토어 계정을 연결합니다. 이 MCP server는 원격 연결을 제공하여 Claude, ChatGPT, Cursor, VS Code와 같은 AI 클라이언트와 함께 작동합니다. 에이전트는 아이템 검색, 특정 제품 추천, 구매 링크 제공은 가능하지만 결제 기능은 제한되어 있습니다. 모든 거래는 사용자가 스토어의 체크아웃 페이지를 통해 직접 완료해야 합니다. 또한 특정 파일을 다운로드하거나 소유한 전체 컬렉션을 로컬 디렉토리로 동기화할 수도 있습니다.
활용 사례
- 1맞춤형 제품 추천 받기현재 작업의 테마나 요구 사항에 맞는 에셋 추천을 요청합니다.
- 2라이브러리 전체 동기화구매한 모든 디지털 에셋을 로컬 폴더에 미러링하여 오프라인에서 사용합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Kadal Store MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Kadal Store MCP 설치
$ claude mcp add store-cli -- npx -y @kadal/storeCursor에 Kadal Store MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"store-cli": {
"command": "npx",
"args": [
"-y",
"@kadal/store"
]
}
}
}VS Code에 Kadal Store MCP 설치
.vscode/mcp.json
{
"servers": {
"store-cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@kadal/store"
]
}
}
}VS Code CLI에 Kadal Store MCP 설치
$ code --add-mcp '{"name":"store-cli","type":"stdio","command":"npx","args":["-y","@kadal/store"]}'Claude Desktop에 Kadal Store MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"store-cli": {
"command": "npx",
"args": [
"-y",
"@kadal/store"
]
}
}
}Codex에 Kadal Store MCP 설치
$ codex mcp add store-cli -- npx -y @kadal/storeCodex config.toml에 Kadal Store MCP 설치
~/.codex/config.toml
[mcp_servers.store-cli] command = "npx" args = ["-y", "@kadal/store"]
Gemini CLI에 Kadal Store MCP 설치
$ gemini mcp add -s user store-cli npx -- -y @kadal/storeGemini settings.json에 Kadal Store MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"store-cli": {
"command": "npx",
"args": [
"-y",
"@kadal/store"
]
}
}
}Kadal Store MCP 도구 2
README에서 감지됨create_buy_linkwhoami
| create_buy_link | — | |
| whoami | — |
자동 검사
2026년 11월 13일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능kadalcc/store-cli is public and reachablegithub.com/kadalcc/store-cli ↗통과
- 패키지가 이 저장소를 소스로 명시@kadal/store names kadalcc/store-cli as sourcenpmjs.com/package/@kadal/store ↗통과
- 빌드 출처(Sigstore 증명)Sigstore attestation for @kadal/storenpmjs.com/package/@kadal/store/v/0.1.1#provenance ↗통과
- 오픈 소스 라이선스 (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-11github.com/kadalcc/store-cli ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @kadal/store통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음99 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음2 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답HTTPS endpoint answered 401 (sign-in required)통과
README
GitHub에서 보기The Kadal Store sells digital downloads: planners and printables, art
and icons, stickers, wallpapers, patterns, music, sound effects, 3D models, video FX and shaders.
You pay once and keep the files. @kadal/store brings the store to where you work. Search it, get
suggestions for the project in front of you, download and sync what you own, and get a link to buy
the rest. It works the same for you in a terminal and for the AI agent you already use, on your own
account and your own model subscription.
An agent can find things, download what you own and hand you a link. It can never pay: payment happens in Paddle's checkout, on the store's own page, in front of you.
Start in 30 seconds
You need Node 20 or newer.
npx -y @kadal/store login # once: approve on the store's own page
npx -y @kadal/store recommend "ui sounds" --from . # what fits the project you're in
npx -y @kadal/store download soft-ui-sounds -o assets/sfx # a product you own, into the project
Or install it with npm i -g @kadal/store, then run kadal-store <command>.
Rather have your agent do it? Give Claude, ChatGPT, Cursor or VS Code the address
https://store.kadal.cc/mcp. There is nothing to install: Connect your agent.
In the store
The code under each picture is the product's slug, which every command takes:
kadal-store show liquid-marble prints its files, prices and licence in the terminal. The pictures
are the store's own previews, so they change when the store does.
Sign in
$ kadal-store login
Opening your browser to sign in to store.kadal.cc. If it does not open, visit:
https://store.kadal.cc/authorize?response_type=code&client_id=…
Signed in as Ana <ana@example.com> on store.kadal.cc. Saved to /home/ana/.config/kadal/store.json
You sign in on the store's own page, so your password never passes through the CLI. The token is
saved in ~/.config/kadal/store.json ($XDG_CONFIG_HOME is respected; %APPDATA%\kadal\ on
Windows), readable only by you, and renews itself. On a machine without a browser, use
--no-open, open the address anywhere, and paste the address the browser lands on back into the
terminal. If the store's page says it does not know this app, run kadal-store login --register.
kadal-store logout signs this machine out and revokes its access; so does removing
"Kadal Store CLI" under Account → Settings → Connected apps.
Commands
Find
$ kadal-store search planner --max 10 --limit 5
72 Seasons Weekly Planner Printables $9.00 seventy-two-seasons-planner
Kakeibo Budget Planner Printables $8.00 kakeibo-budget-planner
2027 Small Business Planner Printables $8.00 small-business-planner-2027
2027 ADHD-Friendly Daily Planner Printables $8.00 adhd-friendly-planner
Christmas Planner Printables $7.00 christmas-planner
5 of 54. Details: kadal-store show <slug>
More: kadal-store search planner --cursor 5
search <words…>with--shelf <slug>,--style,--topic,--format,--kind asset|pack,--max <dollars>,--sort relevance|newest|price,--limit <1-50>(20),--cursor <next page>.shelveslists the store's shelves and how many products each holds (use a slug with--shelf).show <slug>: the price of each licence, what each licence allows and doesn't, the files with their sizes and editions, what a pack holds, and its updates.
Suggestions for your project
$ kadal-store recommend "sounds for a cosy pixel-art farming game" --limit 3
Retro 8-Bit SFX Sound FX from $9.00 retro-8bit-sfx
Matches “sound”, “pixel” and “art” in its tags.
Cute Pops & Sparkles Sound FX from $9.00 cute-pops-sparkles
Matches “sound”, “cosy” and “game” in its tags.
Holiday Creator Kit Bundles from $29.00 holiday-creator-kit (pack of 9)
Matches “sound”, “art” and “game” in its tags.
Packs that complete what you have:
Sound FX Collection Sound FX from $24.00 sfx-collection (pack of 4)
Holds 2 of the picks above. You already own 1 of its 4 items. Its 4 items cost $39 one by one; the pack is $24. (you own 1)
…
Every pick says why it was picked, and a pack says what it would save you. What you own is left out
(--include-owned keeps it). Add --from . and the store also reads a short summary of the project
you're in, which you see before it goes (what it holds). Also --shelf, --format
(both repeatable), --max <dollars>, --limit <1-20> (8), and --yes to send the summary without
asking.
What you own
$ kadal-store library
Slim Weekly Techo (standard) 42 files, 19.7 MB slim-weekly-techo
Soft UI Sounds (personal) 41 files, 1.8 MB soft-ui-sounds
Download one: kadal-store download <slug> · everything: kadal-store sync <dir>
$ kadal-store download slim-weekly-techo --year 2027 --lang en --size a6 -o planner
Downloading slim-weekly-techo into planner
✓ planner/FONT-LICENCE.txt
✓ planner/how-to-print.pdf
✓ planner/slim-weekly-techo_2027_en_a6.pdf
Done: 3 downloaded, 0 already here.
$ kadal-store sync Kadal
2 products · 83 files already in Kadal · 0 to download
Done: 0 downloaded, 83 already here.
-
download <slug>puts one product's files in./<slug>(or-o <dir>).--file <name>(repeatable) picks files. A product sold in editions takes--year 2027 --week sun|mon --lang en|ja|en-ja --size a4|a5|letter…to pick one;show <slug>lists the editions it has. Files that belong to every edition, like the read-me, always come too.--zipgets the whole product as one zip, and--forcedownloads files that are already there. -
sync [dir]mirrors everything you own intodir(default./kadal-store), one folder per product. Files already there with the same sha256 are skipped; nothing is ever deleted.--product <slug>(repeatable), the edition flags, and--dry-runto see what would come down. -
Recolourable illustrations (
show <slug>says "Recolourable") come in any colour:--color <hex>ondownloadorsync, such as--color 2f9e44, saves each SVG in that colour as<name>-2f9e44.svg, and the rest of the product as it is. Leave out the#or quote it ("#2f9e44"): a bare#starts a comment in the shell. Each recoloured file is checked against the store's sha256 for it, so the next run skips it too.sync --colorrecolours the products that can be and brings the rest as drawn; a product that can't take a colour is refused (exit 2). -
Every file is checked against the sha256 the store gives before it is kept. A download that is cut off leaves a
.kadal-partfile, and the next run picks up where it stopped. Downloads run four at a time (--concurrency <n>). -
Only what you own downloads. Anything else stops with the store's answer:
$ kadal-store download retro-8bit-sfx Downloading retro-8bit-sfx into retro-8bit-sfx error: You don't own Retro 8-Bit SFX. get_product describes it; create_buy_link makes a link to buy it.
Buy
$ kadal-store buy retro-8bit-sfx soft-ui-sounds
Review and pay here:
https://store.kadal.cc/buy?items=retro-8bit-sfx:personal,soft-ui-sounds:personal&ref=cli
Retro 8-Bit SFX personal $9.00
Soft UI Sounds personal $9.00 (you already own this)
Total $9.00
Open the link to review and pay. Nothing is charged until you pay on that page, and you can change a licence or remove anything there. Already owned, so not charged: soft-ui-sounds.
buy <slug[:tier]>… makes a page where you see each item, its licence and its price, and anything
you already own, which is left out of the total. Without a tier, an item comes with the cheapest
licence on sale for it; add one (personal, standard or commercial) to choose. --open
opens the page in your browser. Making that page is all buy does: you pay there, or not at all.
Tell us about a problem
$ kadal-store report slim-weekly-techo --kind question --file slim-weekly-techo_2027_en_a6-on-a4.pdf --page 3 "Do I print this one at 100% for an A6 binder?"
Thanks. Your note is open: https://store.kadal.cc/account/notes#note_…
Only you and Kadal can see it. Replies show up in `kadal-store notes`.
$ kadal-store notes
Slim Weekly Techo · question · slim-weekly-techo_2027_en_a6-on-a4.pdf [Waiting for Kadal to read it] note_…
Do I print this one at 100% for an A6 binder?
--kind mistake|question|idea; --page <n> for a PDF, --at <seconds> for audio or video. Use
- in place of the words to read them from stdin. notes --status open|accepted|declined|duplicate|fixed narrows the list. When a fix ships, the product's update
shows in your library and the next download or sync gets it.
Everything else
whoami, logout, --help (and <command> --help), --version.
Connect your agent
There are two servers with the same tools. The hosted one, https://store.kadal.cc/mcp, needs
nothing installed: your app signs in to the store with OAuth, and you choose what to allow. The
local one, npx -y @kadal/store mcp, uses this machine's kadal-store login and adds two tools
that work on the project folder. Both are one entry, cc.kadal/store, in the
official MCP Registry.
Claude (claude.ai and the desktop app)
Open Settings → Connectors, choose Add custom connector, paste https://store.kadal.cc/mcp
and connect. A store page opens: sign in and press Allow.
Claude Code
The plugin brings the skill and the local MCP server together. Sign in once with
npx -y @kadal/store login, then:
/plugin marketplace add kadalcc/store-cli
/plugin install kadal-store@kadal-store
Or add the hosted server alone, then run /mcp in Claude Code and pick kadal-store to sign in:
claude mcp add --transport http kadal-store https://store.kadal.cc/mcp
Or the local server alone: claude mcp add kadal-store -- npx -y @kadal/store mcp.
ChatGPT
In Settings → Apps & Connectors, turn on developer mode under Advanced, then create a
connector with the address https://store.kadal.cc/mcp and OAuth as the sign-in. ChatGPT opens the
store's sign-in the first time you use it.
Cursor
Add it to ~/.cursor/mcp.json:
{ "mcpServers": { "kadal-store": { "url": "https://store.kadal.cc/mcp" } } }
VS Code
Add it to .vscode/mcp.json, then start it from the file:
{ "servers": { "kadal-store": { "type": "http", "url": "https://store.kadal.cc/mcp" } } }
Codex, and apps that only run local servers
Sign in once with npx -y @kadal/store login, then point the app at the local server. In Codex,
that is ~/.codex/config.toml:
[mcp_servers.kadal-store]
command = "npx"
args = ["-y", "@kadal/store", "mcp"]
Claude Desktop, Cursor and other apps take the same local server as JSON:
{ "mcpServers": { "kadal-store": { "command": "npx", "args": ["-y", "@kadal/store", "mcp"] } } }
The skill
For any agent that reads Agent Skills: npx skills add kadalcc/store-cli
(skills/kadal-store).
It teaches the agent to find assets for the project in front of it, download into it, never buy on
its own, and report problems it finds in files you bought.
The tools
| MCP tools | |
|---|---|
search_products, get_product, list_shelves, recommend |
the catalogue, the licence of each product, suggestions from a description of the work |
list_library, get_download_links |
what you own, and ten-minute download links with each file's sha256 (a recolourable illustration's SVGs in the color you give) |
create_buy_link |
a review page for you to pay on; it charges nothing |
report_problem, list_my_notes |
a note about a file you own, and Kadal's replies |
whoami |
who is signed in, with which scopes |
project_summary (local) |
what recommend --from sends: the folder described without its contents |
download_to_folder (local) |
files you own into the project, checked by sha256, skipping what is there, in a color for recolourable illustrations; only inside the folder the server started in unless it was started with --allow-outside |
kadal-store mcp --dir <path> serves another folder as the project. Every tool needs the
store:read scope except report_problem, which needs store:write. The store's
server card lists every tool without
signing in.
Your agent never pays
- No tool can pay.
create_buy_link, likekadal-store buy, returns the address of a review page on store.kadal.cc. You pay there, in Paddle's checkout, in your own browser, signed in to the store. Nothing is charged until you do, and you can change a licence or remove anything first. - Downloads are only for what you own. Download links are made for the signed-in person, for
the files their licence covers, and last ten minutes. Anything else gets "You don't own …" and a
pointer to
create_buy_link. - You choose what it may do. Reporting a problem needs
store:write; everything else isstore:read. Remove an app under Account → Settings → Connected apps and its access ends. - The skill says so too. It tells the agent never to buy, never to say something was bought, never to open a checkout for you, and to ask you to sign in yourself.
Privacy
recommend --from <dir> and the local server's project_summary describe a project without its
contents. They read:
- from
package.json,pyproject.toml,Cargo.tomlorgo.mod: the name, description, keywords and the names of dependencies (never versions, scripts or anything else); - the README's headings, not its paragraphs;
- file names, to count file types and spot tools (a
project.godot,.blendfiles), and the top-level names.
Dependency, build and hidden folders (node_modules, .git, dist, any dot folder…) are not
read, symlinks are not followed, and the text is capped at 6,000 characters. You see exactly what
will be sent, and nothing goes until you say yes:
$ kadal-store recommend "ui sounds" --from .
This summary of /home/ana/cosy-farm will be sent to store.kadal.cc:
Project: cosy-farm — A cosy farming game
Built with: Phaser, Vite
Dependencies: phaser, vite
README sections: Cosy Farm · Art style · Controls
File types: .png 8, .ts 5, .html 1, .json 1, .md 1
Top level: assets/, src/, index.html, package.json, README.md
Send it? [y/N]
The folder's path is shown to you and not sent. With no terminal to ask in, nothing is sent unless
you pass --yes.
On the store's side, the words sent to recommend are used for that one answer and not kept. Each
connection records the app's name, what you allowed and when, and downloads are logged as they are
from your library. More in the store's privacy policy. On your
machine, the CLI keeps only its sign-in, as Sign in describes.
Kadal Store MCP 질문
Kadal Store MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add store-cli -- npx -y @kadal/store를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Kadal Store MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Kadal Store MCP는 어떤 도구를 제공하나요?
2개 도구를 제공합니다. 예: create_buy_link, whoami.
AI 에이전트가 직접 구매를 할 수 있나요?
아니요, 에이전트는 아이템을 찾고 링크를 제공하는 역할만 수행합니다. 결제는 사용자가 스토어의 체크아웃 페이지를 통해 직접 진행해야 합니다.
로그인 프로세스는 어떻게 작동하나요?
브라우저를 통해 스토어 자체 페이지에서 로그인하므로, 비밀번호가 CLI를 통해 전달될 염려가 없어 안전합니다.