home / mcp / color converter mcp server
A comprehensive Model Context Protocol (MCP) server for color conversion, manipulation, analysis, and accessibility, designed for AI coding agents and assistants. This server provides a complete color toolkit for design systems, web development, and accessibility compliance using the `colorizr` library.
Configuration
View docs{
"mcpServers": {
"bennyzen-mcp-color-convert": {
"command": "npx",
"args": [
"-y",
"mcp-color-convert@latest"
]
}
}
}You set up an MCP server that provides a full color toolkit for conversion, manipulation, analysis, and accessibility. This server integrates with your development workflow so AI agents can convert colors between formats, adjust hues and saturation, analyze contrast, and generate harmonious palettes across design systems and web projects.
You use this MCP server by connecting an MCP client to the color converter service. Install the server locally or run it through your agent’s configuration, then issue color operations through your agent. You can convert colors between formats, adjust lightness or saturation, analyze contrast, and generate palettes or swatches. The tools work with common formats such as HEX, RGB(A), HSL(A), OkLCH, and OkLab, and preserve or remove alpha as appropriate when converting between formats.
Prerequisites you need before installing include Node.js 18 or newer and a working npm setup. You will run the installation and start commands locally and configure your MCP client to talk to the server.
Step-by-step setup to run the server via a local MCP client configuration is shown here. Copy these blocks exactly into your setup and adjust paths if needed.
The server supports a wide range of color formats for input and output. Alpha values are preserved when converting between alpha-capable formats and removed when converting to formats that do not support alpha.
To test the server locally, you can run the provided dry-run test command and then integrate with your MCP client to verify each tool’s behavior, such as converting a color to a different format, lightening a color, or generating a design system swatch.
If the server won’t start, ensure Node.js 18+ is installed and try reinstalling dependencies. If your MCP client cannot connect, restart the client after changes and verify the start command for the local server.
When testing color operations, verify that you are using supported input formats and correct alpha syntax for the chosen output format.
Universal color format converter that accepts hex, rgb(a), hsl(a), oklch, oklab, and named colors, and outputs in hex, rgb, hsl, oklch, or oklab with alpha preserved when applicable.
Increase the lightness of a color by a specified percentage.
Decrease the lightness of a color by a specified percentage.
Increase the color saturation by a specified percentage.
Decrease the color saturation by a specified percentage.
Rotate the hue by 180 degrees to produce the complementary color.
Convert a color to grayscale using perceptual OkLCH space.
Rotate the hue around the color wheel by a given degree amount.
Compute WCAG relative luminance (brightness) of a color.
Measure color intensity or purity on the color scale.
Extract the alpha/opacity value from a color that supports transparency.
Return a common color name or its hex value if unnamed.
Generate a harmonious 6-color palette based on a base color.
Create color harmonies such as complementary, triadic, or tetradic schemes.
Produce an 11-step design system swatch from a base color.
Generate a random color in a specified output format.
Calculate WCAG contrast ratio between two colors.
Provide a full WCAG compliance analysis with recommendations.
Suggest the optimal text color (black or white) for a given background.
Validate whether a color string is parseable by the system.