MCP Design System Extractor MCP Server

Simplified MCP server for Storybook design system extraction with component analysis tools

Local serverstdioTypeScript

What is the MCP Design System Extractor MCP server?

Simplified MCP server for Storybook design system extraction with component analysis tools. The mcp design system extractor mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 6 defined tools rather than through you.

What it actually does

A Model Context Protocol (MCP) server that extracts component information from Storybook design systems. Connects to Storybook instances and extracts HTML, styles, and component metadata.

  • List Components — Get all available components from your Storybook with compact mode
  • Extract HTML — Get the rendered HTML of any component (async or sync mode)
  • Search Components — Find components by name, title, category, or purpose
  • Component Dependencies — Analyze which components are used within other components
  • Theme Information — Extract design system theme (colors, spacing, typography)
  • External CSS Analysis — Fetch and analyze CSS files to extract design tokens

Its toolset

Everything the assistant can do here goes through one of these:

  • query — Search term (use "*" for all)
  • purpose — Find by function ("form inputs", "navigation", "feedback", "buttons", etc.)
  • searchIn — "name", "title", "category", or "all" (default)
  • DEFAULT — Returns only design tokens + file stats (avoids token limits)
  • Security-protected — only accepts URLs from same domain as Storybook
  • Returns — status, result (when completed), error (when failed)

Configuration

You will need 2 environment variables: STORYBOOK_URL, NODE_TLS_REJECT_UNAUTHORIZED. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  • Node.js 20+ - Chrome/Chromium (for Puppeteer) - Running Storybook instance (see below for supported versions)

Adding it to your client

The server ships on npm as mcp-design-system-extractor, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

When to reach for it

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. MCP Design System Extractor's toolset — query, purpose, searchIn and 3 more — is a fair guide to whether it matches your workflow. It is maintained by freema; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against MCP Design System Extractor's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the mcp design system extractor mcp server does with a few real requests.

Available tools

ToolWhat it does
querySearch term (use "*" for all)
purposeFind by function ("form inputs", "navigation", "feedback", "buttons", etc.)
searchIn"name", "title", "category", or "all" (default)
DEFAULTReturns only design tokens + file stats (avoids token limits)
Security-protectedonly accepts URLs from same domain as Storybook
Returnsstatus, result (when completed), error (when failed)

How to install the MCP Design System Extractor MCP server

{
  "mcpServers": {
    "design-system-extractor": {
      "command": "npx",
      "args": ["-y", "mcp-design-system-extractor"],
      "env": {
        "STORYBOOK_URL": "your-value",
        "NODE_TLS_REJECT_UNAUTHORIZED": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • Node.js 20+ - Chrome/Chromium (for Puppeteer) - Running Storybook instance (see below for supported versions)
VariableDescriptionRequired
STORYBOOK_URLEndpoint or connection string the server talks to.Yes
NODE_TLS_REJECT_UNAUTHORIZEDConfiguration value read at startup.Optional

Example prompts to try

  • Use MCP Design System Extractor to query.
  • Use MCP Design System Extractor to purpose.
  • Use MCP Design System Extractor to searchIn.

Frequently asked questions

It connects MCP Design System Extractor to MCP-compatible AI assistants such as Claude and Cursor, exposing 6 tools (query, purpose, searchIn, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with MCP Design System Extractor directly.