SuperAPI AI 工具集

storybook-mcp-integration

智能体与模型

查看项目

更新于 10-15 23:41

技能介绍

用途:通过 Storybook MCP 服务器(@storybook/addon-mcp)让智能体了解项目实际的组件库,包括 props、stories、测试和实时预览。适用场景包括组件生成前先查已有组件、通过 MCP 而非 CLI 运行 story 测试与 a11y 审计、在对话中嵌入 story 预览做视觉确认,以及带完整元数据的组件盘点。

主要能力:共 6 个工具,分 3 个工具集。dev 集含 get-storybook-story-instructions(编写 story 与交互测试的指导)和 preview-stories(返回可嵌入的预览 URL,输入 stories[],可用 storyId 或 absoluteStoryPath+exportName)。docs 集含 list-all-documentation(组件与文档清单索引)、get-documentation(props、前 3 个 story、story 索引与文档,id 必填)、get-documentation-for-story(完整 story 源码与组件文档,需 componentId 与 storyName)。testing 集含 run-story-tests(运行组件与 a11y 测试,返回通过/失败与违规项,stories[] 可选,a11y 默认 true)。

使用方式:需 Storybook 10.3+ 且使用 Vite 构建器(不支持 webpack)。升级用 npx storybook@latest upgrade;安装插件用 npx storybook add @storybook/addon-mcp。docs 工具集需在 .storybook/main.ts 中启用 componentsManifest: true(旧 experimentalComponentsManifest 已改名,默认开启)。testing 工具集需 addon-vitest。注册到 Claude Code 用 npx mcp-add --type http --url "http://localhost:6006/mcp" --scope project。使用前可用 ToolSearch(query="+storybook list-all-documentation") 探测可用性。可通过 X-MCP-Toolsets 请求头按角色筛选工具集以减少上下文。Chromatic 远程场景改用独立包 @storybook/mcp,仅 docs 工具集可远程发布。

限制:dev 与 testing 工具集需本地 Storybook;MCP 不可用时降级为文件系统检索、21st.dev 注册表搜索或截图人工分析。具体收费与价格暂未提供。