ballmac — MCP-сервер для Claude Code: что делает и как установить
Ищет компоненты и готовые блоки Ballmac UI для React и Tailwind. Помогает собирать экраны и получать команды установки shadcn CLI прямо в чате с моделью.
claude mcp add ballmac -- npx -y @ballmac/mcpЧто делает ballmac
Сервер открывает агенту доступ к библиотеке Ballmac UI. Модель может искать элементы интерфейса по описанию, проверять свойства, клавиатурную навигацию и зависимости. Всё работает в режиме чтения: инструмент не изменяет файлы проекта сам, возвращая только данные и команды для CLI.
Встроенные методы помогают планировать структуру страниц через compose_page, генерировать каркасы page.tsx и запускать проверку качества верстки. Для запуска сервера нужен Node.js 20 или новее. Базовый каталог доступен без ключей, а для чтения исходников Pro-компонентов потребуется передать ключ в переменной BALLMAC_LICENSE_KEY.
Какие задачи решает
- найти подходящие React-компоненты интерфейса по описанию задачи
- составить каркас страницы из готовых блоков с учётом состояний
- получить точные команды установки компонентов для shadcn CLI
- проверить проект на соблюдение правил вёрстки и доступности
Примеры запросов агенту
- Собери лендинг для SaaS с тарифами и блоком вопросов на Ballmac UI.
- Какой компонент Ballmac UI выбрать для анимированного счётчика дохода?
- Проверь проект через audit_project и покажи найденные недочёты.
Как установить ballmac
Командой платформы
claude mcp add ballmac -- npx -y @ballmac/mcpКомандой платформы
codex mcp add mcp -- npx -y @ballmac/mcpФайл настроек
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@ballmac/mcp"
]
}
}
}Файл настроек
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@ballmac/mcp"
]
}
}
}Командой платформы
gemini mcp add mcp npx -y @ballmac/mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ballmac
Как установить ballmac в Claude Code?
Выполните команду claude mcp add ballmac -- npx -y @ballmac/mcp. Для работы сервера требуется установленный Node.js 20 или более поздней версии.
Что делает MCP-сервер ballmac?
Он предоставляет агенту доступ к каталогу Ballmac UI для поиска компонентов, просмотра документации и формирования команд shadcn CLI. Сервер работает только на чтение и не меняет файлы на диске самостоятельно.
Нужен ли API-ключ для работы с каталогом?
Бесплатный каталог доступен без регистрации и ключей. Переменная окружения BALLMAC_LICENSE_KEY нужна только для просмотра исходного кода компонентов уровня Pro.
