关于 @magicuidesign/mcp
@magicuidesign/mcp 是 Magic UI 的官方 MCP 服务,可在 AI 编辑器中搜索并安装 Magic UI 组件。适合在 Cursor、Windsurf、Claude 等客户端中构建界面的前端开发者。服务直接读取 Magic UI 的实时注册表。
主要功能
- 01搜索 Magic UI 注册表条目
- 02按类型与关键词筛选组件
- 03获取单个条目的安装说明与示例
- 04通过 CLI 自动写入客户端 MCP 配置
适用场景
- 01在编辑器中按描述查找动效文字或背景组件
- 02获取组件的安装步骤与源码示例
- 03让 AI 助手根据需求添加 Magic UI 组件
MCP 相关
该项目是一个 MCP 服务,向客户端暴露 listRegistryItems、searchRegistryItems、getRegistryItem 三个工具,用于浏览和查询 Magic UI 注册表。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
还没有获取到工具列表
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
@magicuidesign/mcp
适用于 Magic UI 的官方 ModelContextProtocol(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 服务 🙏
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。