@trishchuk/coolors-mcp 1.0.1 → 1.1.0

package/GEMINI.md

@@ -1,54 +0,0 @@
-# Аналіз проекту `coolors-mcp`
-
-## Огляд
-
-Цей проект є інструментом командного рядка (CLI) або сервером, створеним за допомогою TypeScript, який надає розширений
-набір інструментів для роботи з кольорами та темами. Він значною мірою базується на принципах Material Design 3 і
-використовує `@modelcontextprotocol/sdk` для надання своїх функціональних можливостей через набір інструментів.
-
-## Основна функціональність
-
-Проект пропонує комплексний набір інструментів для керування кольорами, зокрема:
-
-- **Операції з кольорами:**
-  - Перетворення між різними колірними моделями (HEX, RGB, HSL, LAB, HCT).
-  - Обчислення перцептивної різниці кольорів (Delta E 2000).
-  - Забезпечення доступності за допомогою перевірки контрастності WCAG.
-  - Психологічна корекція кольору (виправлення "непривабливих" кольорів).
-- **Тематизація на основі зображень:**
-  - Видобування домінуючих кольорів із зображення.
-  - Автоматичне створення повної теми Material Design 3 на основі видобутих кольорів.
-- **Тематизація в стилі Material Design:**
-  - Генерація колірних тем Material Design 3.
-  - Створення тональних палітр.
-  - Гармонізація кольорів на основі принципів Material Design.
-- **Рефакторинг CSS:**
-  - Аналіз існуючого CSS.
-  - Зіставлення жорстко закодованих кольорів із темою.
-  - Рефакторинг CSS для використання змінних теми.
-- **Генерація палітри:**
-  - Створення різних типів колірних палітр (монохроматичних, аналогічних, комплементарних тощо) з базового кольору.
-
-## Структура проекту
-
-- `CoolorsMCP.ts`: Основна точка входу, що налаштовує сервер за допомогою `@modelcontextprotocol/sdk`.
-- `session.ts`: Керує сеансами клієнтів і викликами інструментів.
-- `tools/`: Містить усі визначення інструментів, які є основними функціями, що надаються сервером.
-- `color/`: Ймовірно, містить базову логіку маніпулювання кольорами, що використовується інструментами.
-- `theme/`: Ймовірно, містить логіку для розбору, зіставлення та рефакторингу тем.
-- `bin/`: Містить виконувані сценарії для запуску сервера або CLI.
-- `examples/`: Містить приклади використання інструментів.
-
-## Ключові залежності
-
-- `@modelcontextprotocol/sdk`: Використовується для створення сервера та обробки протоколу інструментів.
-- `zod`: Використовується для перевірки вхідних даних в інструментах.
-- `@standard-schema/spec`: Використовується для визначення параметрів інструментів.
-- `xsschema`: Використовується для перетворення схем Zod на схеми JSON.
-
-## Загальне враження
-
-Цей проект є складним інструментом для розробників і дизайнерів, які працюють із кольорами та системами дизайну. Він
-автоматизує багато виснажливих завдань, пов'язаних із керуванням кольорами та створенням тем, а функція рефакторингу CSS
-є особливо вражаючою. Використання Model Context Protocol свідчить про те, що він призначений для інтеграції з іншими
-інструментами розробки або агентами ШІ.

package/TOOLS_UK.md

