MCP.Market

Color Engine MCP server

by aimsise·io.github.aimsise/color-engine-mcp·v1.0.1·1 stars
No reviews yet

Six pure, in-memory CSS color tools: parse, convert, WCAG/APCA contrast, gamut map, ramps, solver

B78/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B78/100

full report

Adoption
New

1 stars50 downloads/wk

Reviews

Write one

Nobody has reviewed Color Engine yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Color Engine tools (6)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • contrast

    Compute the WCAG 2.1 contrast ratio between two fully opaque CSS color strings and return WCAG tier flags (AA/AAA normal/large text). Set apca:true to also get the signed APCA-W3 Lc for text `a` over background `b`.

  • convert_color

    Convert a CSS color string into a canonical hex, rgb, hsl, or oklch format string.

  • gamut_map

    Map any CSS color string into the sRGB gamut via perceptual OKLCH chroma reduction. Returns the nearest in-gamut hex, raw OKLCH components, and a `clamped` flag indicating whether the input was out-of-gamut.

  • generate_ramp

    Generate a tint-to-shade color ramp from a base CSS color. Returns an ordered list of swatches (light → dark) each with its in-gamut hex, display-rounded OKLCH components (l/c 5dp, h 2dp), WCAG contrast ratios (2dp) + tiers vs white and black, and an in-gamut flag. Optionally emits the ramp as design tokens via tokenFormat ("tailwind" JSON or a "css-variables" :root block).

  • parse_color

    Parse a CSS color string and return hex, rgb, oklch, and gamut info.

  • solve_for_contrast

    Find a foreground color that meets one or more WCAG 2.1 contrast targets against a background. Binary-searches OKLCH lightness (holding hue/chroma fixed) and returns the nearest-compliant hex plus the achieved ratio. Pass `target` for one target or `targets` for several; `prefer` selects lighter/darker/either; `hue`/`chroma` pin the foreground chromaticity.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan47 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 108 days ago8/15
  • Maintainer identityregistry namespace matches repository owner6/10
Overall 78/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Color Engine compares

Against every graded Maps and travel MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
78/100
higher than 67% of 681 Maps and travel servers
Tools
6
the typical Maps and travel server has 6
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
1
more than 65% of 324 Maps and travel servers
Downloads a week
50
more than 43% of 150 Maps and travel servers with a package

What its tools let an agent do: 5 read · 1 create

Install Color Engine in Claude Code, Cursor or VS Code

Runs npx -y color-engine-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add color-engine-mcp -- npx -y color-engine-mcp
Add to Cursor

What the publisher says

From the Color Engine repository's README, as published. We do not edit it. Read it on GitHub

color-engine MCP Server

A Model Context Protocol (MCP) server providing 6 CSS color utilities: parsing, conversion, gamut mapping, WCAG contrast (with optional APCA), tint/shade ramp generation (with optional design-token output), and contrast-target solving. All tools operate purely in-memory — no network I/O, no filesystem writes.

All JSON outputs shown in this README are genuine responses captured from the built server via the MCP Inspector CLI (npx @modelcontextprotocol/inspector --cli).

Installation

Requires Node.js >= 20. The npm package exposes a color-engine-mcp bin, so no clone or build is needed — clients launch it via npx. This is a standard stdio MCP server using only the tools primitive, so any MCP-compatible client registers it the same way: point the client at the launch command, and the client spawns and manages the process itself.

For Claude Code, one command registers the server:

claude mcp add color-engine -- npx -y color-engine-mcp

(The default scope is the local project; add --scope user to register it for all your projects, or --scope project to write the shared .mcp.json.)

Most other JSON-configured clients accept this shape verbatim:

{
  "mcpServers": {
    "color-engine": {
      "command": "npx",
      "args": ["-y", "color-engine-mcp"]
    }
  }
}

Where the entry lives in a few common clients:

Other clients (Zed, JetBrains, custom agents built on an MCP SDK, …) differ only in the file location and occasionally the top-level key name — see their MCP server registration docs.

Listed in the official MCP Registry as io.github.aimsise/color-engine-mcp.

Once connected, try asking your agent things like:

  • "Generate an 11-step Tailwind ramp from #3b82f6"
  • "Find an accessible text color for background #1e293b at 4.5:1 contrast"

To run from a clone instead, see Development.

Color input handling

Every tool routes color strings through one shared parse boundary, so the rules below apply uniformly.

Accepted formats. Any CSS color string culori can parse, including named colors, hex (#rgb, #rgba, #rrggbb, #rrggbbaa), rgb()/rgba(), hsl()/hsla(), and oklch() — plus the wide-gamut / CSS Color 4 formats:

  • color(display-p3 r g b)
  • lab(L a b) / lch(L C h)
  • oklab(L a b)
  • hwb(h w b)
  • color(rec2020 r g b)
  • color(a98-rgb r g b)
  • color(xyz-d65 x y z)

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Color Engine: common questions

Is Color Engine MCP server safe?
Mostly: it is graded B (78/100). Read the Color Engine safety report
How do I install Color Engine?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Color Engine need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Color Engine maintained?
The last commit was 146 days ago (2026-06-11). The latest release is v1.0.1.
What can I use instead of Color Engine?
Servers from other publishers that do the same job: Mapnetwork MCP server, geo-score MCP server and Repo Graph MCP server.
How does Color Engine compare with other Maps and travel MCP servers?
safety score 78/100 (higher than 67% of 681 Maps and travel servers); tools 6 (the typical Maps and travel server has 6); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Color Engine

Same job from other publishers: the closest match first, then the best rated.

  • Mapnetwork
    Generate styled PNG/SVG map images of places in Japan with 11 customizable color themes.
    A
  • geo-score
    Free 0-100 score: can AI engines cite a site? Plus citation checks with your own API keys.
    B
  • Repo Graph
    Structural graph map of any codebase so LLMs navigate by structure, not guesswork.
    A
  • Decodo
    Enable your AI agents to scrape and parse web content dynamically, including geo-restricted sites
    A
  • Agentmap
    The TS/JS-accurate repo map for coding agents: ts-morph import/symbol/call graph + MCP query tools
    A