Colors 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