search-registry-items

搜索注册表条目

通过对条目的 name 和 description 进行全文搜索，查找已索引的 shadcn 注册表目录条目。返回注册表命名空间和用于 npx shadcn@latest add 的 addCommandArgument。

默认工具调用：

CallMcpTool({ "server": "user-shoogle", "toolName": "search_registry_items", "arguments": { "query": "button" } })

工作流

进度：

• 对 user-shoogle 调用 search_registry_items，使用简短关键词或名称片段（而非完整句子）
• 按照下方的输出表格展示匹配项 — 切勿直接输出原始 JSON
• 如果多个注册表有同名条目，询问用户要使用哪个注册表
• 使用 npx shadcn@latest add {addCommandArgument}（或项目的包运行器）安装
• 仅在需要时翻页（offset += limit，直到 pagination.hasMore）

如果用户已提供确切的添加目标（例如 @cult-ui/gradient-button），则跳过搜索 — 直接进行 view / add。

搜索后的安装和组合规则请参阅 shadcn skill。

注意事项

• 仅有一个 MCP 工具。 user-shoogle 提供 search_registry_items。块搜索和语义 MCP 工具（search、search_vectors）不可用 — 请改用 shoogle.dev/search。此工作流中不要使用 npx shadcn@latest search。
• 对 name 和 description 进行全文搜索。 匹配会同时搜索这两个字段 — 不搜索条目标题，也不进行语义／向量搜索。例如，查询 carousel 可以匹配名称为 carousel 或描述中提到 carousel 的条目。
• 使用关键词，而非意图。 像“带深色模式的登录页面”这样的多概念自然语言查询效果不佳。要进行语义化区块发现，请引导用户前往 shoogle.dev/search。
• 查询条目名称，而非注册表前缀。 使用 button，而不是 @acme/button。通过结果中的 registry 筛选。
• 短片段优于句子。 优先使用 button、hero、data-table。空查询或仅含空白字符的查询不会返回结果。
• 没有结果？ 尝试更短的片段或同义词（dialog 与 modal）。
• addCommandArgument 是安装目标。 请原样使用：npx shadcn@latest add cult-ui/gradient-button。不要根据 @registry/name 重新拼接。
• 分页上限为 100。 默认每页大小为 100；结果跨页时，注明 pagination.total。

如果 MCP 不可用，请指引用户前往 shoogle.dev/mcp-install。有关参数或响应的详情，请阅读 references/TOOL-REFERENCE.md。

输出格式

始终使用 Markdown 表格回复：

name	registry	add command	type	description

• add command：如果存在，则使用 npx shadcn@latest add {addCommandArgument}
• 描述为空时使用 —
• 相关时，在末尾注明匹配数量和页码信息

示例 — 用户要求搜索多个注册表中的按钮组件：

name	registry	add command	type	description
button	shadcn	npx shadcn@latest add shadcn/button	registry:ui	可点击的按钮组件
button	cult-ui	npx shadcn@latest add cult-ui/button	registry:ui	动画按钮变体

找到 2 个匹配项（显示第 1–2 个，共 2 个）。要从哪个注册表添加？

适用范围之外

需求	改用
按名称或描述查找注册表条目	search_registry_items（此技能）
区块关键词搜索	shoogle.dev/search
语义／布局发现	shoogle.dev/search
安装已知条目	shadcn CLI add / view
浏览单个注册表	npx shadcn@latest search @registry -q "…"