mcp-design-system-extractor
A local MCP server that reads component information from a Storybook instance whose address is set in the STORYBOOK_URL environment variable.
What it does
A local MCP server that reads component information from a Storybook instance whose address is set in the STORYBOOK_URL environment variable. It renders stories in headless Chrome through Puppeteer, so the agent can list and search components by name, category or purpose, get the rendered HTML of a story with its styles, see which other components a component uses, and pull theme values such as colours, spacing, typography and breakpoints from CSS custom properties. Another tool fetches stylesheets from the same domain and sorts out their design tokens. Slow HTML extraction runs as background jobs with status, cancel and list tools. It installs through npx, including a claude mcp add command.
Capabilities
- List and search Storybook components by name, category or purpose
- Extract rendered HTML and CSS for a component story
- Extract theme tokens such as colours, spacing and typography
- Find which components are used inside another component
About
- Publisher
- Tomáš Grasl (freema)
- Tool
- Design
Works with
Install
- Run this to add it to Claude Code:
claude mcp add design-system npx mcp-design-system-extractor@latest \ --env STORYBOOK_URL=http://localhost:6006
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
Details
| Fact | Value | Source |
|---|---|---|
| Type | MCP server | |
| Tool | Design | |
| Publisher | Tomáš Grasl (freema) | source |
| Official status | Not stated in its documentation | |
| Connection | Local (runs on your computer) | source |
| Can change data | No | source |
| Needs an API key or sign-in | Not stated in its documentation | |
| Platforms | Not stated in its documentation | |
| AI clients | Claude Code, Claude Desktop | source |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Nov 6, 2026Version 1.3.073 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website npm: mcp-design-system-extractor |
Badge for your README
Maintain this project? Add a badge that links to this page.
[](https://kitbay.app/servers/freema-mcp-design-system-extractor/)
Also listed under: Design
Sources
- README (README.md)github.com/freema/mcp-design-system-extractor · Backs: AI clients, ConnectionNov 12, 2026
- Licence file (LICENSE)github.com/freema/mcp-design-system-extractor · Backs: Licence, PublisherNov 12, 2026
- GitHub repositorygithub.com/freema/mcp-design-system-extractor · Backs: Activity, LicenceNov 10, 2026
- MCP Registry entryio.github.freema/mcp-design-system-extractor · Backs: ConnectionNov 10, 2026
- npm package recordnpmjs.com/package/mcp-design-system-extractorNov 10, 2026