MM

magicuidesign/mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

213 stars 37 forks 质量 71 趋势 18MIT

Magic UI组件,可从你的AI编辑器中搜索和安装。

概览

Magic UI 的官方 ModelContextProtocol(MCP)服务器。 - [X] 光标 - [X] 风帆冲浪 - [X] 克劳德 - [X] 克莱恩 - [X] 轮滑 配置好后,你可以问如下问题: 服务器提供以下可通过MCP调用的工具: 部分客户端对可调用的工具数量有限制。服务器保留一个小型通用工具表,直接读取实时的Magic UI注册表,而非依赖硬编码的类别桶。诸如控件、媒体或设备等广泛的语义发现概念目前在MCP API中并未被建模为一流类别。 非常感谢@beaubhp创建了MCP服务器 🙏

概述(AI 翻译)

Magic UI 的官方 ModelContextProtocol(MCP)服务器。

安装MCP配置

支持的客户端

  • [x] 光标
  • [X] 风帆冲浪
  • [x] 克洛德
  • [x] 克莱恩
  • [x] 轮直线

手动安装

添加到你的IDE的MCP配置中:

示例用法

配置好后,你可以问如下问题:

“制作标志帐篷”

“添加模糊淡入的文本动画”

“添加网格背景”

可用工具

服务器提供以下可通过MCP调用的工具:

工具名称 说明
listRegistryItems 列出Magic UI注册表项,并可选择如kind、query、limit和offset。推荐用于注册表浏览。

本页由 AI 翻译,技术细节请以原文为准。

README

@magicuidesign/mcp

Official ModelContextProtocol (MCP) server for Magic UI.

Install MCP configuration

npx @magicuidesign/cli@latest install 

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

在 GitHub 查看完整 README

安装

npx -y @magicuidesign/mcp@latest
新手?先看 mcpskill.org 教程 →

配置

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