Random Design
Generate randomized English Markdown frontend design directions from curated catalogs.
Open source Open in the app JSON README (API)
About
Generate randomized English Markdown frontend design directions from curated catalogs.
Details
- Kind
- MCP servers
- Topic
- Files & documents
- Publisher
- yanislav-igonin
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 2.1.0
- Last push
- 2026-06-05T10:04:34Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 04:01:42
- Updated
- 2026-08-29 04:01:42
- Origin id
io.github.yanislav-igonin/random-design-mcp
README
# Random Design MCP
TypeScript MCP server that returns randomized English Markdown frontend design
directions. It uses curated catalogs and optional soft compatibility scoring. It
does not call an LLM.
Website: https://random-design-mcp.h0b0.dev
## Install
Use the published npm package from any MCP client that supports stdio servers:
```json
{
"mcpServers": {
"random-design": {
"command": "npx",
"args": ["-y", "random-design-mcp"]
}
}
}
```
## Tools
`generate_design_description` returns one randomized Markdown design direction.
All input fields are optional, but passing context makes the result easier to
use:
```ts
{
productType?: string;
audience?: string;
priority?: string;
compatibility?: boolean; // defaults to true
}
```
- `productType`: what you are designing, such as `landing page`, `dashboard`,
`mobile app`, or `pricing page`.
- `audience`: who the interface is for, such as `developers`, `founders`, or
`enterprise buyers`.
- `priority`: what the design should optimize for or pay extra attention to,
such as `conversion`, `readability`, `premium feel`, `dense data display`, or
`playful experimentation`.
- `compatibility`: controls how wild the random combination can be. It defaults
to `true`, which keeps generated parameters more coherent and practical. Set
it to `false` for unconstrained combinations that can intentionally mix
clashing eras, styles, palettes, layouts, and materials.
`get_version` takes no arguments and returns the package version from
`package.json`. Use it to confirm which published or cached MCP package version
an MCP client is running.
## Development
```bash
npm install
npm run build
npm run check
```
Preview one generated design direction locally:
```bash
npm run dev
```
Optional preview context:
```bash
RANDOM_DESIGN_PRODUCT_TYPE="Landing page" \
RANDOM_DESIGN_AUDIENCE="Developers" \
RANDOM_DESIGN_PRIORITY="Conversion" \
RANDOM_DESIGN_COMPATIBILITY=false \
npm run dev
```