PlugWiki
color-space logo

Color Space MCP Server: Setup for Claude, Cursor and Other Apps

CommunityLocal
Getnpmcolor-spacecolorjs/color-space

Lets Claude, Cursor and other assistants convert colors between 221 color spaces with tested math instead of guesses.

Color Space is a color conversion library that also ships an MCP server. Its tools convert a color between any two of 221 color spaces and check which display gamut holds it. They can also write CSS strings, shader code, LUT files and ICC profiles. It runs on your computer with no account or API key. The README says it exists because language models get color math wrong in the third decimal.

Good for

  • Designers who need exact conversions to OKLCH, Display P3 or Lab
  • Front-end developers who want CSS color strings and gamut checks
  • Video and graphics people who need LUTs, ICC profiles or shader code

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install color-space MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the color-space MCP server to Claude Code. Run this command:
    
    claude mcp add color-space -- npx -y color-space mcp
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

Read-only mode: Every tool is read-only, so there is nothing to switch off.

The command ends in mcp, which starts the server. The plain color-space command on its own is a conversion tool for the terminal, not the MCP server. No account or key is needed.

From the project README. Source.

Tools

  • Converts a color, or a batch of colors, between any two spaces

    Takes a color as a CSS string or channel values and returns it in another space, using that space's normal ranges. It flags channels that fall outside the target's range and does not clamp them. A batch of up to 1,024 colors works too.

    Try: “Convert #ff8000 to OKLCH.”

    Read · convert

  • Writes a color as ready-to-paste CSS strings

    Returns the color as CSS strings such as rgb(), hsl(), lab(), oklch() and color(display-p3 ...), plus a hex code when it fits sRGB. A string comes back empty where CSS would clamp the color into a different one.

    Try: “Give me CSS strings for oklch(0.7 0.1 50), including Display P3.”

    Read · css

  • Checks whether a color fits sRGB, Display P3 or Rec. 2020

    Tests a color against sRGB, Display P3 and Rec. 2020 and reports the smallest one that holds it. It only checks membership and does not map the color into a smaller gamut.

    Try: “Is color(display-p3 1 0.5 0) inside sRGB?”

    Read · gamut

  • Explains one color space: channels, ranges and sources

    Returns the display name, description, channels with their usual ranges, defining references, year and author, illuminant and observer, and the spaces it converts to directly.

    Try: “Tell me about the OKLCH color space and where it comes from.”

    Read · space

  • Searches the catalog of 221 color spaces

    Lists the available color spaces and can filter by a search phrase, family or purpose, with the best matches first.

    Try: “Which color spaces are used for camera log footage?”

    Read · spaces

  • Builds a .cube LUT file for a conversion

    Produces a .cube lookup table that works in Resolve, Premiere, Final Cut, OBS or ffmpeg. The header carries the measured deviation from the direct conversion, and the lattice size is limited to 33 here.

    Try: “Make a .cube LUT that converts S-Log3 to Rec. 709.”

    Read · cube

  • Writes a color conversion as GLSL, WGSL, HLSL or MSL code

    Returns shader code for a conversion in GLSL, WGSL, HLSL or Metal, with an entry function named after the two spaces and every helper on the path. HLSL and MSL need the optional naga-wasm package installed next to it.

    Try: “Write a GLSL function that converts RGB to OKLCH.”

    Read · shader

  • Exports a color space as an ICC profile

    Returns one color space as an ICC v2 profile, encoded in base64. It uses a matrix and tone curve for RGB working spaces and a lookup table for others.

    Try: “Export Display P3 as an ICC profile.”

    Read · icc

  • Shows the library call for a conversion and a Python equivalent

    Returns the color-space JavaScript call with its result and, where one exists, the matching colour-science Python code checked against color-space, with any known caveat.

    Try: “Show me the code to convert sRGB 200, 100, 50 to CIELAB in JavaScript and Python.”

    Read · code

Read from the source code

Permissions

low risk · 2 things to watch

Low risk

All nine tools are marked read-only and only return converted colors or generated files as text. No special precautions are needed.

What it can do

Watch out for

  • Out-of-range colors are not clamped

    A converted color can fall outside the target space's range, and the result flags each channel instead of fixing it. Check the range flag before using a color in a design. github.com

  • HTTP mode listens on localhost

    The optional HTTP mode binds to 127.0.0.1 by default. Leave it on that address unless you add your own protection. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Turning on read-onlyEvery tool is marked read-only in the server source, so there is nothing to switch off.
Sign-in and keysNo credentials needed.

Questions

Does Color Space MCP need an API key?

No. It runs on your computer with no account, sign-in or API key. The npm package is CC0 licensed, which means public domain.

What color formats can I give it?

Any CSS color string such as #ff8000, rebeccapurple, oklch(0.7 0.1 50) or color(display-p3 1 0.5 0), or channel values with a space name.

Why use it instead of asking the AI to convert colors?

The project says models produce plausible but slightly wrong matrices. The server calls the library, which tests each conversion against a cited reference, so the numbers are computed, not guessed.

Is it the same as the color-space npm library?

It is part of it. The package is a color conversion library, and the MCP server is one command of it. The page you are reading covers only the MCP server.

Can it run in Docker or over HTTP?

Yes to both. The README documents building a Docker image and a localhost HTTP mode. The install box above uses the simpler npx command.

Is there a Claude Code plugin?

Yes. The README gives a plugin that adds the server plus a skill, installed from the project's marketplace.

Information

updated Nov 2, 2026

Publisher
Community
Package
color-space
Registry
npm
Transport
stdio, Streamable HTTP
Auth
None
Version
3.5.0
License
CC0-1.0
Last commit
Oct 29, 2026
Open issues
0
Listed in
Official MCP registry

WebsiteGitHubnpmOfficial MCP RegistryChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 2
  1. color-space README, Agents section · github.com
  2. color-space MCP server source · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.