@trishchuk/coolors-mcp 1.0.0 → 1.0.1

package/.claude/settings.local.json

@@ -31,9 +31,5 @@
     "deny": [],
     "ask": []
   },
-  "enabledMcpjsonServers": [
-    "gemini-cli",
-    "codex-cli",
-    "coolors"
-  ]
-}
+  "enabledMcpjsonServers": ["gemini-cli", "codex-cli", "coolors"]
+}

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,44 +1,52 @@
 ---
 name: Bug report
 about: Report a bug in Coolors MCP
-title: '[BUG] '
+title: "[BUG] "
 labels: bug
-assignees: ''
+assignees: ""
 ---
 
 ## Bug Description
+
 <!-- A clear and concise description of what the bug is -->
 
 ## Environment
-- **Node.js version**: 
-- **npm version**: 
-- **Operating System**: 
-- **MCP Client**: 
+
+- **Node.js version**:
+- **npm version**:
+- **Operating System**:
+- **MCP Client**:
   - [ ] Claude Desktop
   - [ ] Claude Code
   - [ ] Other (please specify):
 - **MCP SDK version**:
-- **Coolors MCP version**: 
+- **Coolors MCP version**:
 
 ## To Reproduce
+
 Steps to reproduce the behavior:
+
 1. Install/configure '...'
 2. Run command '...'
 3. Use tool '...'
 4. See error
 
 ## Expected Behavior
+
 <!-- What you expected to happen -->
 
 ## Actual Behavior
+
 <!-- What actually happened -->
 
 ## Error Messages / Logs
+
 ```
 <!-- Paste any error messages or relevant logs here -->
 ```
 
 ## MCP Tool Used
+
 - [ ] convert_color
 - [ ] color_distance
 - [ ] check_contrast
@@ -49,6 +57,7 @@ Steps to reproduce the behavior:
 - [ ] extract_image_colors
 
 ## Command/Prompt Used
+
 ```javascript
 // Example of the exact command or prompt that caused the issue
 {
@@ -61,13 +70,16 @@ Steps to reproduce the behavior:
 ```
 
 ## Additional Context
+
 <!-- Add any other context about the problem here -->
 
 ## Possible Solution
+
 <!-- If you have suggestions on how to fix the bug -->
 
 ## Checklist
+
 - [ ] I have checked existing issues for duplicates
 - [ ] I have verified the MCP server is properly installed
 - [ ] I have tried with the latest version of the tool
-- [ ] I have included all relevant error messages
+- [ ] I have included all relevant error messages

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,28 +1,35 @@
 ---
 name: Feature request
 about: Suggest a new feature for Coolors MCP
-title: '[FEATURE] '
+title: "[FEATURE] "
 labels: enhancement
-assignees: ''
+assignees: ""
 ---
 
 ## Feature Description
+
 <!-- Clear description of the feature you'd like to see -->
 
 ## Problem It Solves
+
 <!-- What problem or limitation does this feature address? -->
 
 ## Proposed Solution
+
 <!-- How do you envision this feature working? -->
 
 ## Use Cases
+
 <!-- Specific examples of how this feature would be used -->
-1. 
-2. 
-3. 
+
+1.
+2.
+3.
 
 ## Tool Enhancement
+
 <!-- Which tool(s) would this feature affect? -->
+
 - [ ] Color conversion tools
 - [ ] Material Design theme tools
 - [ ] CSS theme matching tools
@@ -33,7 +40,9 @@ assignees: ''
 - [ ] Documentation
 
 ## Color Space Considerations
+
 <!-- Which color spaces would this feature affect? -->
+
 - [ ] RGB/Hex
 - [ ] HSL/HSV
 - [ ] LAB
@@ -42,6 +51,7 @@ assignees: ''
 - [ ] N/A - Not color space related
 
 ## Example Implementation
+
 ```javascript
 // Example of how you would use this feature
 {
@@ -53,19 +63,23 @@ assignees: ''
 ```
 
 ## Alternatives Considered
