aesthetics-mcp
Provides queryable knowledge of 300+ visual aesthetics from the Aesthetics Wiki on Fandom, with tools for search, retrieval, listing, and suggestion of aesthetics for design projects.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@aesthetics-mcpSuggest aesthetics for a dark fantasy video game"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
aesthetics-mcp
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)
Related MCP server: figma-mcp-server
Install
git clone https://github.com/InfiniteInsight/aesthetics-mcp.git
cd aesthetics-mcp
npm install
npm run setupThen 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 |
| Full details + wiki text for a named aesthetic |
| FTS keyword search across all 1135+ aesthetics |
| Semantic similarity search from a project description |
| Browse all aesthetics, optionally filtered by category |
| Random pick, optionally filtered by category |
| Find aesthetics by color name (e.g. "burgundy", "earth tones") |
| All 66 distinct aesthetic categories |
| Resolve an aesthetic's related/adjacent neighbors |
| 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 pathThis server cannot be deployed
Maintenance
Related MCP Connectors
Give your agent a real design system: tokens, measured WCAG contrast, and rules to follow.
A design-style library for AI agents: search real styles, fetch a ready-to-apply design spec.
Serves your design system and coding standards to coding agents, so they stop guessing.
- mcpOAuthio.styleforge
Brand-aware creative studio for Claude: 200+ tools for on-brand ads, video, email and campaigns.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceNative Claude Code integration for @annondeveloper/ui-kit — a zero-dependency React component library with 147 components, 3 weight tiers, physics-based animations, and OKLCH color system. Gives Claude deep awareness of the library's components, design patterns, and conventions. Includes 5 skills for component discovery, code generation, design system reference, tier selection, and accessibility14 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables Claude to interact with Figma designs, convert designs to code, extract variables, get screenshots, and more.1-
- AlicenseAqualityAmaintenanceProvides deterministic design style recommendations and structured tokens for AI content generation, with 30 curated styles including color palettes, typography, and visual directives.211 npmMIT
- AlicenseAqualityCmaintenanceProvides 1000+ handcrafted design system themes (colors, typography, components, animations) to inject into AI-generated UI, enabling tools like Claude, ChatGPT, and Cursor to produce polished, non-generic interfaces.26 npm1MIT