@trishchuk/coolors-mcp 1.0.1 → 1.1.0

package/.github/workflows/ci.yml

@@ -14,35 +14,32 @@ jobs:
     strategy:
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        node-version: [18.x, 20.x, 22.x]
-        exclude:
-          # Skip some combinations to save CI time
-          - os: windows-latest
-            node-version: 18.x
-          - os: macos-latest
-            node-version: 18.x
+        node-version: [20.x, 22.x]
 
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
 
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
       - name: Setup Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
-          cache: "npm"
+          cache: "pnpm"
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Lint TypeScript
-        run: npm run lint
+        run: pnpm run lint
 
       - name: Build project
-        run: npm run build
+        run: pnpm run build
 
       - name: Run tests
-        run: npm test
+        run: pnpm test
         continue-on-error: true
 
       - name: Verify build output
@@ -71,21 +68,24 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v4
 
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: "20.x"
-          cache: "npm"
+          cache: "pnpm"
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Build
-        run: npm run build
+        run: pnpm run build
 
-      - name: Test npm pack
+      - name: Test pnpm pack
         run: |
-          npm pack
+          pnpm pack
           ls -la *.tgz
 
       - name: Validate package contents
@@ -107,17 +107,20 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v4
 
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: "20.x"
-          cache: "npm"
+          cache: "pnpm"
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Build documentation
-        run: npm run docs:build
+        run: pnpm run docs:build
 
       - name: Verify docs build
         run: |

package/.github/workflows/deploy-docs.yml

@@ -24,17 +24,20 @@ jobs:
         with:
           fetch-depth: 0 # For lastUpdated feature
 
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: "20"
-          cache: "npm"
+          cache: "pnpm"
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Build VitePress site
-        run: npm run docs:build
+        run: pnpm run docs:build
         env:
           NODE_ENV: production
 

package/.github/workflows/release.yml

@@ -25,12 +25,15 @@ jobs:
         with:
           fetch-depth: 0
 
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
           node-version: "20"
           registry-url: "https://registry.npmjs.org"
-          cache: "npm"
+          cache: "pnpm"
 
       - name: Verify package name
         run: |
@@ -41,13 +44,13 @@ jobs:
           fi
 
       - name: Install dependencies
-        run: npm ci
+        run: pnpm install --frozen-lockfile
 
       - name: Run tests and build
         run: |
-          npm run lint
-          npm run build
-          npm test || true
+          pnpm run lint
+          pnpm run build
+          pnpm test || true
 
       - name: Verify build output
         run: |
@@ -59,16 +62,15 @@ jobs:
 
       - name: Create tarball and check size
         run: |
-          npm pack --dry-run
-          SIZE=$(npm pack --json | jq '.[0].size')
+          pnpm pack
+          SIZE=$(stat -c%s *.tgz)
           echo "📦 Package size: $SIZE bytes"
           if [ $SIZE -gt 10485760 ]; then
             echo "⚠️ Warning: Package size exceeds 10MB"
           fi
 
       - name: Publish to npm
-        run: |
-          npm publish --access public
+        run: pnpm publish --access public --no-git-checks
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 

package/README.md

@@ -15,6 +15,12 @@ Advanced color operations MCP server with Material Design 3 support, CSS theme m
 - 🌈 **Advanced Palette Generation** - Create palettes with locked colors
 - 🎨 **Gradient Generation** - Smooth gradients with multiple interpolation methods
 - 🚫 **Dislike Analysis** - Detect and fix universally disliked colors
+- 👁️ **Color-Blindness Simulation** - Brettel/Machado matrices for protan/deutan/tritan + accessibility audit
+- 🆎 **APCA Contrast** - WCAG 3 draft contrast (Lc) alongside classic WCAG 2.x ratio
+- 🎚️ **Tonal Scales & State Colors** - Tailwind-style 50–950 scales and hover/active/focus/disabled variants in HCT
+- 🧬 **Palette Cohesion Score** - Quantify visual unity (tone / chroma / hue harmony) with targeted fix suggestions
+- 🪪 **Semantic Palettes** - One brand color → primary/secondary/tertiary + success/warning/error/info in a unified family
+- 📦 **Palette Export** - CSS custom properties, SCSS, Tailwind config, W3C design tokens, JSON
 
 ## Installation
 
@@ -52,8 +58,8 @@ npm install @trishchuk/coolors-mcp
 ```bash
 git clone https://github.com/x51xxx/coolors-mcp
 cd coolors-mcp
-npm install
-npm run build
+pnpm install
+pnpm run build
 ```
 
 ## Quick Start
@@ -114,14 +120,28 @@ Calculate perceptual distance between colors.
 
 #### `check_contrast`
 
