用途：根据自然语言描述在 21st.dev 的开发者注册表中查找生产级 React 组件，返回按相关度排序的结果，包含代码、预览图或视频、作者、浏览量及安装命令。
主要能力：查询解析与项目上下文检测；检索并列出候选组件；展示名称、描述、匹配度、热度、框架兼容性与预览；给出安装命令；交付所选组件的完整源码、依赖、对等依赖与可定制点。支持按 React、Tailwind、shadcn 等过滤，并依据 components.json 的风格字段（如 radix-luma）优先匹配视觉语言。
必要用法：优先通过 21st.dev Magic MCP 使用。先浏览，使用 search_picker（参数 query、type="component"、limit=8）渲染内联选择器让用户挑选，不要替用户预先筛成一个结果；用户选定后再调用 get_component(id=...) 获取组件。若用户只需确认是否存在或要安装命令，第一步即可停止。search 返回的 installCommand 含 ?api_key=$API_KEY_21ST，与 MCP 的 TWENTY_FIRST_API_KEY 不同，若 npx shadcn add 认证失败通常是缺该环境变量。get_component 是唯一计量工具，其余检索与元数据工具在所有层级均不计费；应调用 get_usage 查询层级与 freeRetrievalsRemaining，免费层级为每日 2 次。MCP 不可用时的回退方式为 WebSearch("site:21st.dev {QUERY} React component") 或 WebFetch("https://21st.dev", "Search for: {QUERY}")，但抓取不返回 id、安装命令和结构化元数据。注册表无匹配时可用 v0.app MCP 生成，但那是生成路径，无浏览量与星标。
适用场景：为 React 与 Tailwind 项目找现成组件，尤其是 shadcn/ui 风格体系；需要先看预览再人工挑选时。
限制：21st.dev 仅支持 React，不支持 Vue 或 Svelte；非 Tailwind 或 CSS Modules 项目结果较少；Next.js App Router 下需检查 “use client”；免费层级对 get_component 有每日额度，不应投机或循环调用；文档未提供的收费价格、具体平台支持细节等暂未提供。