# mcp-color-tools

MCP server providing color manipulation and design tools for AI agents.

## Tools

### color_convert

Convert a color between HEX, RGB, HSL, HSV, and CMYK. Accepts any format as input and returns all formats.

```json
{ "color": "#ff6b35" }
{ "color": "rgb(255, 107, 53)" }
{ "color": "hsl(16, 100%, 60%)" }
{ "color": "hsv(16, 79%, 100%)" }
{ "color": "cmyk(0, 58, 79, 0)" }
```

### palette_generate

Generate a color palette from a base color.

**Types:** complementary, analogous, triadic, split-complementary, monochromatic

```json
{ "color": "#ff6b35", "type": "triadic" }
```

### contrast_check

Check WCAG contrast ratio between two colors. Reports AA/AAA compliance for normal text, large text, and UI components.

```json
{ "color1": "#ffffff", "color2": "#333333" }
```

### color_mix

Mix, blend, lighten, darken, saturate, or desaturate colors.

```json
{ "operation": "mix", "colors": ["#ff0000", "#0000ff"], "weights": [2, 1] }
{ "operation": "blend", "colors": ["#ff0000", "#0000ff"], "ratio": 0.3 }
{ "operation": "lighten", "colors": ["#ff6b35"], "amount": 20 }
{ "operation": "darken", "colors": ["#ff6b35"], "amount": 15 }
{ "operation": "saturate", "colors": ["#888888"], "amount": 30 }
{ "operation": "desaturate", "colors": ["#ff6b35"], "amount": 25 }
```

### css_gradient

Generate CSS gradient code with direction, stops, and browser prefixes.

```json
{
  "type": "linear",
  "colors": ["#ff6b35", "#ffd700", "#00bcd4"],
  "direction": "135deg"
}
```

```json
{
  "type": "radial",
  "colors": [
    { "color": "#ff6b35", "position": 0 },
    { "color": "#ffd700", "position": 50 },
    { "color": "#00bcd4", "position": 100 }
  ],
  "direction": "circle at center"
}
```

## Setup

```bash
npm install
npm run build
```

## Claude Desktop Configuration

```json
{
  "mcpServers": {
    "color-tools": {
      "command": "node",
      "args": ["path/to/mcp-color-tools/dist/index.js"]
    }
  }
}
```

## License

MIT