+
 <!-- Have you considered other solutions or workarounds? -->
 
 ## Additional Context
+
 <!-- Any other context, mockups, or examples -->
 
 ## Impact Assessment
-- **Benefit to users**: 
+
+- **Benefit to users**:
 - **Implementation complexity**: Low / Medium / High
 - **Breaking changes**: Yes / No
-- **Documentation needs**: 
+- **Documentation needs**:
 
 ## Checklist
+
 - [ ] I have searched existing issues for similar requests
 - [ ] This feature aligns with the project's goals
 - [ ] I would be willing to help implement this feature
-- [ ] I have considered the impact on existing users
+- [ ] I have considered the impact on existing users

package/.github/pull_request_template.md

@@ -1,12 +1,17 @@
 ## Description
+
 <!-- Provide a brief description of the changes in this PR -->
 
 ## Related Issue
+
 <!-- Link to the issue this PR addresses, if applicable -->
+
 Fixes #(issue number)
 
 ## Type of Change
+
 <!-- Mark the relevant option with an "x" -->
+
 - [ ] 🐛 Bug fix (non-breaking change which fixes an issue)
 - [ ] ✨ New feature (non-breaking change which adds functionality)
 - [ ] 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
@@ -17,29 +22,37 @@ Fixes #(issue number)
 - [ ] 🔧 Configuration change
 
 ## Changes Made
+
 <!-- List the specific changes made in this PR -->
-- 
-- 
-- 
+
+-
+-
+-
 
 ## Testing
+
 <!-- Describe the tests you ran to verify your changes -->
 
 ### Test Configuration
+
 - **Node.js version**:
 - **MCP SDK version**:
-- **Operating System**: 
+- **Operating System**:
 
 ### Test Steps
-1. 
-2. 
-3. 
+
+1.
+2.
+3.
 
 ### Test Results
+
 <!-- Include any relevant test output or screenshots -->
 
 ## Tool-Specific Testing
+
 <!-- If your changes affect specific tools, mark which ones you've tested -->
+
 - [ ] convert_color
 - [ ] color_distance
 - [ ] check_contrast
@@ -51,16 +64,21 @@ Fixes #(issue number)
 - [ ] N/A - Core functionality change
 
 ## Breaking Changes
+
 <!-- If this PR introduces breaking changes, describe them here -->
+
 - [ ] This PR includes breaking changes
 
 If yes, describe:
+
 - What breaks:
 - Migration path:
 - Affected users:
 
 ## Documentation
+
 <!-- Mark what documentation needs to be updated -->
+
 - [ ] README.md updated
 - [ ] API documentation updated
 - [ ] VitePress docs updated
@@ -69,7 +87,9 @@ If yes, describe:
 - [ ] No documentation needed
 
 ## Checklist
+
 <!-- Ensure all items are completed before submitting the PR -->
+
 - [ ] My code follows the project's style guidelines
 - [ ] I have performed a self-review of my own code
 - [ ] I have commented my code, particularly in hard-to-understand areas
@@ -81,17 +101,22 @@ If yes, describe:
 - [ ] Any dependent changes have been merged and published
 
 ## Additional Notes
+
 <!-- Add any additional notes, concerns, or discussion points -->
 
 ## Screenshots
+
 <!-- If applicable, add screenshots to help explain your changes -->
 
 ## Reviewer Notes
+
 <!-- Any specific areas you'd like reviewers to focus on -->
 
 ---
+
 **For Maintainers:**
+
 - [ ] Changes reviewed
 - [ ] Tests pass
 - [ ] Documentation complete
-- [ ] Ready to merge
+- [ ] Ready to merge

package/.github/workflows/ci.yml

@@ -2,15 +2,15 @@ name: CI
 
 on:
   push:
-    branches: [ main ]
+    branches: [main]
   pull_request:
-    branches: [ main ]
+    branches: [main]
   workflow_dispatch:
 
 jobs:
   test:
     runs-on: ${{ matrix.os }}
-    
+
     strategy:
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
@@ -21,107 +21,107 @@ jobs:
             node-version: 18.x
           - os: macos-latest
             node-version: 18.x
