DesignOS-MCP

What is DesignOS?

DesignOS is an MCP server and SDK that gives AI agents structured design research, visual intelligence, design-system knowledge, reusable references, and production-oriented design workflows.

Instead of an AI coding agent searching the web blindly or inventing generic UI, DesignOS gives it a searchable design intelligence layer.

Related MCP server: @dsk/mcp

Why DesignOS?

AI coding agents are strong at implementation but often lack:

• persistent design knowledge;

• structured visual research;

• design reference discovery;

• component intelligence;

• motion intelligence;

• design memory;

• consistent visual QA;

• reusable production workflows.

DesignOS provides that missing layer.

What It Can Do

How It Works

flowchart LR
    Agent[Your AI Agent] -->|MCP| MCP_Interface[DesignOS]
    
    subgraph DesignOS
        Router[Source Router]
        Vault[Design Vault]
        Cache[Semantic Cache]
        Craft[Craft]
        DNA[Design DNA]
        QA[Visual QA]
        Prod[Production Tools]
    end

    MCP_Interface --> Router
    MCP_Interface --> Vault
    Router --> Sources[Design Ecosystem]

Works With

• Codex

• Claude Code

• Cursor

• Gemini CLI

• OpenHands

• any compatible MCP client

Design intelligence from hundreds of sources

We have registered and verified 270+ design sources covering:

Component Libraries • Design Inspiration • Product UI • Mobile UX • Motion • 3D / WebGL • Design Systems • Typography • Branding • Ecommerce • Email • Data Visualization • No-code / Webflow / Framer

Representative Examples: shadcn/ui • Aceternity • Magic UI • Mobbin • SaaSFrame • Awwwards • Godly • GSAP • Motion • Three.js • Spline • Relume

See the complete source registry →

Quick Start

git clone https://github.com/Razepriv/DesignOS-MCP.git
cd DesignOS-MCP
pnpm install
pnpm designos:setup
pnpm designos:doctor

Then start the server:

pnpm dev

MCP Configuration Example

To use DesignOS in Cursor or Claude, configure your MCP settings:

{
  "mcpServers": {
    "designos": {
      "command": "node",
      "args": ["/absolute/path/to/DesignOS-MCP/packages/mcp/dist/index.js"]
    }
  }
}

See full MCP setup instructions →

Example AI Agent Requests

• "Find modern SaaS dashboard references with restrained motion."

• "Analyze this screenshot and identify its layout, typography and spacing system."

• "Find React components suitable for recreating this interaction."

• "Research premium onboarding patterns for a fintech mobile app."

• "Extract Design DNA from these three reference URLs."

• "Compare these hero directions and explain the structural differences."

• "Find motion references that can be implemented using GSAP."

• "Create a design research pack for this PRD."

MCP Tools

Architecture & Caching

Built to avoid repeated work, DesignOS utilizes Token & Cache Efficiency:

• Exact Cache & Semantic Cache

• Design Vault (Persistent knowledge layer)

• Caveman Compression & Progressive Retrieval

• Token Governor

Read the full Architecture Guide →

Design intelligence, not UI copying

DesignOS does not blindly scrape or copy websites. The pipeline relies on fundamental understanding: Reference → Inspect → Understand → Extract Design DNA → Apply project requirements → Create original direction

Open Design Integration

DesignOS can selectively interoperate with Open Design through a compatibility layer. DesignOS does not blindly embed or fork Open Design. Compatible permissively licensed skills, craft references, templates, design systems, frames, and plugin metadata can be imported through the upstream compatibility layer.

Read about Open Design Integration →

Roadmap & Status

Contributing

DesignOS is designed to grow through new sources, adapters, craft rules, integrations, and production capabilities. Possible contribution areas:

• new source adapters;

• design source registry entries;

• craft rules;

• MCP tools;

• browser integrations;

• tests;

• docs;

• production pipelines.

Read the Contribution Guide →

License & Security

DesignOS-MCP is licensed under the Apache License 2.0. Third-party sources, plugins, design systems, and imported assets may have their own licenses. DesignOS preserves provenance and does not treat third-party content as automatically redistributable.

• LICENSE

• Security Policy