mcpField
@
@magicuidesign/mcp

@magicuidesign/mcp

本地服务
magicui.design开发工具21329 周前更新

关于 @magicuidesign/mcp

@magicuidesign/mcp 是 Magic UI 的官方 MCP 服务,可在 AI 编辑器中搜索并安装 Magic UI 组件。适合在 Cursor、Windsurf、Claude 等客户端中构建界面的前端开发者。服务直接读取 Magic UI 的实时注册表。

主要功能

  1. 01搜索 Magic UI 注册表条目
  2. 02按类型与关键词筛选组件
  3. 03获取单个条目的安装说明与示例
  4. 04通过 CLI 自动写入客户端 MCP 配置

适用场景

  1. 01在编辑器中按描述查找动效文字或背景组件
  2. 02获取组件的安装步骤与源码示例
  3. 03让 AI 助手根据需求添加 Magic UI 组件

MCP 相关

该项目是一个 MCP 服务,向客户端暴露 listRegistryItems、searchRegistryItems、getRegistryItem 三个工具,用于浏览和查询 Magic UI 注册表。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"magicuidesign": {
"command": "npx",
"args": [
"-y",
"@magicuidesign/cli"
]
}
}
}
启动命令npx -y @magicuidesign/cli

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npm@magicuidesign/cli

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

详细介绍

@magicuidesign/mcp

npm version

适用于 Magic UI 的官方 ModelContextProtocol(MCP)服务。

MCP

安装 MCP 配置

npx @magicuidesign/cli@latest install <client>
支持的客户端
  • cursor
  • windsurf
  • claude
  • cline
  • roo-cline

手动安装

添加到 IDE 的 MCP 配置中:

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

使用示例

配置完成后,你可以提出以下请求:

“制作一个 Logo 滚动展示效果”

“添加文字模糊淡出动画”

“添加网格背景”

可用工具

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

工具名称描述
listRegistryItems列出 Magic UI 注册表项目,支持使用 kind、query、limit 和 offset 等筛选条件。建议用于浏览注册表。
searchRegistryItems按关键字搜索 Magic UI 注册表项目,搜索范围涵盖名称、标题、描述和注册表类型,并支持分页。
getRegistryItem返回单个注册表项目的详细信息,包括安装说明,以及可选的源代码、相关项目和示例。

MCP 限制

某些客户端对可调用的工具数量设有限制。此服务提供精简通用的工具集,直接读取实时的 Magic UI 注册表,而不依赖硬编码的类别分组。目前,widgets、media 或 devices 等广泛的语义发现概念尚未在 MCP API 中建模为一等类别。

致谢

特别感谢 @beaubhp 创建此 MCP 服务 🙏

MIT

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。