-    
+
     steps:
-    - name: Checkout code
-      uses: actions/checkout@v4
-    
-    - name: Setup Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v4
-      with:
-        node-version: ${{ matrix.node-version }}
-        cache: 'npm'
-    
-    - name: Install dependencies
-      run: npm ci
-    
-    - name: Lint TypeScript
-      run: npm run lint
-    
-    - name: Build project
-      run: npm run build
-    
-    - name: Run tests
-      run: npm test
-      continue-on-error: true
-    
-    - name: Verify build output
-      run: |
-        if [ ! -f "dist/bin/server.js" ]; then
-          echo "Build failed: dist/bin/server.js not found"
-          exit 1
-        fi
-      shell: bash
-      if: runner.os != 'Windows'
-
-    - name: Verify build output (Windows)
-      run: |
-        if (!(Test-Path "dist/bin/server.js")) {
-          Write-Error "Build failed: dist/bin/server.js not found"
-          exit 1
-        }
-      shell: pwsh
-      if: runner.os == 'Windows'
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint TypeScript
+        run: npm run lint
+
+      - name: Build project
+        run: npm run build
+
+      - name: Run tests
+        run: npm test
+        continue-on-error: true
+
+      - name: Verify build output
+        run: |
+          if [ ! -f "dist/bin/server.js" ]; then
+            echo "Build failed: dist/bin/server.js not found"
+            exit 1
+          fi
+        shell: bash
+        if: runner.os != 'Windows'
+
+      - name: Verify build output (Windows)
+        run: |
+          if (!(Test-Path "dist/bin/server.js")) {
+            Write-Error "Build failed: dist/bin/server.js not found"
+            exit 1
+          }
+        shell: pwsh
+        if: runner.os == 'Windows'
 
   package-validation:
     runs-on: ubuntu-latest
     needs: test
-    
+
     steps:
-    - name: Checkout code
-      uses: actions/checkout@v4
-    
-    - name: Setup Node.js
-      uses: actions/setup-node@v4
-      with:
-        node-version: '20.x'
-        cache: 'npm'
-    
-    - name: Install dependencies
-      run: npm ci
-    
-    - name: Build
-      run: npm run build
-    
-    - name: Test npm pack
-      run: |
-        npm pack
-        ls -la *.tgz
-    
-    - name: Validate package contents
-      run: |
-        tar -tzf *.tgz | grep -E "(dist/|README|LICENSE|package.json)"
-    
-    - name: Check package size
-      run: |
-        SIZE=$(stat -c%s *.tgz)
-        echo "Package size: $SIZE bytes"
-        if [ $SIZE -gt 10485760 ]; then
-          echo "Warning: Package size exceeds 10MB"
-        fi
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20.x"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Test npm pack
+        run: |
+          npm pack
+          ls -la *.tgz
+
+      - name: Validate package contents
+        run: |
+          tar -tzf *.tgz | grep -E "(dist/|README|LICENSE|package.json)"
+
+      - name: Check package size
+        run: |
+          SIZE=$(stat -c%s *.tgz)
+          echo "Package size: $SIZE bytes"
+          if [ $SIZE -gt 10485760 ]; then
+            echo "Warning: Package size exceeds 10MB"
+          fi
 
   docs-build:
     runs-on: ubuntu-latest
-    
+
     steps:
-    - name: Checkout code
-      uses: actions/checkout@v4
-    
-    - name: Setup Node.js
-      uses: actions/setup-node@v4
-      with:
-        node-version: '20.x'
-        cache: 'npm'
-    
-    - name: Install dependencies
-      run: npm ci
-    
-    - name: Build documentation
-      run: npm run docs:build
-    
-    - name: Verify docs build
-      run: |
-        if [ ! -d "docs/.vitepress/dist" ]; then
-          echo "Documentation build failed"
-          exit 1
-        fi
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20.x"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build documentation
+        run: npm run docs:build
+
+      - name: Verify docs build
+        run: |
+          if [ ! -d "docs/.vitepress/dist" ]; then
+            echo "Documentation build failed"
+            exit 1
+          fi

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

