Potencialize seu agente
O comando do próprio publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
npx -y @ballmac/[email protected]O Claude Code não tem link de instalação para um comando local. Copie o comando abaixo e execute-o em um terminal.
claude mcp add ballmac-mcp -- npx -y @ballmac/mcp@1.4.0Execute em um terminal.
{ "mcpServers": { "ballmac-mcp": { "command": "npx", "args": [ "-y", "@ballmac/[email protected]" ] } }}claude_desktop_config.json
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirAccessible 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]" ] } }}Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Este registro não lista nenhuma variável de ambiente obrigatória.
@ballmac/mcp roda localmente via stdio.
Última verificação: 2026-11-09. MCP server for Ballmac UI: search, inspect and install Ballmac UI components, blocks and templates, and compose pages from them.