home / mcp / color scheme generator mcp server

Color Scheme Generator MCP Server

An MCP server to generate color schemes

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "deepakkumardewani-color-scheme-mcp": {
      "command": "node",
      "args": [
        "/full/path/to/colors-mcp-server/build/index.js"
      ]
    }
  }
}

You can generate harmonious color schemes through an MCP server that integrates with The Color API. It provides multiple color scheme tools so you can quickly create cohesive palettes for design projects and iterate on color choices with MCP clients.

How to use

Connect to the Color Scheme Generator MCP Server from your MCP client and choose a color scheme tool to generate a palette from a seed color. You can specify the seed color in several formats and set the number of colors you want in the result. The server exposes tools for monochrome schemes and wheel-based schemes such as analogic, complement, analogic complement, triad, and quad. Each tool returns a structured palette with hex, RGB, and HSL values, along with color names and their positions in the palette.

Typical usage patterns include starting with a seed color like blue, or a hex color such as #ff6b35, and requesting a specific count of colors (between 3 and 10, defaulting to 5). Then you apply the resulting palette to your design work in your favorite design tool or UI system.

How to install

Prerequisites you need before installing: Node.js version 18 or later, and a package manager such as npm, yarn, or pnpm.

Step 1: Clone the project and install dependencies.

git clone <repository-url>
cd colors-mcp-server
npm install

Step 2: Build the server so it can be run by your MCP client.

npm run build

Step 3: Configure your MCP client to connect to the server. Use the provided example configuration blocks for Claude Desktop and Cursor to set up the MCP server connection.

{
  "mcpServers": {
    "color_scheme": {
      "command": "node",
      "args": ["/full/path/to/colors-mcp-server/build/index.js"]
    }
  }
}

Additional notes

If you are using Claude Desktop, save the configuration as claude_desktop_config.json. If you use Cursor, go to Settings > MCP > Add new global MCP server and use the same configuration as above. The server is designed to be run locally and interfaced through your MCP client for interactive palette generation.

Configuration and tools overview

This MCP server offers eight color scheme generation tools: monochrome variations (standard, dark, light) and color wheel-based schemes (analogic, complement, analogic complement, triad, quad). Each tool accepts a seed color and a count for the number of colors to generate, and returns a structured palette including hex, RGB, and HSL values.

Error handling and troubleshooting

If you encounter connection or generation issues, use your MCP client's inspector tooling to check the request payloads and tool responses. Ensure the server build path in your client configuration points to the correct index.js file after building.

Available tools

generate_monochrome_scheme

Generates a monochrome palette based on a seed hue, providing the standard monochrome variations.

generate_monochrome_dark_scheme

Generates a dark monochrome palette derived from the seed color for high-contrast designs.

generate_monochrome_light_scheme

Generates a light monochrome palette derived from the seed color for softer visuals.

generate_analogic_scheme

Creates a color palette using colors adjacent on the color wheel for harmonious combinations.

generate_complement_scheme

Generates a palette using complementary colors that sit opposite on the color wheel for strong contrast.

generate_analogic_complement_scheme

Combines analogic and complement relationships to produce a balanced, vibrant palette.

generate_triad_scheme

Produces a triad palette with three evenly spaced colors for balanced designs.

generate_quad_scheme

Generates a quad palette with four evenly spaced colors for diverse palettes.