developer-toolsdesign

Magic UI▌

by magicuidesign

Explore Magic UI, a React UI library offering structured component access, code suggestions, and installation guides for

Provides structured access to Magic UI's component library for generating accurate code suggestions with proper installation instructions for implementing visually appealing UI elements in web applications.

github stars

★ 176

GitHub Website npm

60+ specialized UI componentsSupports multiple IDE clientsOne-command installation setup

best for

/ Frontend developers building React applications
/ Designers implementing interactive UI components
/ Teams needing quick access to pre-built animations and effects

capabilities

/ Generate code for UI components like marquee, bento-grid, and dock
/ Get implementation details for animated buttons and text effects
/ Access device mockup components for Safari and iPhone
/ Retrieve background patterns and grid animations
/ Get special effects like animated beams and particle systems
/ Browse comprehensive component library with installation instructions

what it does

Provides code implementation details and installation instructions for Magic UI's component library through an MCP server. Access dozens of pre-built React components including animations, buttons, backgrounds, and device mockups.

about

Magic UI is an official MCP server published by magicuidesign that provides AI assistants with tools and capabilities via the Model Context Protocol. Explore Magic UI, a React UI library offering structured component access, code suggestions, and installation guides for It is categorized under developer tools, design. This server exposes 8 tools that AI clients can invoke during conversations and coding sessions.

how to install

You can install Magic UI in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport. This server supports remote connections over HTTP, so no local installation is required.

license

MIT

Magic UI is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

@magicuidesign/mcp

Official ModelContextProtocol (MCP) server for Magic UI.

Install MCP configuration

npx @magicuidesign/cli@latest install <client>

Supported Clients

cursor
windsurf
claude
cline
roo-cline

Manual Installation

Add to your IDE's MCP config:

{
  "mcpServers": {
    "magicuidesign-mcp": {
      "command": "npx",
      "args": ["-y", "@magicuidesign/mcp@latest"]
    }
  }
}

Example Usage

Once configured, you can questions like:

"Make a marquee of logos"

"Add a blur fade text animation"

"Add a grid background"

Available Tools

The server provides the following tools callable via MCP:

Tool Name	Description
`getUIComponents`	Provides a comprehensive list of all Magic UI components.
`listRegistryItems`	Lists Magic UI registry items with optional filters like `kind`, `query`, and `limit`.
`searchRegistryItems`	Searches Magic UI registry items by keyword or use case and returns ranked matches.
`getRegistryItem`	Returns details for a single registry item, including install instructions and optional source, related items, and examples.
`getLayout`	Provides implementation details for bento-grid, dock, file-tree, grid-pattern, interactive-grid-pattern, dot-pattern components.
`getMedia`	Provides implementation details for hero-video-dialog, terminal, marquee, script-copy-btn, code-comparison components.
`getMotion`	Provides implementation details for blur-fade, scroll-progress, scroll-based-velocity, orbiting-circles, animated-circular-progress-bar components.
`getTextReveal`	Provides implementation details for text-animate, line-shadow-text, aurora-text, animated-shiny-text, animated-gradient-text, text-reveal, typing-animation, box-reveal, number-ticker components.
`getTextEffects`	Provides implementation details for word-rotate, flip-text, hyper-text, morphing-text, spinning-text, sparkles-text components.
`getButtons`	Provides implementation details for rainbow-button, shimmer-button, shiny-button, interactive-hover-button, animated-subscribe-button, pulsating-button, ripple-button components.
`getEffects`	Provides implementation details for animated-beam, border-beam, shine-border, magic-card, meteors, neon-gradient-card, confetti, particles, cool-mode, scratch-to-reveal components.
`getWidgets`	Provides implementation details for animated-list, tweet-card, client-tweet-card, lens, pointer, avatar-circles, icon-cloud, globe components.
`getBackgrounds`	Provides implementation details for warp-background, flickering-grid, animated-grid-pattern, retro-grid, ripple components.
`getDevices`	Provides implementation details for safari, iphone-15-pro, android components.

MCP Limitations

Some clients have a limit on the number of tools they can call. This is why we opted to group the tools into categories. Note: For more specific context on each component, run the MCP locally and modify the logic that groups the components.

Credits

Big thanks to @beaubhp for creating the MCP server 🙏

MIT