🎨 Colors MCP Server

npm license

A simple color utility MCP server for frontend developers. Convert, mix, adjust, and analyze colors right from your AI agents.

This MCP server provides a streamlined set of color utilities designed for efficiency and precision. It focuses on delivering core color manipulation tools in a straightforward, lightweight package for modern development workflows.

Tools

Tool	Description
`colors_convert`	Convert a color to a different color space
`colors_batch_convert`	Convert multiple colors to a target color space at once
`colors_parse`	Parse and validate a color string
`colors_adjust`	Adjust color properties (lightness, chroma, hue)
`colors_batch_adjust`	Batch adjust multiple colors (lightness, chroma, hue)
`colors_mix`	Mix two colors with perceptual interpolation
`colors_scale`	Generate a perceptually uniform color scale
`colors_difference`	Calculate color difference (Delta E) between two colors
`colors_batch_difference`	Batch calculate color difference (Delta E) against a target color
`colors_contrast`	Check WCAG contrast ratio between foreground and background colors
`colors_batch_contrast`	Batch check WCAG contrast ratio for multiple foregrounds against a background

Setup

Add the server to your MCP client config (e.g. Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "colors": {
      "command": "npx",
      "args": ["-y", "@htetoowaiyan/colors-mcp-server"]
    }
  }
}

Development

git clone https://github.com/HtetOoWaiYan/colors-mcp-server.git
cd colors-mcp-server
npm install

npm run dev          # Run with tsx (hot reload)
npm run build        # Build for production
npm test             # Run tests
npm run test:watch   # Run tests in watch mode

Built With

Model Context Protocol SDK — MCP server framework
Culori — Color conversion and manipulation
Zod — Input validation
Vitest — Testing
Biome — Linting & formatting

License

MIT

Colors MCP Server