aesthetics-mcp

MCP server for 300+ visual aesthetics from the Aesthetics Wiki.

Gives Claude queryable knowledge of named internet aesthetics (Vaporwave, Cottagecore, Dark Academia, etc.) and a workflow for turning that knowledge into design tokens, Tailwind configs, and design briefs.

Install

npm install -g aesthetics-mcp

The database (~11MB, 1100+ aesthetics) is bundled — no scraping needed to get started.

Related MCP server: Optics MCP Server

Refresh the database

Configure Claude Code

Add to ~/.claude/mcp.json:

{
  "mcpServers": {
    "aesthetics": {
      "command": "aesthetics-mcp"
    }
  }
}

Configure Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "aesthetics": {
      "command": "aesthetics-mcp"
    }
  }
}

Install the companion skill

mkdir -p ~/.claude/skills/aesthetics
cp skills/aesthetics.md ~/.claude/skills/aesthetics/SKILL.md

Then use /aesthetics or just describe what you want — the skill auto-triggers on aesthetic requests.

Update the database

# Re-scrape pages older than 30 days
aesthetics-scrape refresh

# Re-scrape one aesthetic
aesthetics-scrape aesthetic "Vaporwave"

# Custom database path
aesthetics-scrape full --db /path/to/aesthetics.db
AESTHETICS_DB_PATH=/path/to/aesthetics.db aesthetics-mcp

MCP Tools

Content license

Aesthetic data is sourced from the Aesthetics Wiki and licensed under CC BY-SA 3.0. This package redistributes that content in database form under the same license.