SuperAPI AI 工具集

search-registry-items

前端与建站

查看项目

更新于 10-15 18:45

技能介绍

用途:当用户想找某个 shadcn 组件但未给出确切的 @registry/name 时,用关键词在已索引的 shadcn registry 目录中检索条目;也可用于比较不同 registry、或在执行 add 前核实目标。

主要能力:通过 user-shoogle 上的单个 MCP 工具 search_registry_items 进行全文搜索,检索范围是条目名称与描述(非标题、非语义/向量搜索),返回 registry 命名空间和用于 npx shadcn@latest add 的 addCommandArgument。

必要用法:调用形式为 CallMcpTool({ "server": "user-shoogle", "toolName": "search_registry_items", "arguments": { "query": "button" } })。查询应使用简短关键词或名称片段,而不是完整句子,例如 button、hero、data-table,不要带 @registry 前缀;空或纯空白查询无结果。结果需以 markdown 表格呈现(name、registry、add command、type、description),不要直接输出原始 JSON;多个 registry 同名时询问用户选择哪一个;仅在需要时按 offset += limit 分页(pagination.hasMore)。安装使用 npx shadcn@latest add {addCommandArgument},addCommandArgument 须原样使用,不要由 @registry/name 反推。分页上限 100,默认页大小为 100,跨页时说明 pagination.total。若用户已给出确切 add 目标(如 @cult-ui/gradient-button),跳过搜索直接 view/add;搜索后的安装与组合规则参见 shadcn 技能。

限制与不适用:该技能仅提供这一个 MCP 工具,块搜索与语义搜索(search、search_vectors)不可用,语义/布局发现应改用 shoogle.dev/search;不要用 npx shadcn@latest search 完成本流程。多概念自然语言查询(如带暗色模式的登录页)效果不佳,无结果时可尝试更短片段或同义词(dialog 与 modal)。MCP 不可用时指向 shoogle.dev/mcp-install;参数与响应细节见 references/TOOL-REFERENCE.md。浏览单个 registry 可用 npx shadcn@latest search @registry -q "…"。