@@ -17,27 +17,27 @@ concurrency:
 jobs:
   build:
     runs-on: ubuntu-latest
-    
+
     steps:
       - name: Checkout
         uses: actions/checkout@v4
         with:
           fetch-depth: 0 # For lastUpdated feature
-      
+
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
-          cache: 'npm'
-      
+          node-version: "20"
+          cache: "npm"
+
       - name: Install dependencies
         run: npm ci
-      
+
       - name: Build VitePress site
         run: npm run docs:build
         env:
           NODE_ENV: production
-      
+
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:
@@ -49,8 +49,8 @@ jobs:
       url: ${{ steps.deployment.outputs.page_url }}
     needs: build
     runs-on: ubuntu-latest
-    
+
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@v4

package/.github/workflows/release.yml

@@ -3,11 +3,11 @@ name: Release
 on:
   push:
     tags:
-      - 'v*.*.*'
+      - "v*.*.*"
   workflow_dispatch:
     inputs:
       version:
-        description: 'Release version (e.g., 1.0.0)'
+        description: "Release version (e.g., 1.0.0)"
         required: true
         type: string
 
@@ -18,20 +18,20 @@ permissions:
 jobs:
   publish:
     runs-on: ubuntu-latest
-    
+
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
-      
+
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
-          registry-url: 'https://registry.npmjs.org'
-          cache: 'npm'
-      
+          node-version: "20"
+          registry-url: "https://registry.npmjs.org"
+          cache: "npm"
+
       - name: Verify package name
         run: |
           PACKAGE_NAME=$(node -p "require('./package.json').name")
@@ -39,16 +39,16 @@ jobs:
             echo "❌ Package name mismatch. Expected @trishchuk/coolors-mcp, got $PACKAGE_NAME"
             exit 1
           fi
-      
+
       - name: Install dependencies
         run: npm ci
-      
+
       - name: Run tests and build
         run: |
           npm run lint
           npm run build
           npm test || true
-      
+
       - name: Verify build output
         run: |
           if [ ! -f "dist/bin/server.js" ]; then
@@ -56,7 +56,7 @@ jobs:
             exit 1
           fi
           echo "✅ Build output verified"
-      
+
       - name: Create tarball and check size
         run: |
           npm pack --dry-run
@@ -65,13 +65,13 @@ jobs:
           if [ $SIZE -gt 10485760 ]; then
             echo "⚠️ Warning: Package size exceeds 10MB"
           fi
-      
+
       - name: Publish to npm
         run: |
           npm publish --access public
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
-      
+
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v2
         with:
@@ -96,4 +96,4 @@ jobs:
             ### Links
             - 📦 [NPM Package](https://www.npmjs.com/package/@trishchuk/coolors-mcp)
             - 📖 [Documentation](https://x51xxx.github.io/coolors-mcp/)
-            - 🐛 [Report Issues](https://github.com/x51xxx/coolors-mcp/issues)
+            - 🐛 [Report Issues](https://github.com/x51xxx/coolors-mcp/issues)

package/README.md

@@ -18,11 +18,36 @@ Advanced color operations MCP server with Material Design 3 support, CSS theme m
 
 ## Installation
 
+### Method 1: NPX (Recommended)
+
+No installation needed - runs directly:
+
+#### Claude Desktop Configuration
+
+```json
+{
+  "mcpServers": {
+    "coolors": {
+      "command": "npx",
+      "args": ["-y", "@trishchuk/coolors-mcp"]
+    }
+  }
+}
+```
+
+#### Claude Code Configuration
+
+```bash
+claude mcp add coolors --npm-package @trishchuk/coolors-mcp
+```
+
+### Method 2: NPM Install
+
 ```bash
 npm install @trishchuk/coolors-mcp
 ```
 
-Or for development:
+### Method 3: From Source
 
 ```bash
 git clone https://github.com/x51xxx/coolors-mcp