Aesthetics

FreeNot checked

Provides Claude with queryable knowledge of 300+ visual aesthetics from the Aesthetics Wiki and enables turning that knowledge into design tokens, Tailwind conf

by InfiniteInsight

GitHub Embed

About

Provides Claude with queryable knowledge of 300+ visual aesthetics from the Aesthetics Wiki and enables turning that knowledge into design tokens, Tailwind configs, and design briefs.

README

A Model Context Protocol server that gives Claude knowledge of 1135+ named visual aesthetics from the Aesthetics Wiki. Use it to generate CSS tokens, Tailwind configs, design briefs, and UI components grounded in real aesthetic traditions.

Prerequisites

Node.js 18+
Claude Code (CLI, desktop app, or IDE extension)

Install

git clone https://github.com/InfiniteInsight/aesthetics-mcp.git
cd aesthetics-mcp
npm install
npm run setup

Then restart Claude Code. The MCP server and aesthetics skill are now active.

The database ships pre-scraped and pre-embedded — no scraping or model download needed on first run. The embedding model (~23MB) downloads on the first suggest_aesthetics call.

Usage

The skill activates automatically on design-related requests. You can also trigger it directly:

Intent	Example
Named aesthetic	"make it Vaporwave"
Vibe description	"dark moody academic candlelight"
Project description	"a meditation app, calm but not clinical"
Random inspiration	"pick a random aesthetic for me"
Color-first	"find aesthetics that use black and gold"
Explore	"what aesthetics are related to Dark Academia?"

MCP Tools

Tool	Description
`get_aesthetic`	Full details + wiki text for a named aesthetic
`search_aesthetics`	FTS keyword search across all 1135+ aesthetics
`suggest_aesthetics`	Semantic similarity search from a project description
`list_aesthetics`	Browse all aesthetics, optionally filtered by category
`random_aesthetic`	Random pick, optionally filtered by category
`search_by_color`	Find aesthetics by color name (e.g. "burgundy", "earth tones")
`list_categories`	All 66 distinct aesthetic categories
`find_related`	Resolve an aesthetic's related/adjacent neighbors
`check_db_staleness`	How recently the database was last scraped

Re-scraping

The bundled database was scraped in June 2026. To refresh it:

npm run scrape                        # re-scrapes all 1135 aesthetics (~30 min)
node src/db/migrate-embeddings.js     # re-computes semantic embeddings (~5 min)

Development

npm test          # run all 63 tests
npm run setup     # re-run after pulling changes to update skill + MCP path

from github.com/InfiniteInsight/aesthetics-mcp

Install Aesthetics in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install aesthetics-mcp

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add aesthetics-mcp -- npx -y github:InfiniteInsight/aesthetics-mcp

FAQ

Is Aesthetics MCP free?

Yes, Aesthetics MCP is free — one-click install via Unyly at no cost.

Does Aesthetics need an API key?

No, Aesthetics runs without API keys or environment variables.

Is Aesthetics hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Aesthetics in Claude Desktop, Claude Code or Cursor?

Open Aesthetics on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

LibreOffice Tools

Enables AI agents to read, write, and edit Office documents via LibreOffice with token-efficient design. Supports multiple formats including DOCX, XLSX, PPTX, a

by passerbyflutter

dannote/figma-use

Full Figma control: create shapes, text, components, set styles, auto-layout, variables, export. 80+ tools.

by dannote

Logo.dev

Search and retrieve company logos by brand or domain. Customize size, format, and theme to match your design needs. Accelerate design, prototyping, and content

by NOVA-3951

PIX4Dmatic

Enables GUI automation for controlling PIX4Dmatic on Windows through MCP. Supports launching, focusing, capturing screenshots, sending hotkeys, clicking UI elem

by jangjo123

Compare Aesthetics with

AestheticsvsLibreOffice Tools Aestheticsvsdannote/figma-use AestheticsvsLogo.dev AestheticsvsPIX4Dmatic

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All design MCPs