{"_id":"ainative-design-system-mcp-server","_rev":"3-5ef63eabc57a7a7be2b6840702fa7b7c","name":"ainative-design-system-mcp-server","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"ainative-design-system-mcp-server","version":"1.0.0","keywords":["mcp","model-context-protocol","design-system","design-tokens","ai","claude","claude-code","components","theming","css","scss","tailwind","styled-components","material-ui","accessibility","wcag","color-palette","typography","spacing"],"author":{"url":"https://ainative.com","name":"AINative","email":"support@ainative.com"},"license":"MIT","_id":"ainative-design-system-mcp-server@1.0.0","maintainers":[{"name":"urbantech","email":"toby@rely.ventures"}],"homepage":"https://github.com/ainative/ainative-design-system-mcp-server#readme","bugs":{"url":"https://github.com/ainative/ainative-design-system-mcp-server/issues"},"bin":{"ainative-design-system-mcp":"build/index.js"},"dist":{"shasum":"a16cdf33afa908a2bd4d41cc1eeb1159f53f07c9","tarball":"https://registry.npmjs.org/ainative-design-system-mcp-server/-/ainative-design-system-mcp-server-1.0.0.tgz","fileCount":39,"integrity":"sha512-XI/SRJUdZGSCjQh7QXle7SSw8aHql0QPoqC193ynUuXzowZ6Yc+5LtCGcssd1sTUrxJX7LTyAmpZULYoRODs2A==","signatures":[{"sig":"MEUCIHbPWZA4F3/XARoxX9630ShEvErJhUEbpCeoOcdPEjqkAiEA43lYfZMYCpeXRoyuoWuf61FW6VN/mnkI1RaK6QDJ0Qc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":180519},"main":"build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"4ca1b01e5f396c4430458b626e5e65232186613c","scripts":{"dev":"tsx src/index.ts","lint":"eslint src/**/*.ts","test":"jest --passWithNoTests","build":"tsc","start":"node build/index.js","format":"prettier --write src/**/*.ts","prepare":"npm run build","postinstall":"echo '✅ AINative Design System MCP Server installed! Run: ainative-design-system-mcp'","prepublishOnly":"npm run build && npm test"},"_npmUser":{"name":"urbantech","email":"toby@rely.ventures"},"repository":{"url":"git+https://github.com/ainative/ainative-design-system-mcp-server.git","type":"git"},"_npmVersion":"10.8.2","description":"AINative Design System MCP Server for Claude Code - Extract design tokens, analyze components, and generate themes","directories":{},"_nodeVersion":"20.19.0","dependencies":{"glob":"^10.3.10","yaml":"^2.3.4","lodash":"^4.17.21","css-tree":"^2.3.1","fs-extra":"^11.1.1","chroma-js":"^2.4.2","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","jest":"^29.0.0","eslint":"^8.0.0","prettier":"^3.0.0","typescript":"^5.0.0","@types/node":"^20.0.0","@types/lodash":"^4.14.202","@types/fs-extra":"^11.0.1","@types/chroma-js":"^2.4.0","@typescript-eslint/parser":"^6.0.0","@typescript-eslint/eslint-plugin":"^6.0.0"},"_npmOperationalInternal":{"tmp":"tmp/ainative-design-system-mcp-server_1.0.0_1755243310840_0.7824842784807213","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"ainative-design-system-mcp-server","version":"1.0.1","keywords":["mcp","model-context-protocol","design-system","design-tokens","ai","claude","claude-code","components","theming","css","scss","tailwind","styled-components","material-ui","accessibility","wcag","color-palette","typography","spacing"],"author":{"url":"https://ainative.com","name":"AINative","email":"support@ainative.com"},"license":"MIT","_id":"ainative-design-system-mcp-server@1.0.1","maintainers":[{"name":"urbantech","email":"toby@rely.ventures"}],"homepage":"https://github.com/AINative-Studio/DesignSystem-MCP#readme","bugs":{"url":"https://github.com/AINative-Studio/DesignSystem-MCP/issues"},"bin":{"ainative-design-system-mcp":"build/index.js"},"dist":{"shasum":"2de1b95200677b745943142a81f9398ab924a2b0","tarball":"https://registry.npmjs.org/ainative-design-system-mcp-server/-/ainative-design-system-mcp-server-1.0.1.tgz","fileCount":39,"integrity":"sha512-nKzH3F88sS8S7fOvkgS1rc1uKlirVtl3KsHDhqMndInZGywCpesW/kZjKfiNa7V6kQURYMQrBzATlXwegjRytg==","signatures":[{"sig":"MEQCICG4b1VH6PR2VHs5nossrS1fKRa0Ufb1GpGVaIrgRqUJAiBWS4yPcsWqLc1HMfsZEvMQQUPOBqc6GJWS2fU9uEctAg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":180489},"main":"build/index.js","type":"module","types":"./build/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"d374b542a5fded86986ba2ced8742ba78e725037","scripts":{"dev":"tsx src/index.ts","lint":"eslint src/**/*.ts","test":"jest --passWithNoTests","build":"tsc","start":"node build/index.js","format":"prettier --write src/**/*.ts","prepare":"npm run build","postinstall":"echo '✅ AINative Design System MCP Server installed! Run: ainative-design-system-mcp'","prepublishOnly":"npm run build && npm test"},"_npmUser":{"name":"urbantech","email":"toby@rely.ventures"},"repository":{"url":"git+https://github.com/AINative-Studio/DesignSystem-MCP.git","type":"git"},"_npmVersion":"10.8.2","description":"AINative Design System MCP Server for Claude Code - Extract design tokens, analyze components, and generate themes","directories":{},"_nodeVersion":"20.19.0","dependencies":{"glob":"^10.3.10","yaml":"^2.3.4","lodash":"^4.17.21","css-tree":"^2.3.1","fs-extra":"^11.1.1","chroma-js":"^2.4.2","@modelcontextprotocol/sdk":"^1.0.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.0.0","jest":"^29.0.0","eslint":"^8.0.0","prettier":"^3.0.0","typescript":"^5.0.0","@types/node":"^20.0.0","@types/lodash":"^4.14.202","@types/fs-extra":"^11.0.1","@types/chroma-js":"^2.4.0","@typescript-eslint/parser":"^6.0.0","@typescript-eslint/eslint-plugin":"^6.0.0"},"_npmOperationalInternal":{"tmp":"tmp/ainative-design-system-mcp-server_1.0.1_1755245034619_0.3045388851776871","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-08-15T07:35:10.724Z","modified":"2025-11-21T00:40:57.936Z","1.0.0":"2025-08-15T07:35:11.036Z","1.0.1":"2025-08-15T08:03:54.795Z"},"bugs":{"url":"https://github.com/AINative-Studio/DesignSystem-MCP/issues"},"author":{"url":"https://ainative.com","name":"AINative","email":"support@ainative.com"},"license":"MIT","homepage":"https://github.com/AINative-Studio/DesignSystem-MCP#readme","keywords":["mcp","model-context-protocol","design-system","design-tokens","ai","claude","claude-code","components","theming","css","scss","tailwind","styled-components","material-ui","accessibility","wcag","color-palette","typography","spacing"],"repository":{"url":"git+https://github.com/AINative-Studio/DesignSystem-MCP.git","type":"git"},"description":"AINative Design System MCP Server for Claude Code - Extract design tokens, analyze components, and generate themes","maintainers":[{"email":"toby@rely.ventures","name":"ainative-studio"}],"readme":"# 🎨 AINative Design System MCP Server\n\n[![npm version](https://badge.fury.io/js/ainative-design-system-mcp-server.svg)](https://badge.fury.io/js/ainative-design-system-mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org/)\n\nA comprehensive Model Context Protocol (MCP) server that provides AI assistants with powerful design system management capabilities. Extract design tokens, analyze components, generate themes, and create comprehensive style guides—all through natural language conversations with Claude Code.\n\n## 🚀 Quick Start\n\n```bash\n# Install globally\nnpm install -g ainative-design-system-mcp-server\n\n# Add to Claude Code\nclaude mcp add ainative-design-system -- ainative-design-system-mcp\n\n# Start using with Claude!\n```\n\n## Features\n\n### 🎨 Design Token Management\n- **Extract design tokens** from CSS, SCSS, Less, Stylus files\n- **Parse CSS variables** and custom properties\n- **Analyze color palettes** and generate variations\n- **Typography scale** detection and optimization\n- **Spacing system** analysis and standardization\n- **Generate token files** in JSON, YAML, JavaScript formats\n\n### 🧩 Component Analysis\n- **Component library scanning** across multiple frameworks\n- **Style extraction** from component files\n- **Prop analysis** and documentation generation\n- **Variant detection** and categorization\n- **Usage pattern** analysis\n\n### 🌈 Theme Management\n- **Multi-theme** support and generation\n- **Dark/light mode** automatic detection\n- **Brand color** extraction and palette generation\n- **Accessibility compliance** checking (WCAG)\n- **Color contrast** analysis and optimization\n\n### 📱 Responsive Design\n- **Breakpoint detection** from CSS and design files\n- **Grid system** analysis and documentation\n- **Component responsiveness** evaluation\n- **Mobile-first** pattern detection\n\n### 🔄 Integration Support\n- **Tailwind CSS** configuration generation\n- **Styled Components** theme creation\n- **Material-UI** theme adaptation\n- **Chakra UI** theme configuration\n- **CSS-in-JS** library integration\n\n## Installation\n\n```bash\nnpm install @ainative/design-system-mcp-server\n```\n\n## Usage\n\n### Claude Desktop Integration\n\nAdd to your Claude Desktop configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"design-system\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/design-system-mcp-server/build/index.js\"],\n      \"env\": {\n        \"DESIGN_SYSTEM_PATH\": \"/path/to/your/design/system\",\n        \"OUTPUT_FORMAT\": \"json\"\n      }\n    }\n  }\n}\n```\n\n### Available Tools\n\n#### 1. Extract Design Tokens\n```typescript\nawait extractDesignTokens({\n  source: \"path/to/styles\",\n  formats: [\"css\", \"scss\", \"less\"],\n  output: \"tokens.json\",\n  categories: [\"colors\", \"typography\", \"spacing\"]\n});\n```\n\n#### 2. Analyze Component Library\n```typescript\nawait analyzeComponentLibrary({\n  source: \"src/components\",\n  framework: \"react\",\n  includeStyles: true,\n  generateDocs: true\n});\n```\n\n#### 3. Generate Theme\n```typescript\nawait generateTheme({\n  baseColors: [\"#3B82F6\", \"#10B981\"],\n  modes: [\"light\", \"dark\"],\n  format: \"tailwind\",\n  accessibility: true\n});\n```\n\n#### 4. Create Component Documentation\n```typescript\nawait createComponentDocs({\n  components: \"src/components/**/*.tsx\",\n  output: \"docs/components\",\n  includeStorybook: true,\n  generateExamples: true\n});\n```\n\n#### 5. Validate Design System\n```typescript\nawait validateDesignSystem({\n  source: \"design-system/\",\n  rules: [\"consistency\", \"accessibility\", \"performance\"],\n  reportFormat: \"detailed\"\n});\n```\n\n## Configuration\n\n### Environment Variables\n\n- `DESIGN_SYSTEM_PATH`: Root path to your design system\n- `OUTPUT_FORMAT`: Default output format (json, yaml, js)\n- `INCLUDE_EXAMPLES`: Include usage examples in output\n- `ACCESSIBILITY_LEVEL`: WCAG compliance level (A, AA, AAA)\n- `FRAMEWORK_SUPPORT`: Supported frameworks (react,vue,angular)\n\n### Configuration File\n\nCreate a `design-system.config.json`:\n\n```json\n{\n  \"tokenCategories\": {\n    \"colors\": {\n      \"primary\": [\"primary\", \"brand\", \"main\"],\n      \"secondary\": [\"secondary\", \"accent\"],\n      \"semantic\": [\"success\", \"error\", \"warning\", \"info\"]\n    },\n    \"typography\": {\n      \"scales\": [\"heading\", \"body\", \"caption\"],\n      \"weights\": [\"light\", \"regular\", \"medium\", \"bold\"]\n    },\n    \"spacing\": {\n      \"scale\": \"modular\",\n      \"base\": 16,\n      \"ratio\": 1.5\n    }\n  },\n  \"breakpoints\": {\n    \"mobile\": 480,\n    \"tablet\": 768,\n    \"desktop\": 1024,\n    \"wide\": 1440\n  },\n  \"accessibility\": {\n    \"contrastRatio\": 4.5,\n    \"wcagLevel\": \"AA\",\n    \"checkFocus\": true\n  }\n}\n```\n\n## Examples\n\n### Extracting Tokens from Figma Design\n\n```typescript\n// Extract design tokens from Figma file\nconst tokens = await extractDesignTokens({\n  source: \"figma://file-key\",\n  categories: [\"colors\", \"typography\", \"spacing\"],\n  format: \"css-variables\"\n});\n\n// Generate Tailwind config\nconst tailwindConfig = await generateFrameworkConfig({\n  tokens,\n  framework: \"tailwind\",\n  includeComponents: true\n});\n```\n\n### Building Component Library Documentation\n\n```typescript\n// Analyze existing components\nconst analysis = await analyzeComponentLibrary({\n  source: \"src/components\",\n  framework: \"react\",\n  includeStyles: true\n});\n\n// Generate comprehensive docs\nconst docs = await createComponentDocs({\n  analysis,\n  format: \"markdown\",\n  includeStorybook: true,\n  generatePlayground: true\n});\n```\n\n### Creating Multi-Theme System\n\n```typescript\n// Extract base colors from brand assets\nconst brandColors = await extractColorsFromImage({\n  source: \"assets/logo.png\",\n  count: 5,\n  accessibility: true\n});\n\n// Generate complete theme system\nconst themes = await generateMultiTheme({\n  baseColors: brandColors,\n  modes: [\"light\", \"dark\", \"high-contrast\"],\n  platforms: [\"web\", \"mobile\", \"desktop\"]\n});\n```\n\n## API Reference\n\n### Core Functions\n\n#### `extractDesignTokens(options)`\nExtract design tokens from various sources.\n\n**Parameters:**\n- `source`: String or array of file paths/URLs\n- `categories`: Array of token categories to extract\n- `format`: Output format (json, yaml, css, scss)\n- `transform`: Apply transformations (kebab-case, camelCase)\n\n**Returns:**\n- `tokens`: Extracted design tokens object\n- `metadata`: Information about source and extraction\n- `validation`: Token validation results\n\n#### `analyzeComponentLibrary(options)`\nAnalyze component library structure and styles.\n\n**Parameters:**\n- `source`: Component directory path\n- `framework`: Target framework (react, vue, angular)\n- `includeStyles`: Include style analysis\n- `depth`: Directory scanning depth\n\n**Returns:**\n- `components`: Component analysis results\n- `patterns`: Detected design patterns\n- `dependencies`: Component dependencies\n- `suggestions`: Optimization suggestions\n\n#### `generateTheme(options)`\nGenerate theme configuration for target framework.\n\n**Parameters:**\n- `baseColors`: Primary colors for theme\n- `modes`: Theme modes (light, dark)\n- `framework`: Target framework\n- `accessibility`: Enable accessibility checks\n\n**Returns:**\n- `theme`: Generated theme configuration\n- `variations`: Color variations and scales\n- `accessibility`: Accessibility compliance report\n- `examples`: Usage examples\n\n### Utility Functions\n\n#### `validateAccessibility(colors)`\nCheck color combinations for WCAG compliance.\n\n#### `generateColorPalette(baseColor, options)`\nGenerate complete color palette from base color.\n\n#### `optimizeTokens(tokens, options)`\nOptimize tokens for performance and consistency.\n\n#### `convertFormat(tokens, targetFormat)`\nConvert tokens between different formats.\n\n## Integration Examples\n\n### With Tailwind CSS\n\n```javascript\nconst tokens = await extractDesignTokens({\n  source: \"design-tokens/\",\n  format: \"tailwind\"\n});\n\n// Generate tailwind.config.js\nconst config = {\n  theme: {\n    colors: tokens.colors,\n    fontFamily: tokens.typography.families,\n    spacing: tokens.spacing\n  }\n};\n```\n\n### With Styled Components\n\n```javascript\nconst theme = await generateTheme({\n  baseColors: tokens.colors.primary,\n  format: \"styled-components\"\n});\n\n// Use in styled-components\nconst Button = styled.button`\n  background: ${props => props.theme.colors.primary};\n  color: ${props => props.theme.colors.onPrimary};\n`;\n```\n\n### With Material-UI\n\n```javascript\nconst muiTheme = await generateTheme({\n  tokens,\n  framework: \"material-ui\",\n  mode: \"light\"\n});\n\n// Apply to MUI theme\nconst theme = createTheme(muiTheme);\n```\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Development mode\nnpm run dev\n\n# Build\nnpm run build\n\n# Test\nnpm test\n\n# Lint\nnpm run lint\n```\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests for new functionality\n5. Ensure all tests pass\n6. Submit a pull request\n\n## License\n\nMIT License - see LICENSE file for details.\n\n## Support\n\n- 📧 Email: support@ainative.com\n- 🐛 Issues: [GitHub Issues](https://github.com/ainative/design-system-mcp-server/issues)\n- 📖 Documentation: [Full Documentation](https://docs.ainative.com/mcp/design-system)\n- 💬 Community: [Discord](https://discord.gg/ainative)","readmeFilename":"README.md"}