aesthete-agent MCP server
Expose the aesthete-agent color engine as MCP tools — usable from Claude Desktop, Cursor, and any MCP client.
Run
uvx --from "git+https://github.com/docsor1212/aesthete-agent#subdirectory=mcp" aesthete-agent-mcp
Or with a local FastMCP environment: python mcp/server.py (stdio).
Tools
| Tool | What it does |
|---|---|
palette_match(brief, limit, no_flags) |
Rank the 89-palette evidence library for a natural-language brief (register auto-detect + learned preferences) |
palette_harmony(base, mode, theme) |
OKLCH harmony generation (7 rules × light/dark) |
palette_score(palette) |
5-dimension scorecard /20 with P0-P3 findings |
palette_contrast(fg, bg, method) |
WCAG ratio or APCA Lc (WCAG 3 draft) for one pair |
palette_matrix(palette, method, recommend) |
Full pairwise matrix + best-pair recommendation |
palette_blind(palette) |
Protanopia/deuteranopia/tritanopia simulation with collision flags |
palette_semantic(count, base) |
Color-blind-safe categorical colors for charts |
palette_themes() / palette_theme(name) |
Named theme packs → CSS tokens |
palette_export(palette, fmt) |
css / tailwind / json / svg / w3c (Design Tokens) / context (LLM-ready) |
palette_slop(palette) |
AI-slop signature detection (median-trap hexes, purple gradients, flat lightness) |
Client config (Claude Desktop example)
{
"mcpServers": {
"aesthete-agent": {
"command": "uvx",
"args": ["--from", "git+https://github.com/docsor1212/aesthete-agent#subdirectory=mcp", "aesthete-agent-mcp"]
}
}
}
Zero keys, zero telemetry. The engine runs fully offline; only palette_*_extract-style image tools require Pillow (not exposed here).
Self-check
python mcp/server.py --check # engine selftest + fastmcp availability
1 maintainer
Metadata
1 maintainer
Release files for aesthete-agent-mcp 0.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aesthete_agent_mcp-0.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Release files / aesthete_agent_mcp-0.5.0-py3-none-any.whl
| Download URL | aesthete_agent_mcp-0.5.0-py3-none-any.whl |
|---|---|
| Size | 42.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
067600cff7afe199e923408895d36c7ce20b4c45ec075ce21238ec93c1ab58c7
|
|
BLAKE2b-256 checksum How to use checksums |
c5ad956820afd146d23753e0b5ee413e92556756e48cab67185bff223050e4ce
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.6
|
