convez.ai
MCP ServerDesenvolvimento WebIntermediário
heroui-inc

HeroUI MCP

heroui-inc/heroui-mcp

Documentação completa do HeroUI acessível via Model Context Protocol

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP que expõe documentação completa do sistema de design HeroUI (componentes React e React Native) diretamente em assistentes de IA. Fornece acesso a props, tipos, exemplos de uso, tokens de tema e código-fonte dos componentes.

Instalação

$npx convez-ai heroui-inc/heroui-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
64
Forks
4
Acompanhando
1
Saúde
75%
Último commit
há 1 semana
Versão
react-mcp-v1.1.4
Issues abertas
1
Contribuidores
3

Casos de uso

  • Desenvolvimento de interfaces com componentes HeroUI em assistentes de IA
  • Consulta rápida de props e APIs de componentes durante codificação
  • Exploração de exemplos de uso e boas práticas de design

Veredito

MCP especializado e bem estruturado para quem trabalha com HeroUI em contextos de IA assistida. Inclui suporte tanto para web (React) quanto mobile (React Native), com dados sempre sincronizados e infraestrutura pronta para produção.

README

A tradução para o português deste README ainda está na fila.

HeroUI MCP Monorepo

Model Context Protocol (MCP) servers for the HeroUI design system. Access HeroUI component documentation directly in your AI assistant.

MCPs

MCPDescriptionDocs
@heroui/react-mcpMCP server for web (@heroui/react) component docs, examples, and theme dataREADME
@heroui/native-mcpMCP server for React Native (@heroui/native) component docs, examples, and theme dataREADME

Quick Start

Installation

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.

What's Included

  • 🔍 Component Discovery - Search and browse all HeroUI components
  • 📚 Complete Documentation - Props, types, and usage examples
  • 🎨 Theme Information - Access theme variables and design tokens
  • 💻 Source Code - View component implementation and styles
  • 🔄 Always Up-to-Date - Latest component data fetched automatically

Local Development

# Clone and install
git clone https://github.com/heroui-inc/heroui-mcp.git
cd heroui-mcp
pnpm install

# Set up environment variables (required for data extraction)
cp .env.example .env
# Edit .env with your Cloudflare R2 and GitHub credentials

Available Scripts

Build Commands:

pnpm build                    # Build all packages
pnpm build:react              # Build React MCP only
pnpm build:native             # Build Native MCP only

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: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 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.

Contributing

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.

Support

License

MIT

Ver o original no GitHub

Bom para

Relacionados