design system analyzer.com
design system analyzer.com logo

Design System Analyzer

Analyzes React component files and design tokens to provide accurate component properties and styling information for pr...

Created byApr 23, 2025

MCP Server for Design System

This project includes an MCP (Model Context Protocol) server that provides information about component props and design tokens.

MCP Server Features

The MCP server offers two main tools:
  • `getComponentProps`: Retrieves information about component properties
  • `getTokens`: Retrieves design token information from token files

Debugging the MCP Server

To debug the MCP server:
  1. Run the in-memory debug script:
This script:
  • Creates an in-memory client-server connection
  • Makes sample calls to retrieve component props and tokens
  • Displays the results in the console
You can modify the debug script to test different components or specific token requests.

Design Token Generation

Design tokens are stored as JSON files in the `src/design-system/tokens` directory:
  • `color.json`: Color palette and theme colors
  • `typography.json`: Font families, sizes, weights
  • `spacing.json`: Spacing scale
  • `radius.json`: Border radius values

Token Generation Process

Tokens are processed using [Style Dictionary](https://amzn.github.io/style-dictionary/#/) with the following workflow:
  1. Define token values in JSON files in the `tokens` directory
  1. Style Dictionary processes these tokens according to the configuration in `src/design-system/style-dictionary/config.json`
  1. Output formats include: - CSS variables (tokens.css) - JavaScript module (tokens.js) - TypeScript declarations (tokens.d.ts)
To generate tokens:
The generated files are placed in the `src/design-system/style-dictionary/dist` directory and can be imported into your components.