@magicuidesign/mcp

Official ModelContextProtocol (MCP) server for Magic UI.

<div align="center"> <img src="https://github.com/magicuidesign/mcp/blob/main/public/mcp.png" alt="MCP" /> </div>

Install MCP configuration

npx @magicuidesign/cli@latest install <client>

Supported Clients

• [x] cursor
• [x] windsurf
• [x] claude
• [x] cline
• [x] 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 | |-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | listRegistryItems | Lists Magic UI registry items with optional filters like kind, query, limit, and offset. Recommended for registry browsing. | | searchRegistryItems | Searches Magic UI registry items by keyword across names, titles, descriptions, and registry types, with pagination support. | | getRegistryItem | Returns details for a single registry item, including install instructions and optional source, related items, and examples. |

MCP Limitations

Some clients have a limit on the number of tools they can call. The server keeps a small generic tool surface and reads directly from the live Magic UI registry, rather than relying on hardcoded category buckets. Broad semantic discovery concepts such as widgets, media, or devices are not currently modeled as first-class categories in the MCP API.

Credits

Big thanks to @beaubhp for creating the MCP server 🙏

MIT