-Check WCAG contrast ratio compliance.
+Check contrast between two colors. Supports the WCAG 2.x luminance ratio (default), APCA Lc (WCAG 3 draft), or both side-by-side.
 
 ```typescript
 {
   "foreground": "#000000",
-  "background": "#ffffff"
+  "background": "#ffffff",
+  "algorithm": "both"  // "wcag" (default) | "apca" | "both"
+}
+// Output: WCAG 21.00:1 + APCA Lc 106.0
+```
+
+#### `adjust_color`
+
+Lighten / darken / saturate / desaturate / grayscale / invert / mix a color.
+
+```typescript
+{
+  "color": "#6750a4",
+  "operation": "mix",
+  "with": "#ff6b6b",
+  "amount": 0.5  // weight (0-1) for mix, percent (0-100) for the others
 }
-// Output: Contrast Ratio: 21.00:1 ✓ WCAG AAA
 ```
 
 ### Palette Generation
@@ -272,6 +292,93 @@ Generate Material Design theme from image colors.
 }
 ```
 
+### Visual Cohesion
+
+#### `generate_tonal_scale`
+
+Build a Tailwind-style 50/100/.../900/950 scale from one seed color. Uses HCT so steps are perceptually even regardless of hue.
+
+```typescript
+{
+  "seed": "#6750a4",
+  "name": "brand",        // CSS variable base name
+  "chromaBoost": 1,       // multiplier on seed chroma
+  "stops": [50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950]
+}
+```
+
+#### `generate_state_colors`
+
+Derive interaction states (hover/active/pressed/focus/disabled/selected) from a base color with consistent tonal deltas.
+
+```typescript
+{
+  "base": "#6750a4",
+  "isDark": false   // true to lighten on hover instead of darkening
+}
+```
+
+#### `analyze_palette_consistency`
+
+Score visual cohesion of a palette: tonal step uniformity, chroma spread, hue harmony, plus a single 0–100 score and targeted suggestions.
+
+```typescript
+{
+  "colors": ["#6750a4", "#7f67be", "#a48dc8", "#ff0000"]
+}
+// Output: cohesion 77/100 + outlier #ff0000 (chroma 105 vs avg 60)
+```
+
+#### `generate_semantic_palette`
+
+From one brand color, generate primary/secondary/tertiary + success/warning/error/info with normalized chroma & tone so every color feels like part of the same family.
+
+```typescript
+{
+  "brand": "#6750a4",
+  "isDark": false
+}
+```
+
+### Accessibility & Color Blindness
+
+#### `simulate_color_blindness`
+
+Simulate how colors appear to viewers with protanopia / deuteranopia / tritanopia (and the milder anomaly forms, plus achromatopsia). Uses Machado-style linear-sRGB confusion-line matrices.
+
+```typescript
+{
+  "colors": ["#e63946", "#2a9d8f"],
+  "types": ["protanopia", "deuteranopia"]  // optional, defaults to all 7
+}
+```
+
+#### `check_palette_accessibility`
+
+Audit a palette for color-blind friendliness — flags pairs of colors that become indistinguishable under each CVD type.
+
+```typescript
+{
+  "colors": ["#e63946", "#2a9d8f", "#264653", "#f4a261"],
+  "indistinguishableThreshold": 10  // ΔE2000 below which colors collide
+}
+```
+
+### Palette Export
+
+#### `export_palette`
+
+Export a palette as CSS custom properties, SCSS variables, a Tailwind config snippet, W3C design tokens, or JSON.
+
+```typescript
+{
+  "colors": ["#fef3c7", "#fde68a", "#fcd34d"],
+  "format": "tailwind",   // "css" | "scss" | "tailwind" | "tokens" | "json"
+  "prefix": "amber",
+  "names": ["50", "100", "200"]   // optional, default uses 50/100…900 scale
+}
+```
+
 ### Color Psychology
 
 #### `analyze_color_likability`
@@ -332,21 +439,23 @@ Multi-factor scoring system:
 
 ## Development
 
+This project uses [pnpm](https://pnpm.io). Install it once with `npm i -g pnpm` or `corepack enable`.
+
 ```bash
 # Install dependencies
-npm install
+pnpm install
 
 # Build the project
-npm run build
+pnpm run build
 
 # Run tests
-npm test
+pnpm test
 
 # Format code
-npm run format
+pnpm run format
 
 # Lint
-npm run lint
+pnpm run lint
 ```
 
 ## Architecture
@@ -410,13 +519,13 @@ Create smooth, perceptually uniform gradients for modern UIs.
 
 Contributions welcome! Please ensure:
 
-- Tests pass (`npm test`)
-- Code is formatted (`npm run format`)
-- Type checking passes (`npm run lint`)
+- Tests pass (`pnpm test`)
+- Code is formatted (`pnpm run format`)
+- Type checking passes (`pnpm run lint`)
 
 ## License
 
-MIT
+MIT © [Taras Trishchuk](https://trishchuk.com)
 
 ## Credits