# color-space

> color-space is an open-source MCP server for design and media. Convert colors across 221 color spaces, with gamut checks, CSS parsing and LUT export. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Web, self-hosted
- **Website:** https://color-space.io
- **Repository:** https://github.com/colorjs/color-space
- **MCP Registry name:** io.github.colorjs/color-space
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-15

## About

Color-space is first a JavaScript library of 221 interconnected color spaces, from sRGB, Display P3 and OKLCH to camera log encodings, video YCbCr variants and colorimetry research spaces. The MCP server is its command mode, started with npx, so an agent can call checked conversion math rather than guessing it.

The README says formulas are tested against cited sources and lists errata found in them. Colors go in as any CSS string, such as a hex value, an oklch() expression or a named color, or as raw channel values. Beyond converting, the tools generate shader code in GLSL, WGSL, HLSL or MSL, produce .cube LUTs and ICC profiles, and show the JS call that matches a given conversion. A stateless Streamable HTTP mode is also available.

The same package ships a WebAssembly build, GLSL shaders, OpenColorIO configs, and utilities for mixing, deltaE, WCAG contrast and color-vision simulation. It is free and public domain according to the atlas site.

## Features

- **221 color spaces:** Converts between any two spaces in the collection.
- **Cited formulas:** Conversions are tested against cited sources, with errata documented.
- **CSS string input:** Accepts hex, oklch() and named colors as well as channel values.
- **Shader generation:** Writes the conversion as GLSL, WGSL, HLSL or MSL.
- **LUT and ICC output:** Produces .cube LUTs and ICC profiles.
- **Gamut checks:** Includes a gamut tool for out-of-range colors.

## Good for

- Convert a CSS color to OKLCH or Display P3 with verified math
- Generate a shader function for a color conversion
- Build a .cube LUT for grading in Resolve or Premiere
- Check whether a color fits a target gamut
- Map camera log footage values to a wide gamut space

## Install

### Claude Code (Terminal)

```sh
claude mcp add color-space -- npx -y color-space
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "color-space": {
      "command": "npx",
      "args": [
        "-y",
        "color-space"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "color-space": {
      "command": "npx",
      "args": [
        "-y",
        "color-space"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "color-space": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "color-space"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "color-space": {
      "command": "npx",
      "args": [
        "-y",
        "color-space"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "color-space": {
      "command": "npx",
      "args": [
        "-y",
        "color-space"
      ]
    }
  }
}
```

## Tools

- `convert`: Converts a color between color spaces.
- `gamut`: Checks a color against a gamut.
- `css`: Handles CSS color strings.
- `space`: Describes one color space.
- `spaces`: Lists available color spaces.
- `cube`: Generates .cube LUTs.
- `shader`: Writes a conversion as GLSL, WGSL, HLSL or MSL.
- `icc`: Generates ICC profiles.
- `code`: Gives the JS call and its verified colour-science equivalent.

## FAQ

### How do I start the MCP server?

Run npx -y color-space mcp, or add it to Claude Code with claude mcp add color-space -- npx -y color-space mcp.

### Can it run over HTTP?

Yes, a stateless Streamable HTTP mode starts with npx -y color-space mcp --http and a port number.

### How many color spaces are covered?

221, grouped into display, cylindrical, perceptual, colorimetry, video, camera and print families.

### Is it free?

Yes. The atlas site describes it as free and public domain.

### Is color-space free?

Yes. color-space is open source, so you can use and self-host it for free.

### How do I add color-space to Claude Code?

Run this command in your terminal: claude mcp add color-space -- npx -y color-space

### What are the best alternatives to color-space?

The closest alternatives to color-space are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/color-space
