AI 與 Agent
MCP
用 shadcn-vue 官方 MCP server,在對話中瀏覽與安裝 @admin 元件。
Admin Registry 相容 shadcn-vue registry,可接官方 MCP(npx shadcn-vue@latest mcp)。需 Node.js 22 以上,見安裝。
在 components.json 註冊
MCP 讀專案根目錄 components.json。需有 @admin:
{ "iconLibrary": "tabler", "registries": { "@admin": { "url": "https://component-registry-4d4d86.gitlab.io/r/styles/admin/{name}.json" } }}iconLibrary 須為 tabler。MCP 安裝走同一個 CLI;若是 lucide,不會裝上 @tabler/icons-vue。做法見安裝。
重啟 MCP client 後,對話可用 @admin/<component>。
Prompt 範例
- 「列出所有
@admin元件,依用途分組」 - 「安裝
@admin/button、@admin/dialog、@admin/input」 - 「用
@admin寫含 loading 的登入表單;先列@admin/<x>再給程式碼」
要求「先列清單再給程式碼」可減少一次產出大量不可用內容。
查詢範例
get_item_examples_from_registries 可查到已發佈的 demo,以 @admin 為 registry,用 <component>-demo(例如 button-demo)或 <component> example(例如 dialog example)查詢。
目前已發佈 13 個:badge、button、checkbox、dialog、divider、input、progress、select、switch、tabs、tag、textarea、tooltip。其他元件尚未發佈,請改看文件站,或讀 /llms-full.txt。
已知限制
以 shadcn-vue 2.8.2 為準:
list_items_in_registries、search_items_in_registries回傳的 Add command 欄位會顯示[object Promise](上游 bug)。請改用get_add_command_for_items取得安裝指令。
與 llms.txt
| 方式 | 何時用 |
|---|---|
| MCP | 要 AI 執行 shadcn-vue add、列元件、依需求安裝 |
| llms.txt | 只要讀文件(web fetch);無 MCP 或不想設 server |
可並用:MCP 裝元件,/llms-full.txt 補 API/demo。工作流規則見 Agent skill。