@@ -1,233 +0,0 @@
-# Інструменти Coolors MCP
-
-## 🎨 Конвертація кольорів
-
-### convert_color
-
-Конвертує кольори між форматами: hex, rgb, hsl, lab, hct
-
-```javascript
-{ color: "#6366f1", to: "hct" }
-// Результат: "hct(265.8, 87.2, 47.9)"
-```
-
-## 📏 Вимірювання відстані
-
-### color_distance
-
-Обчислює перцептивну відстань між кольорами
-
-```javascript
-{ color1: "#6366f1", color2: "#5355d1", metric: "deltaE2000" }
-// Результат: 5.2 (помітна різниця)
-```
-
-## ♿ Перевірка контрасту
-
-### check_contrast
-
-Перевіряє контраст за стандартами WCAG
-
-```javascript
-{ foreground: "#000000", background: "#ffffff" }
-// Результат: 21:1 ✓ AAA
-```
-
-## 🎨 Генерація палітр
-
-### generate_palette
-
-Створює палітри: монохроматичні, аналогові, комплементарні, тріадні, тетрадні
-
-```javascript
-{ baseColor: "#6366f1", type: "analogous", count: 5 }
-```
-
-### generate_palette_with_locks
-
-Генерує палітру зі збереженням заданих кольорів
-
-```javascript
-{ lockedColors: ["#6366f1", "#ec4899"], totalColors: 7, mode: "harmony" }
-```
-
-### generate_gradient
-
-Створює плавні градієнти
-
-```javascript
-{
-  colors: ["#6366f1", "#ec4899"],
-  steps: 10,
-  interpolation: "lab"  // lab, hsl, rgb, hct
-}
-```
-
-## 🎭 Material Design 3
-
-### generate_material_theme
-
-Генерує повну тему Material Design 3
-
-```javascript
-{ sourceColor: "#6366f1", includeCustomColors: true }
-// Результат: light/dark схеми + тональні палітри
-```
-
-### generate_tonal_palette
-
-Створює тональну палітру (0-100)
-
-```javascript
-{ color: "#6366f1", tones: [0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 95, 99, 100] }
-```
-
-### harmonize_colors
-
-Гармонізує кольори для спільної роботи
-
-```javascript
-{ colors: ["#6366f1", "#ec4899", "#10b981"], method: "harmonize", factor: 0.5 }
-```
-
-## 🔍 Підбір змінних теми
-
-### match_theme_color
-
-Знаходить найближчу CSS змінну для кольору
-
-```javascript
-{
-  color: "#6366f1",
-  themeCSS: ":root { --primary: #6366f1; }",
-  context: "background",
-  minConfidence: 70
-}
-```
-
-### refactor_css_with_theme
-
-Автоматично замінює кольори на змінні теми
-
-```javascript
-{
-  css: ".btn { background: #6366f1; }",
-  themeCSS: ":root { --primary: #6366f1; }",
-  preserveOriginal: true
-}
-// Результат: .btn { background: var(--primary); /* was: #6366f1 */ }
-```
-
-### match_theme_colors_batch
-
-Підбирає змінні для багатьох кольорів
-
-```javascript
-{
-  colors: ["#6366f1", "#ec4899", "#10b981"],
-  themeCSS: "/* CSS зі змінними */"
-}
-```
-
-### generate_theme_css
-
-Генерує CSS змінні для теми
-
-```javascript
-{
-  sourceColor: "#6366f1",
-  prefix: "color",
-  includeTones: [0, 10, 20, 30, 40, 50, 60, 70, 80, 90, 95, 99, 100]
-}
-```
-
-## 🖼️ Витягування кольорів з зображень
-
-### extract_image_colors
-
-Витягує домінантні кольори алгоритмом Celebi
-
-```javascript
-{ imageData: [/* RGBA масив */], maxColors: 5, minPopulation: 0.01 }
-// Результат: масив кольорів з популяцією та оцінкою для UI
-```
-
-### generate_theme_from_image
-
-Генерує Material тему з кольорів зображення
-
-```javascript
-{
-  imageData: [/* пікселі */],
-  variant: "vibrant",  // tonalSpot, fidelity, expressive, neutral, monochrome
-  contrastLevel: 0.5   // 0 (стандарт), 0.5 (середній), 1.0 (високий)
-}
-```
-
-## 🚫 Аналіз неприємних кольорів
-
-### analyze_color_likability
-
-Перевіряє чи колір у "зоні огиди" (темні жовто-зелені)
-
-```javascript
-{ color: "#6b7c3a", autoFix: true }
-// Результат: виправлений колір + пояснення
-```
-
-### fix_disliked_colors_batch
-
-Виправляє кілька неприємних кольорів
-
-```javascript
-{
-  colors: ["#6b7c3a", "#5c6b2f"],
-  strategy: "both"  // shift, lighten, both
-}
-```
-
-## Ключові особливості
-
-### HCT колірний простір
-
-- **Тон** (0-360°): позиція на колірному колі
-- **Хрома** (0-150): насиченість
-- **Тональність** (0-100): світлість з гарантованим контрастом
-  - Різниця 40 = контраст 3:1
-  - Різниця 50 = контраст 4.5:1
-
-### Алгоритм підбору теми
-
-1. Перцептивна відстань (60%) - схожість за HCT
-2. Семантичний контекст (20%) - відповідність ролі
-3. Доступність (20%) - дотримання контрасту
-
-### Варіанти Material теми
-
-- **tonalSpot** - збалансована (за замовчуванням)
-- **fidelity** - зберігає бренд-колір точно
-- **vibrant** - яскрава, грайлива
-- **expressive** - креативні комбінації
-- **neutral** - професійна, мінімальна
-- **monochrome** - один відтінок
-
-## Швидкий старт
-
-### Claude Desktop
-
-```json
-{
-  "mcpServers": {
-    "coolors": {
-      "command": "npx",
-      "args": ["-y", "@trishchuk/coolors-mcp"]
-    }
-  }
-}
-```
-
-### Claude Code
-
-```bash
-claude mcp add coolors --npm-package @trishchuk/coolors-mcp
-```