Skip to main content
Glama
Sign In
aesthetics-mcp

aesthetics-mcp

by InfiniteInsight
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

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: Design Style MCP Server

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Design Style MCP Server

      luminarylane
      A
      license
      A
      quality
      B
      maintenance
      Provides deterministic design style recommendations and structured tokens for AI content generation, with 30 curated styles including color palettes, typography, and visual directives.
      2
      12 npm
      MIT

    • October Themes MCP Server

      october-dev
      A
      license
      A
      quality
      D
      maintenance
      Provides 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.
      2
      11 npm
      1
      MIT