About React
React is an MCP server published by heroui-inc in the Developer Tools category: ⚙️ MCP servers for HeroUI React v3 and HeroUI Native.
The repository has 61 stars and 4 forks, with the last commit 29 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/heroui-inc/heroui-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about React
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 7 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
1 check has not been run yet.
Releases
README
HeroUI MCP Monorepo
Model Context Protocol (MCP) servers for the HeroUI design system. Access HeroUI component documentation directly in your AI assistant.
MCPs
| 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 |
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
README fetched from the repository 7 days ago. The original is authoritative.