@trishchuk/coolors-mcp 1.0.0

package/.claude/settings.local.json

@@ -0,0 +1,39 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(grep:*)",
+      "Bash(npm test)",
+      "Bash(npm test:*)",
+      "Bash(npm run build:*)",
+      "Bash(node:*)",
+      "Bash(npm run:*)",
+      "mcp__coolors__convert_color",
+      "mcp__coolors__generate_material_theme",
+      "mcp__coolors__generate_palette",
+      "mcp__gemini-cli__ask-gemini",
+      "Bash(open /Users/taras/www/MCP/coolors-mcp/demo/music-player.html)",
+      "Bash(open /Users/taras/www/MCP/coolors-mcp/demo/podcast-player.html)",
+      "mcp__coolors__generate_theme_css",
+      "mcp__coolors__refactor_css_with_theme",
+      "Bash(npx vitest run:*)",
+      "WebSearch",
+      "Bash(for i in {1..5})",
+      "Bash(do echo \"Run $i:\")",
+      "Bash(done)",
+      "Bash(npx prettier:*)",
+      "Bash(find:*)",
+      "Bash(npm install:*)",
+      "Bash(npx tsx:*)",
+      "Bash(git pull:*)",
+      "Bash(git config:*)",
+      "Bash(npm:*)"
+    ],
+    "deny": [],
+    "ask": []
+  },
+  "enabledMcpjsonServers": [
+    "gemini-cli",
+    "codex-cli",
+    "coolors"
+  ]
+}

package/.env

@@ -0,0 +1,2 @@
+
+GOOGLE_CLOUD_PROJECT=sincere-signal-457111-q3

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,73 @@
+---
+name: Bug report
+about: Report a bug in Coolors MCP
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## Bug Description
+<!-- A clear and concise description of what the bug is -->
+
+## Environment
+- **Node.js version**: 
+- **npm version**: 
+- **Operating System**: 
+- **MCP Client**: 
+  - [ ] Claude Desktop
+  - [ ] Claude Code
+  - [ ] Other (please specify):
+- **MCP SDK 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
+- [ ] generate_palette
+- [ ] generate_material_theme
+- [ ] match_theme_color
+- [ ] refactor_css_with_theme
+- [ ] extract_image_colors
+
+## Command/Prompt Used
+```javascript
+// Example of the exact command or prompt that caused the issue
+{
+  "name": "convert_color",
+  "arguments": {
+    "color": "...",
+    "to": "..."
+  }
+}
+```
+
+## 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

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,71 @@
+---
+name: Feature request
+about: Suggest a new feature for Coolors MCP
+title: '[FEATURE] '
+labels: enhancement
+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. 
+
+## Tool Enhancement
+<!-- Which tool(s) would this feature affect? -->
+- [ ] Color conversion tools
+- [ ] Material Design theme tools
+- [ ] CSS theme matching tools
+- [ ] Image color extraction
+- [ ] New tool (please describe)
+- [ ] Core MCP server functionality
+- [ ] Integration/compatibility
+- [ ] Documentation
+
+## Color Space Considerations
+<!-- Which color spaces would this feature affect? -->
+- [ ] RGB/Hex
+- [ ] HSL/HSV
+- [ ] LAB
+- [ ] HCT (Material Design)
+- [ ] All color spaces
+- [ ] N/A - Not color space related
+
+## Example Implementation
+```javascript
+// Example of how you would use this feature
+{
+  "name": "tool-name",
+  "arguments": {
+    // your proposed API
+  }
+}
+```
+
+## Alternatives Considered
+<!-- Have you considered other solutions or workarounds? -->
+
+## Additional Context
+<!-- Any other context, mockups, or examples -->
+
+## Impact Assessment
+- **Benefit to users**: 
+- **Implementation complexity**: Low / Medium / High
+- **Breaking changes**: Yes / No
+- **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

package/.github/pull_request_template.md

@@ -0,0 +1,97 @@
+## 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)
+- [ ] 📝 Documentation update
+- [ ] 🎨 Code style/refactoring
+- [ ] ⚡ Performance improvement
+- [ ] ✅ Test addition/modification
+- [ ] 🔧 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**: 
+
+### Test Steps
+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
+- [ ] generate_palette
+- [ ] generate_material_theme
+- [ ] match_theme_color
+- [ ] refactor_css_with_theme
+- [ ] extract_image_colors
+- [ ] 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
+- [ ] Code comments added/updated
+- [ ] CHANGELOG.md updated
+- [ ] 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
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] I have tested my changes locally with `npm run lint`
+- [ ] I have tested my changes locally with `npm run build`
+- [ ] I have tested the MCP integration with a real client (Claude Desktop/Code)
+- [ ] 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

package/.github/workflows/ci.yml

@@ -0,0 +1,127 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    
+    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
+    
+    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'
+
+  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
+
+  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

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

@@ -0,0 +1,56 @@
+name: Deploy Documentation
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+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'
+      
+      - 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:
+          path: docs/.vitepress/dist
+
+  deploy:
+    environment:
+      name: github-pages
+      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

package/.github/workflows/release.yml

@@ -0,0 +1,99 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Release version (e.g., 1.0.0)'
+        required: true
+        type: string
+
+permissions:
+  contents: write
+  packages: write
+
+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'
+      
+      - name: Verify package name
+        run: |
+          PACKAGE_NAME=$(node -p "require('./package.json').name")
+          if [ "$PACKAGE_NAME" != "@trishchuk/coolors-mcp" ]; then
+            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
+            echo "❌ Build failed: dist/bin/server.js not found"
+            exit 1
+          fi
+          echo "✅ Build output verified"
+      
+      - name: Create tarball and check size
+        run: |
+          npm pack --dry-run
+          SIZE=$(npm pack --json | jq '.[0].size')
+          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
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+      
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          draft: false
+          prerelease: ${{ contains(github.ref, '-beta') || contains(github.ref, '-alpha') }}
+          body: |
+            ## 🎨 Coolors MCP Release
+
+            ### Installation
+            ```bash
+            # Claude Code
+            claude mcp add coolors -- npx -y @trishchuk/coolors-mcp
+
+            # Claude Desktop
+            npm install -g @trishchuk/coolors-mcp
+            ```
+
+            ### What's Changed
+            See below for the full changelog.
+
+            ### 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)

package/.mcp.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "gemini-cli": {
+      "command": "npx",
+      "args": ["-y", "gemini-mcp-tool"]
+    },
+    "coolors": {
+      "command": "node",
+      "args": ["/Users/taras/www/MCP/coolors-mcp/dist/bin/server.js"]
+    }
+  }
+}

package/.prettierignore

@@ -0,0 +1 @@
+pnpm-lock.yaml