HeroUI MCP Monorepo
Model Context Protocol (MCP) servers for the HeroUI design system. Access HeroUI component documentation directly in your AI assistant.
Усильте агента
Собственная команда издателя. Не эндпоинт PlugMCP.
Host a copy with our keys and logs.
npx -y @heroui/[email protected]У Claude Code нет ссылки для установки локальной команды. Скопируйте команду ниже и выполните её в терминале.
claude mcp add heroui-react-mcp -- npx -y @heroui/react-mcp@1.1.4Выполните в терминале.
{ "mcpServers": { "heroui-react-mcp": { "command": "npx", "args": [ "-y", "@heroui/[email protected]" ] } }}claude_desktop_config.json
Удалённый URL или команда на вашем компьютере? Чем различаются два способа установки
Запустить на 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.
ЗапускОт издателя
Model Context Protocol (MCP) servers for the HeroUI design system. Access HeroUI component documentation directly in your AI assistant.
MCP server for HeroUI component documentation via Model Context Protocol
| MCP | Description | Docs |
|---|
@heroui/react-mcp | MCP server for web (@heroui/react) component docs, examples, and theme data | README |
@heroui/native-mcp | MCP server for React Native (heroui-native) component docs, examples, and theme data | README |
@heroui/migration-mcp | Remote MCP server for migrating from HeroUI v2 to v3 | README |
The React and Native stdio servers require Node.js 22.22.0 or later.
Choose your package based on your platform:
For Web (React/Next.js):
# Cursor, Claude Code, Windsurf, etc.
npx -y @heroui/react-mcp@latest
For React Native:
npx -y @heroui/native-mcp@latest
See package-specific READMEs for detailed installation instructions for your IDE.
# Clone and install
git clone https://github.com/heroui-inc/heroui-mcp.git
cd heroui-mcp
pnpm install
# Set up each app's environment variables (required for data extraction)
cp apps/react-mcp/.env.example apps/react-mcp/.env
cp apps/native-mcp/.env.example apps/native-mcp/.env
# Edit each app's .env with your Cloudflare R2 and GitHub credentials
# Use R2_BUCKET_NAME=heroui-mcp-data-dev to match the development API bindings
Build Commands:
pnpm build # Build all packages
pnpm build:react # Build React MCP only
pnpm build:native # Build Native MCP only
pnpm build:migration # Type-check Migration MCP (no bundle output)
Development Servers:
pnpm dev # Start all dev servers (excludes mastra)
pnpm dev:react # React MCP API server (http://localhost:8787)
pnpm dev:native # Native MCP API server (http://localhost:8788)
pnpm dev:migration # Migration MCP HTTP server (http://localhost:8790)
pnpm dev:mastra # Mastra playground server (http://localhost:4111)
Testing & Inspection:
pnpm inspect:react # Launch MCP Inspector for React
pnpm inspect:native # Launch MCP Inspector for Native
pnpm inspect:migration # Inspect the running local Migration MCP server
pnpm lint # Run linting
pnpm typecheck # Run type checking
pnpm test # Run tests
Data Extraction:
pnpm extract:react # Extract React component data
pnpm extract:native # Extract Native component data
Code Quality:
pnpm format # Format code with Prettier
pnpm clean # Clean build artifacts
pnpm release:check # Pre-release validation
See CONTRIBUTING.md for detailed development setup and architecture information.
We welcome contributions! Please see CONTRIBUTING.md for development setup, architecture details, and contribution guidelines.
Please adhere to our Code of Conduct in all interactions.
MCP server for HeroUI component documentation via Model Context Protocol
{ "mcpServers": { "heroui-react-mcp": { "command": "npx", "args": [ "-y", "@heroui/[email protected]" ] } }}Инструменты
Списка инструментов пока нет. У удалённых серверов он появляется после первой проверки состояния.
FAQ
Скопируйте на этой странице конфигурацию stdio для Cursor, Claude Desktop, Claude Code или VS Code. Она использует установку издателя, а не прокси PlugMCP.
В этой записи не указано обязательных переменных окружения.
@heroui/react работает локально через stdio.
Последняя проверка: 2026-11-14. MCP server for HeroUI component documentation via Model Context Protocol