用途：在 React/Next.js 项目中添加、定制或排查 Magic UI 组件，也用于把静态区块改造成带动效的交互式 UI。
主要能力：覆盖组件选择、shadcn registry 安装、区块级实现模式与故障排查。常见组件包括 marquee、globe、blur-fade、shiny-button、magic-card 等；可用于 hero、testimonials、CTA、feature grid 等区块。
使用方式：项目需为 React/Next.js 并配置 Tailwind CSS，且先初始化 shadcn：
npx shadcn@latest init
再安装组件：
npx shadcn@latest add @magicui/<component-slug>
例如：
npx shadcn@latest add @magicui/magic-card
随后从生成路径（通常为 @/components/ui/<component-slug>）导入，保持组件 API 不变，优先通过 props/className 定制；如文档要求额外依赖或 CSS keyframes，需在集成时补充。
适用场景：社交证明/logo 栏、hero 视觉、文字动画、CTA 强调、氛围背景等。建议从 1 个核心组件加 1 个辅助效果起步。
限制与排查：动效需克制，避免同一视口堆叠过多高动效；需检查无障碍、响应式与性能。若出现 components.json 或 registry 初始化错误，在项目根目录运行 npx shadcn@latest init；导入路径不匹配时改用项目别名或相对导入；视觉不一致时检查全局 CSS/keyframes；缺包时按组件手动安装步骤补齐依赖。
参考链接：Magic UI 文档 https://magicui.design/docs ，组件文档 https://magicui.design/docs/components ，安装说明 https://magicui.design/docs/installation ，MCP 配置（可选）https://magicui.design/docs/mcp 。