接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
npx -y @ballmac/[email protected]Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
claude mcp add ballmac-mcp -- npx -y @ballmac/mcp@1.4.0在終端機中執行。
{ "mcpServers": { "ballmac-mcp": { "command": "npx", "args": [ "-y", "@ballmac/[email protected]" ] } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
Accessible React + Tailwind v4 components, blocks and templates in one design language. You add what you need with the shadcn CLI and the source lands in your project, ready to read and change. Your AI coding agent can search and install them too, through MCP. Now listed in the official shadcn registry directory.
Site and docs: ui.ballmac.com
state prop. Platform feels make every component handle like macOS, iOS or Windows, with window chrome for Tauri and Electron apps.AUTHORING.md.llms.txt, a JSON API and the @ballmac/mcp server.components/ballmac/, so it never overwrites your shadcn/ui files.You need a project with React 19, Tailwind CSS v4 and shadcn set up (npx shadcn@latest init; it creates components.json). Both the Base UI and
Radix styles work: components built on Radix UI also come in a Base UI version (guide).
# add components by name; npm dependencies are installed for you
npx shadcn@latest add @ballmac/button @ballmac/dock
import { Button } from "@/components/ballmac/button"
@ballmac is in the official shadcn registry directory, so there is no registry to configure. On an older CLI, or to pin the address, run npx shadcn@latest registry add "@ballmac=https://ui.ballmac.com/r/{name}.json" once, or install by URL: npx shadcn@latest add https://ui.ballmac.com/r/button.json. Browse and preview everything at
ui.ballmac.com/components, and see the installation guide for
the optional Ballmac theme.
claude mcp add ballmac -- npx -y @ballmac/mcp
Or install the skill, which teaches the agent the method (find, install, build to the rules, check) and reads your project first:
npx skills add vamsiy78/ballmac-ui
The server is read-only and needs no account. It searches the catalog, returns props, keyboard behaviour and source, gives the exact install
command, and can plan a whole page from blocks. Setup for Cursor, VS Code, Windsurf, Codex and Claude Desktop is in the
MCP docs and in packages/mcp. The official shadcn MCP server also works with this registry.
Pro is commercial and licensed separately: its source is not in this repository. Details and pricing at ui.ballmac.com/pricing, setup at ui.ballmac.com/docs/guides/pro.
Needs Node.js 22 (what CI runs) and pnpm 10 (the repo pins it; corepack enable installs the right version, or use npx pnpm@10). The Pro registry is
optional: without it the site builds with the free items only.
pnpm install
pnpm build:registry # validate metadata, generate registry.json, run `shadcn build`, write site data
pnpm dev # website on http://localhost:3000
A11Y_BASE_URL points the accessibility scan at a site that is already running.
registry/ballmac/components/ (import cn from @/lib/utils, other items from @/components/ballmac/...).<name>.meta.ts next to it with defineItem({...}): description, category, dependencies, examples, notes for AI agents, and source if any
code came from elsewhere.registry/examples/.pnpm build:registry && pnpm check && pnpm smoke && pnpm a11y <name>.AUTHORING.md is the full standard.
CONTRIBUTING.md and the code of conduct.SECURITY.md.CHANGELOG.md and ui.ballmac.com/changelog.Free components, blocks, templates and the MCP server are MIT licensed (see LICENSE). THIRD_PARTY_NOTICES.md
credits the open-source work they build on. Ballmac UI Pro is licensed separately.
MCP server for Ballmac UI: search, inspect and install Ballmac UI components, blocks and templates, and compose pages from them.
{ "mcpServers": { "ballmac-mcp": { "command": "npx", "args": [ "-y", "@ballmac/[email protected]" ] } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
@ballmac/mcp 透過 stdio 在本機執行。
上次檢查時間:2026-11-09。 MCP server for Ballmac UI: search, inspect and install Ballmac UI components, blocks and templates, and compose pages from them.