{"_id":"mcp-design-system-extractor","_rev":"6-6f271fd133ee1042a9bcbfd2bcde15b7","name":"mcp-design-system-extractor","dist-tags":{"latest":"1.3.0"},"versions":{"1.0.0":{"name":"mcp-design-system-extractor","version":"1.0.0","keywords":["mcp","model-context-protocol","storybook","design-system","component-extraction","web-components","claude","ai"],"author":{"name":"graslt"},"license":"MIT","_id":"mcp-design-system-extractor@1.0.0","maintainers":[{"name":"freema","email":"grasl.t@centrum.cz"}],"homepage":"https://github.com/freema/mcp-design-system-extractor#readme","bugs":{"url":"https://github.com/freema/mcp-design-system-extractor/issues"},"bin":{"mcp-design-system-extractor":"dist/index.js"},"dist":{"shasum":"4e88700cc4972e99a2389dc31255cdfe0e444fec","tarball":"https://registry.npmjs.org/mcp-design-system-extractor/-/mcp-design-system-extractor-1.0.0.tgz","fileCount":5,"integrity":"sha512-jlDagl9gddzZ7XOhq816el5HQ/QmqcBazJ03kMd90ATkdSvR7UTFbSbHUpbeQx3keaR+LdP8sHFmGHe69Fewng==","signatures":[{"sig":"MEQCICpG31mu/eu4VA4bo9nKHs8tnaw3ZlNXBYAFEJxPabeRAiBsDCxqS1s7kmGNorIq++KEnpE92Qq5yfqZzpBaUEL70Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":251982},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"8780ab3218dc3aa120eaed7bb5b168fc9b7be6a8","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src --ext .ts","test":"vitest","build":"tsup","check":"npm run typecheck && npm run lint && npm run format:check","clean":"rm -rf dist","setup":"node scripts/setup-mcp-config.js","start":"node dist/index.js","format":"prettier --write \"src/**/*.ts\"","test:ui":"vitest --ui","lint:fix":"eslint src --ext .ts --fix","test:run":"vitest run","check:all":"npm run check && npm run test:run && npm run build","inspector":"npx @modelcontextprotocol/inspector node dist/index.js","typecheck":"tsc --noEmit","test:watch":"vitest watch","format:check":"prettier --check \"src/**/*.ts\"","inspector:dev":"NODE_ENV=development npx @modelcontextprotocol/inspector npx tsx src/index.ts","test:coverage":"vitest run --coverage","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"freema","email":"grasl.t@centrum.cz"},"repository":{"url":"git+https://github.com/freema/mcp-design-system-extractor.git","type":"git"},"_npmVersion":"11.1.0","description":"Simplified MCP server for Storybook design system extraction with component analysis tools","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.22.4","puppeteer":"^24.10.1","node-html-parser":"^6.1.11","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","tsup":"^8.0.0","eslint":"^8.57.1","vitest":"^3.1.4","prettier":"^3.5.3","@vitest/ui":"^3.1.4","typescript":"^5.3.3","@types/node":"^20.11.0","@vitest/coverage-v8":"^3.1.4","eslint-config-prettier":"^10.1.5","eslint-plugin-prettier":"^5.4.0","@typescript-eslint/parser":"^6.21.0","@typescript-eslint/eslint-plugin":"^6.21.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-design-system-extractor_1.0.0_1752217381707_0.6121715567350032","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"mcp-design-system-extractor","version":"1.0.1","keywords":["mcp","model-context-protocol","storybook","design-system","component-extraction","web-components","claude","ai"],"author":{"name":"graslt"},"license":"MIT","_id":"mcp-design-system-extractor@1.0.1","maintainers":[{"name":"freema","email":"grasl.t@centrum.cz"}],"homepage":"https://github.com/freema/mcp-design-system-extractor#readme","bugs":{"url":"https://github.com/freema/mcp-design-system-extractor/issues"},"bin":{"mcp-design-system-extractor":"dist/index.js"},"dist":{"shasum":"059b2e4e95decad8ed55bc139ab90c084b11e304","tarball":"https://registry.npmjs.org/mcp-design-system-extractor/-/mcp-design-system-extractor-1.0.1.tgz","fileCount":5,"integrity":"sha512-W/3dQDIJ7EynilZNR2zXhQCCi652aVbVDpm20jhAEL9ka5MzMUNFHx8Tv0sZe7ynGICUm6p3L3QH3ojdBpbBSg==","signatures":[{"sig":"MEUCIB44qX35NhZJEqQNkOLpglz5gIrBYXqMLwepMW72vLTbAiEA+ZoYafSDYtEP17DbO9fG1E+9G0yskngMvvaG4sN17Zg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/mcp-design-system-extractor@1.0.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":252216},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"0142aaa3b550f43a9a536c946f66433f19695872","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src --ext .ts","test":"vitest","build":"tsup","check":"npm run typecheck && npm run lint && npm run format:check","clean":"rm -rf dist","setup":"node scripts/setup-mcp-config.js","start":"node dist/index.js","format":"prettier --write \"src/**/*.ts\"","test:ui":"vitest --ui","lint:fix":"eslint src --ext .ts --fix","test:run":"vitest run","check:all":"npm run check && npm run test:run && npm run build","inspector":"npx @modelcontextprotocol/inspector node dist/index.js","typecheck":"tsc --noEmit","test:watch":"vitest watch","format:check":"prettier --check \"src/**/*.ts\"","inspector:dev":"NODE_ENV=development npx @modelcontextprotocol/inspector npx tsx src/index.ts","test:coverage":"vitest run --coverage","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"freema","email":"grasl.t@centrum.cz"},"repository":{"url":"git+https://github.com/freema/mcp-design-system-extractor.git","type":"git"},"_npmVersion":"10.8.2","description":"Simplified MCP server for Storybook design system extraction with component analysis tools","directories":{},"_nodeVersion":"18.20.8","dependencies":{"zod":"^3.22.4","puppeteer":"^24.10.1","node-html-parser":"^6.1.11","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","tsup":"^8.0.0","eslint":"^8.57.1","vitest":"^3.1.4","prettier":"^3.5.3","@vitest/ui":"^3.1.4","typescript":"^5.3.3","@types/node":"^20.11.0","@vitest/coverage-v8":"^3.1.4","eslint-config-prettier":"^10.1.5","eslint-plugin-prettier":"^5.4.0","@typescript-eslint/parser":"^6.21.0","@typescript-eslint/eslint-plugin":"^6.21.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-design-system-extractor_1.0.1_1756385386338_0.006198226725440792","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"mcp-design-system-extractor","version":"1.1.0","keywords":["mcp","model-context-protocol","storybook","design-system","component-extraction","web-components","claude","ai"],"author":{"name":"graslt"},"license":"MIT","_id":"mcp-design-system-extractor@1.1.0","maintainers":[{"name":"freema","email":"grasl.t@centrum.cz"}],"homepage":"https://github.com/freema/mcp-design-system-extractor#readme","bugs":{"url":"https://github.com/freema/mcp-design-system-extractor/issues"},"bin":{"mcp-design-system-extractor":"dist/index.js"},"dist":{"shasum":"a2324dc0fced7821a0a68dbc6d30c1cde7eb3d1b","tarball":"https://registry.npmjs.org/mcp-design-system-extractor/-/mcp-design-system-extractor-1.1.0.tgz","fileCount":5,"integrity":"sha512-Q1IFG6yHIOtP44Ui1qHOwvXojIEfhzKsm7ri4yZp6x+3MOI2ini84H3YNprT+sFh/dLMnRF6FvLP+fpJH0RPOQ==","signatures":[{"sig":"MEQCIDabA6ZtBpVDlVexMAHK8TrtsUyaJFxNfyg9ifb3d8UcAiAhB1FAkQblYto3GEBGF4+wQVlztB7Pe9HU26k2Qqy8dQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/mcp-design-system-extractor@1.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":262690},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"5ce9de31812db7503fdb3add66105b2386478b92","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src --ext .ts","test":"vitest","build":"tsup","check":"npm run typecheck && npm run lint && npm run format:check","clean":"rm -rf dist","setup":"node scripts/setup-mcp-config.js","start":"node dist/index.js","format":"prettier --write \"src/**/*.ts\"","test:ui":"vitest --ui","lint:fix":"eslint src --ext .ts --fix","test:run":"vitest run","check:all":"npm run check && npm run test:run && npm run build","inspector":"npx @modelcontextprotocol/inspector node dist/index.js","typecheck":"tsc --noEmit","test:watch":"vitest watch","format:check":"prettier --check \"src/**/*.ts\"","inspector:dev":"NODE_ENV=development npx @modelcontextprotocol/inspector npx tsx src/index.ts","test:coverage":"vitest run --coverage","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"freema","email":"grasl.t@centrum.cz"},"repository":{"url":"git+https://github.com/freema/mcp-design-system-extractor.git","type":"git"},"_npmVersion":"10.8.2","description":"Simplified MCP server for Storybook design system extraction with component analysis tools","directories":{},"_nodeVersion":"18.20.8","dependencies":{"zod":"^3.22.4","puppeteer":"^24.10.1","node-html-parser":"^6.1.11","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","tsup":"^8.0.0","eslint":"^8.57.1","vitest":"^3.1.4","prettier":"^3.5.3","@vitest/ui":"^3.1.4","typescript":"^5.3.3","@types/node":"^20.11.0","@vitest/coverage-v8":"^3.1.4","eslint-config-prettier":"^10.1.5","eslint-plugin-prettier":"^5.4.0","@typescript-eslint/parser":"^6.21.0","@typescript-eslint/eslint-plugin":"^6.21.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-design-system-extractor_1.1.0_1768052885186_0.27874476294836215","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"mcp-design-system-extractor","version":"1.1.1","keywords":["mcp","model-context-protocol","storybook","design-system","component-extraction","web-components","claude","ai"],"author":{"name":"graslt"},"license":"MIT","_id":"mcp-design-system-extractor@1.1.1","maintainers":[{"name":"freema","email":"grasl.t@centrum.cz"}],"homepage":"https://github.com/freema/mcp-design-system-extractor#readme","bugs":{"url":"https://github.com/freema/mcp-design-system-extractor/issues"},"bin":{"mcp-design-system-extractor":"dist/index.js"},"dist":{"shasum":"34d3890134b022b3c6ec8439b9b12530f25dbc65","tarball":"https://registry.npmjs.org/mcp-design-system-extractor/-/mcp-design-system-extractor-1.1.1.tgz","fileCount":5,"integrity":"sha512-IysX65EDzwvpFJKYukvH9neuiK7JWYsXVSFAS+LuuUgySxc93NYNDXdtBMNgFogKdvQRk2C0y15K//1uN67ciQ==","signatures":[{"sig":"MEUCIC8C5JrSGDktVC/Yc6/mpiAZwK8X1iWmOZLFHy8HH/s2AiEA7UVKCofqMe1VPtn3dDQCCRuAdYAhyhI5Vhwer/cgP3U=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/mcp-design-system-extractor@1.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":262690},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"5b285c3c9c10d6286dec513a41bb098b37aef419","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src --ext .ts","test":"vitest","build":"tsup","check":"npm run typecheck && npm run lint && npm run format:check","clean":"rm -rf dist","setup":"node scripts/setup-mcp-config.js","start":"node dist/index.js","format":"prettier --write \"src/**/*.ts\"","test:ui":"vitest --ui","lint:fix":"eslint src --ext .ts --fix","test:run":"vitest run","check:all":"npm run check && npm run test:run && npm run build","inspector":"npx @modelcontextprotocol/inspector node dist/index.js","typecheck":"tsc --noEmit","test:watch":"vitest watch","format:check":"prettier --check \"src/**/*.ts\"","inspector:dev":"NODE_ENV=development npx @modelcontextprotocol/inspector npx tsx src/index.ts","test:coverage":"vitest run --coverage","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"freema","email":"grasl.t@centrum.cz"},"repository":{"url":"git+https://github.com/freema/mcp-design-system-extractor.git","type":"git"},"_npmVersion":"10.8.2","description":"Simplified MCP server for Storybook design system extraction with component analysis tools","directories":{},"_nodeVersion":"18.20.8","dependencies":{"zod":"^3.22.4","puppeteer":"^24.10.1","node-html-parser":"^6.1.11","@modelcontextprotocol/sdk":"^0.5.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","tsup":"^8.0.0","eslint":"^8.57.1","vitest":"^3.1.4","prettier":"^3.5.3","@vitest/ui":"^3.1.4","typescript":"^5.3.3","@types/node":"^20.11.0","@vitest/coverage-v8":"^3.1.4","eslint-config-prettier":"^10.1.5","eslint-plugin-prettier":"^5.4.0","@typescript-eslint/parser":"^6.21.0","@typescript-eslint/eslint-plugin":"^6.21.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-design-system-extractor_1.1.1_1770196873063_0.4510560541367741","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"mcp-design-system-extractor","version":"1.2.0","keywords":["mcp","model-context-protocol","storybook","design-system","component-extraction","web-components","claude","ai"],"author":{"name":"graslt"},"license":"MIT","_id":"mcp-design-system-extractor@1.2.0","maintainers":[{"name":"freema","email":"grasl.t@centrum.cz"}],"homepage":"https://github.com/freema/mcp-design-system-extractor#readme","bugs":{"url":"https://github.com/freema/mcp-design-system-extractor/issues"},"bin":{"mcp-design-system-extractor":"dist/index.js"},"dist":{"shasum":"bb66c4bda06ec185daadbaf5b22f79f93a9317b5","tarball":"https://registry.npmjs.org/mcp-design-system-extractor/-/mcp-design-system-extractor-1.2.0.tgz","fileCount":5,"integrity":"sha512-oTqeNqkNVsK1bxkgsYMCe0muFKtrKJ+yEiFZkjqk8beR8svZaV7r1ydxpyOkSMjuBK8F2Gu7PjnONnYZIuxLDQ==","signatures":[{"sig":"MEUCIAoEP6SW2lwuNDoT07lGPiCBVDC2IvGlAhG04O+CJ5G+AiEA9Niktv7XavI3RMnIXDNNhITXN26Cg+LwPQKhnOR8Vmc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/mcp-design-system-extractor@1.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1252893},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20.0.0"},"gitHead":"fa3d32950f86b1a8af7b8bfd2656102f0d48f0ca","mcpName":"io.github.freema/mcp-design-system-extractor","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src","test":"vitest","build":"tsup","check":"npm run typecheck && npm run lint && npm run format:check","clean":"rm -rf dist","setup":"node scripts/setup-mcp-config.js","start":"node dist/index.js","format":"prettier --write \"src/**/*.ts\"","test:ui":"vitest --ui","lint:fix":"eslint src --fix","test:run":"vitest run","check:all":"npm run check && npm run test:run && npm run build","inspector":"npx @modelcontextprotocol/inspector node dist/index.js","typecheck":"tsc --noEmit","test:watch":"vitest watch","format:check":"prettier --check \"src/**/*.ts\"","inspector:dev":"NODE_ENV=development npx @modelcontextprotocol/inspector npx tsx src/index.ts","test:coverage":"vitest run --coverage","prepublishOnly":"npm run clean && npm run build"},"_npmUser":{"name":"freema","email":"grasl.t@centrum.cz"},"repository":{"url":"git+https://github.com/freema/mcp-design-system-extractor.git","type":"git"},"_npmVersion":"10.8.2","description":"Simplified MCP server for Storybook design system extraction with component analysis tools","directories":{},"_nodeVersion":"20.20.2","dependencies":{"zod":"^4.4.3","puppeteer":"^25.3.0","node-html-parser":"^9.0.0","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.7.0","tsup":"^8.0.0","eslint":"^10.8.0","vitest":"^4.1.10","globals":"^17.8.0","prettier":"^3.9.6","@eslint/js":"^10.0.1","@vitest/ui":"^4.1.10","typescript":"^5.3.3","@types/node":"^26.1.1","typescript-eslint":"^8.65.0","@vitest/coverage-v8":"^4.1.10","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.6"},"_npmOperationalInternal":{"tmp":"tmp/mcp-design-system-extractor_1.2.0_1785148956688_0.04599370570294581","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"_id":"mcp-design-system-extractor@1.3.0","bin":{"mcp-design-system-extractor":"dist/index.js"},"bugs":{"url":"https://github.com/freema/mcp-design-system-extractor/issues"},"dist":{"shasum":"20f5dea99e4f17e68d40b71dad54680fc35f5424","tarball":"https://registry.npmjs.org/mcp-design-system-extractor/-/mcp-design-system-extractor-1.3.0.tgz","fileCount":5,"integrity":"sha512-RjoroGTbHoiAn/v1W4GQZaNsY86Kam8JheSfqAt0W85K5kcYCA8F1D9RIodu222WshtNdG93adrQrQU/wwAFkg==","signatures":[{"sig":"MEQCIDAo7m8QY+amBOWEV7w1gClds1vEyFkEThwjiGTUy78BAiBy7rvIxVRWj7u8rGjMPfUtwwTMHq2dslTEkUncHeFCEg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCx0BJIjYO2GlIvtGdu1oOM5cNKC+52WRRtMfv8Mw2VkAIgDpMW8OIJpwTQuClnuczqcoS4/XUdWyutQExPqE1exIc="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/mcp-design-system-extractor@1.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1493780},"main":"dist/index.js","name":"mcp-design-system-extractor","type":"module","types":"dist/index.d.ts","author":{"name":"graslt"},"engines":{"node":">=22.12.0"},"gitHead":"e30ea7ba9cc1aa8f78f2ca1c105a8e3c740af5cd","license":"MIT","mcpName":"io.github.freema/mcp-design-system-extractor","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src","test":"vitest","build":"tsup","check":"npm run typecheck && npm run lint && npm run format:check","clean":"rm -rf dist","setup":"node scripts/setup-mcp-config.js","start":"node dist/index.js","format":"prettier --write \"src/**/*.ts\"","test:ui":"vitest --ui","lint:fix":"eslint src --fix","test:run":"vitest run","check:all":"npm run check && npm run test:run && npm run build","inspector":"npx @modelcontextprotocol/inspector node dist/index.js","typecheck":"tsc --noEmit","test:watch":"vitest watch","format:check":"prettier --check \"src/**/*.ts\"","inspector:dev":"NODE_ENV=development npx @modelcontextprotocol/inspector npx tsx src/index.ts","test:coverage":"vitest run --coverage","prepublishOnly":"npm run clean && npm run build"},"version":"1.3.0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"7d2cb575-1830-4c42-9d41-c5b8be3e06f0"}},"homepage":"https://github.com/freema/mcp-design-system-extractor#readme","keywords":["mcp","model-context-protocol","storybook","design-system","component-extraction","web-components","claude","ai"],"repository":{"url":"git+https://github.com/freema/mcp-design-system-extractor.git","type":"git"},"_npmVersion":"11.19.1","description":"Simplified MCP server for Storybook design system extraction with component analysis tools","directories":{},"maintainers":[{"name":"freema","email":"grasl.t@centrum.cz"}],"_nodeVersion":"24.22.2","dependencies":{"zod":"^4.6.7","puppeteer":"^25.16.0","node-html-parser":"^9.0.6","@modelcontextprotocol/sdk":"^1.32.2"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.23.15","tsup":"^8.5.1","eslint":"^10.14.0","vitest":"^4.1.12","globals":"^17.14.0","prettier":"^3.9.10","@eslint/js":"^10.0.1","@vitest/ui":"^4.1.12","typescript":"^5.9.3","@types/node":"^26.6.6","typescript-eslint":"^8.72.1","@vitest/coverage-v8":"^4.1.12","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.7"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-design-system-extractor_1.3.0_1793973360951_0.8642463559406602"}}},"time":{"created":"2025-07-11T07:03:01.706Z","modified":"2026-11-06T13:56:01.670Z","1.0.0":"2025-07-11T07:03:01.885Z","1.0.1":"2025-08-28T12:49:46.532Z","1.1.0":"2026-01-10T13:48:05.366Z","1.1.1":"2026-02-04T09:21:13.204Z","1.2.0":"2026-07-27T10:42:36.842Z","1.3.0":"2026-11-06T13:56:01.037Z"},"bugs":{"url":"https://github.com/freema/mcp-design-system-extractor/issues"},"author":{"name":"graslt"},"license":"MIT","homepage":"https://github.com/freema/mcp-design-system-extractor#readme","keywords":["mcp","model-context-protocol","storybook","design-system","component-extraction","web-components","claude","ai"],"repository":{"url":"git+https://github.com/freema/mcp-design-system-extractor.git","type":"git"},"description":"Simplified MCP server for Storybook design system extraction with component analysis tools","maintainers":[{"name":"freema","email":"grasl.t@centrum.cz"}],"readme":"# MCP Design System Extractor\n\nA Model Context Protocol (MCP) server that extracts component information from Storybook design systems. Connects to Storybook instances and extracts HTML, styles, and component metadata.\n\n![Demo](assets/demo.gif)\n\n## Installation\n\n### Using Claude CLI (Recommended)\n\n```bash\nclaude mcp add design-system npx mcp-design-system-extractor@latest \\\n  --env STORYBOOK_URL=http://localhost:6006\n```\n\nWith self-signed certificate:\n```bash\nclaude mcp add design-system npx mcp-design-system-extractor@latest \\\n  --env STORYBOOK_URL=https://my-storybook.example.com \\\n  --env NODE_TLS_REJECT_UNAUTHORIZED=0\n```\n\n### Using npm\n\n```bash\nnpm install -g mcp-design-system-extractor\n```\n\nThen configure in your MCP client (see [Environment Variables](#environment-variables)).\n\n### From Source\n\n```bash\ngit clone https://github.com/freema/mcp-design-system-extractor.git\ncd mcp-design-system-extractor\nnpm install && npm run build\nnpm run setup  # Interactive setup for Claude Desktop\n```\n\n## Key Dependencies\n\n- **Puppeteer**: Uses headless Chrome for dynamic JavaScript component rendering\n- **Chrome/Chromium**: Required for Puppeteer (automatically handled in Docker)\n- Works with built Storybook distributions\n\n<a href=\"https://glama.ai/mcp/servers/@freema/mcp-design-system-extractor\">\n  <img width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@freema/mcp-design-system-extractor/badge\" alt=\"Design System Extractor MCP server\" />\n</a>\n\n## Features\n\n- **List Components**: Get all available components from your Storybook with compact mode\n- **Extract HTML**: Get the rendered HTML of any component (async or sync mode)\n- **Search Components**: Find components by name, title, category, or purpose\n- **Component Dependencies**: Analyze which components are used within other components\n- **Theme Information**: Extract design system theme (colors, spacing, typography)\n- **External CSS Analysis**: Fetch and analyze CSS files to extract design tokens\n- **Async Job Queue**: Long-running operations run in background with job tracking\n\n## Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `STORYBOOK_URL` | URL of your Storybook instance | `http://localhost:6006` |\n| `NODE_TLS_REJECT_UNAUTHORIZED` | Set to `0` to skip SSL certificate verification (for self-signed certs) | `1` |\n\n**Example with self-signed certificate:**\n```json\n{\n  \"mcpServers\": {\n    \"design-system\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/dist/index.js\"],\n      \"env\": {\n        \"STORYBOOK_URL\": \"https://my-storybook.example.com\",\n        \"NODE_TLS_REJECT_UNAUTHORIZED\": \"0\"\n      }\n    }\n  }\n}\n```\n\n## Usage\n\nSee [DEVELOPMENT.md](./DEVELOPMENT.md) for detailed setup instructions.\n\n## Available Tools (9 total)\n\n### Core Tools\n\n1. **list_components**\n   - Lists all available components from the Storybook instance\n   - Use `compact: true` for minimal output (reduces response size)\n   - Filter by `category` parameter\n   - Supports pagination with `page` and `pageSize` (default: 20)\n\n2. **get_component_html**\n   - Extracts HTML from a specific component story\n   - **Async by default**: Returns `job_id`, use `job_status` to poll for results\n   - Set `async: false` for synchronous mode (uses `timeout` parameter)\n   - Use `variantsOnly: true` to get list of available variants (sync, fast)\n   - Optional `includeStyles: true` for CSS extraction (Storybook CSS filtered out)\n   - Story ID format: `\"component-name--story-name\"` or just `\"component-name\"` (auto-resolves to default variant)\n\n3. **search_components**\n   - Search components by name, title, category, or purpose\n   - `query`: Search term (use `\"*\"` for all)\n   - `purpose`: Find by function (\"form inputs\", \"navigation\", \"feedback\", \"buttons\", etc.)\n   - `searchIn`: \"name\", \"title\", \"category\", or \"all\" (default)\n   - Supports pagination with `page` and `pageSize`\n\n### Component Analysis Tools\n\n4. **get_component_dependencies**\n   - Analyzes rendered HTML to find which other components are used internally\n   - Detects React components, web components, and CSS class patterns\n   - Requires story ID format: `\"component-name--story-name\"`\n\n### Design System Tools\n\n5. **get_theme_info**\n   - Extracts design system theme (colors, spacing, typography, breakpoints)\n   - Gets CSS custom properties/variables\n   - Use `includeAll: true` for all CSS variables\n\n6. **get_external_css**\n   - **DEFAULT**: Returns only design tokens + file stats (avoids token limits)\n   - Extracts & categorizes tokens: colors, spacing, typography, shadows\n   - Use `includeFullCSS: true` only when you need full CSS content\n   - Security-protected: only accepts URLs from same domain as Storybook\n\n### Job Management Tools\n\n7. **job_status**\n   - Check status of an async job\n   - Returns: `status`, `result` (when completed), `error` (when failed)\n   - Poll this after calling `get_component_html` in async mode\n\n8. **job_cancel**\n   - Cancel a queued or running job\n   - Returns whether cancellation was successful\n\n9. **job_list**\n   - List all jobs with their status\n   - Filter by `status`: \"all\" (default), \"active\" (queued/running), \"completed\"\n   - Returns job list + queue statistics\n\n## Example Usage\n\n```typescript\n// List all components (compact mode recommended)\nawait list_components({ compact: true });\n\n// Search for components\nawait search_components({ query: \"button\", searchIn: \"name\" });\n\n// Find components by purpose\nawait search_components({ purpose: \"form inputs\" });\n\n// Get variants for a component\nawait get_component_html({\n  componentId: \"button\",\n  variantsOnly: true\n});\n// Returns: { variants: [\"primary\", \"secondary\", \"disabled\"] }\n\n// Get HTML (async mode - default)\nawait get_component_html({ componentId: \"button--primary\" });\n// Returns: { job_id: \"job_xxx\", status: \"queued\" }\n\n// Poll for result\nawait job_status({ job_id: \"job_xxx\" });\n// Returns: { status: \"completed\", result: { html: \"...\", classes: [...] } }\n\n// Get HTML (sync mode)\nawait get_component_html({\n  componentId: \"button--primary\",\n  async: false,\n  timeout: 30000\n});\n// Returns: { html: \"...\", classes: [...] }\n\n// Get HTML with styles\nawait get_component_html({\n  componentId: \"button--primary\",\n  async: false,\n  includeStyles: true\n});\n\n// Check all running jobs\nawait job_list({ status: \"active\" });\n\n// Extract theme info\nawait get_theme_info({ includeAll: false });\n\n// Get design tokens from CSS\nawait get_external_css({\n  cssUrl: \"https://my-storybook.com/assets/main.css\"\n});\n```\n\n### AI Assistant Usage Tips\n\n1. **Start with discovery**: Use `list_components` with `compact: true`\n2. **Get variants first**: Use `get_component_html` with `variantsOnly: true`\n3. **Use async for HTML**: Default async mode prevents timeouts on large components\n4. **Poll job_status**: Check job completion before reading results\n5. **Search by purpose**: Use `search_components` with `purpose` parameter\n\n## Example Prompts\n\nOnce connected, you can use natural language prompts with Claude:\n\n![MCP Servers Connected](assets/mcp-servers.png)\n\n**Component Discovery:**\n```\nShow me all available button components in the design system\n```\n\n**Building New Features:**\n```\nI need to create a user profile card. Find relevant components\nfrom the design system and show me their HTML structure.\n```\n\n**Design System Analysis:**\n```\nExtract the color palette and typography tokens from the design system.\nI want to ensure my new component matches the existing styles.\n```\n\n**Component Migration:**\n```\nGet the HTML and styles for the \"alert\" component. I need to\nrecreate it in a different framework while keeping the same look.\n```\n\n**Multi-Tool Workflow:**\n```\nFirst list all form-related components, then get the HTML for\nthe input and select components. I'm building a registration form.\n```\n\n## How It Works\n\nConnects to Storybook via `/index.json` and `/iframe.html` endpoints. Uses Puppeteer with headless Chrome for dynamic JavaScript rendering. Long-running operations use an in-memory job queue with max 2 concurrent jobs and 1-hour TTL for completed jobs.\n\n## Troubleshooting\n\n- Ensure Storybook is running and `STORYBOOK_URL` is correct\n- Use `list_components` first to see available components\n- For large components, use async mode (default) and poll `job_status`\n- Check `/index.json` endpoint directly in browser\n- **SSL certificate errors**: Set `NODE_TLS_REJECT_UNAUTHORIZED=0` for self-signed certificates\n- See [DEVELOPMENT.md](./DEVELOPMENT.md) for detailed troubleshooting\n\n## Requirements\n\n- Node.js 22.12+\n- Chrome/Chromium (for Puppeteer)\n- Running Storybook instance (see below for supported versions)\n\n### Supported Storybook versions\n\n**Storybook 7, 8, 9 and 10.** The server reads the story index from\n`/index.json`, falling back to `/stories.json`, and renders stories through\n`/iframe.html?id=<storyId>` — endpoints that have been stable across all four\nmajor versions.\n\nStorybook 6 and earlier are not supported: they predate `/index.json` and use\na different story-id scheme.\n\nBoth a dev server (`npm run storybook`) and a built static Storybook served\nover HTTP will work.\n\n## Development\n\nSee [DEVELOPMENT.md](./DEVELOPMENT.md) for detailed development instructions.\n\n## Author\n\nCreated by [Tomáš Grasl](https://www.tomasgrasl.cz/)\n\n## License\n\nMIT\n","readmeFilename":"README.md"}