color-mcp-server

What is color-mcp-server?

color-mcp-server is an MCP server that provides color and design tools for palette generation, WCAG contrast checking, color conversion, complementary colors, gradients, color blindness simulation, and CSS variable output. It integrates with TheColorAPI for some lookups and runs all other computations locally. No API keys are required. It is intended for design agents, frontend bots, and accessibility workflows.

How to use color-mcp-server?

Install with pip install color-mcp-server, then configure it in the Claude Desktop client by adding an entry to claude_desktop_config.json with the command color-mcp-server. Once running, you can invoke any of the nine tools directly (e.g., tool_generate_palette or tool_check_contrast).

Key features of color-mcp-server

• 9 built-in color tools (palette, contrast, conversion, etc.)
• WCAG 2.1 AA/AAA contrast checking for normal and large text
• Color blindness simulation (protanopia, deuteranopia, tritanopia, achromatopsia)
• Generates CSS custom properties from palette colors
• No API keys needed (uses free TheColorAPI or local calculations)
• Supports monochrome, analogic, complement, triad, and quad palettes

Use cases of color-mcp-server

• Automating WCAG compliance checks in design workflows
• Generating accessible color palettes for UI components
• Converting colors between hex, RGB, HSL, and HSV formats
• Simulating color vision deficiencies for inclusive design testing
• Producing ready‑to‑use CSS variables for frontend development

FAQ from color-mcp-server

Do I need an API key to use this server?

No. TheColorAPI is used for detailed color info and palette generation and is free without authentication. All other tools run locally and require no keys.

What are the dependencies/runtime requirements?

color-mcp-server requires Python (version not specified) and is installed via pip. No external runtime or database is needed.

Does the server work offline?

It depends on the tool. tool_get_color_info requires internet access to TheColorAPI, but tool_get_color_info_local and all other tools (contrast, conversion, simulation, etc.) work purely offline.

How are tools invoked?

Tasks are dispatched by calling the specific tool name (e.g., tool_generate_palette or tool_check_contrast) with the appropriate parameters. Examples are provided in the README.

What is the license?

color-mcp-server is released under the MIT License.