schemeog-mcp 2.2.1 → 2.3.0

package/index.js

@@ -209,15 +209,208 @@ function generateId() {
 }
 
 /**
- * Подготовить элементы — добавить ID если нет
+ * Допустимые именованные цвета для элементов
+ */
+const VALID_COLORS = ["white", "light_blue", "light_green", "light_yellow", "light_orange", "light_red", "light_purple", "light_gray", "light_pink", "light_teal"];
+
+/**
+ * Маппинг HEX цветов к именованным (ближайшее соответствие)
+ */
+const HEX_TO_NAMED_COLOR = {
+  // Белые/серые
+  "#FFFFFF": "white", "#FFF": "white", "#FAFAFA": "white", "#F5F5F5": "light_gray",
+  "#E0E0E0": "light_gray", "#BDBDBD": "light_gray", "#9E9E9E": "light_gray",
+  "#CFD8DC": "light_gray", "#ECEFF1": "light_gray",
+
+  // Синие
+  "#E3F2FD": "light_blue", "#BBDEFB": "light_blue", "#90CAF9": "light_blue",
+  "#64B5F6": "light_blue", "#42A5F5": "light_blue", "#2196F3": "light_blue",
+  "#1E88E5": "light_blue", "#1976D2": "light_blue",
+
+  // Зелёные
+  "#E8F5E9": "light_green", "#C8E6C9": "light_green", "#A5D6A7": "light_green",
+  "#81C784": "light_green", "#66BB6A": "light_green", "#4CAF50": "light_green",
+  "#43A047": "light_green", "#388E3C": "light_green", "#DCEDC8": "light_green",
+
+  // Жёлтые
+  "#FFFDE7": "light_yellow", "#FFF9C4": "light_yellow", "#FFF59D": "light_yellow",
+  "#FFF176": "light_yellow", "#FFEE58": "light_yellow", "#FFEB3B": "light_yellow",
+  "#FDD835": "light_yellow", "#FBC02D": "light_yellow",
+
+  // Оранжевые
+  "#FFF3E0": "light_orange", "#FFE0B2": "light_orange", "#FFCC80": "light_orange",
+  "#FFB74D": "light_orange", "#FFA726": "light_orange", "#FF9800": "light_orange",
+  "#FB8C00": "light_orange", "#F57C00": "light_orange",
+  "#FFE5B4": "light_orange", "#FFCCBC": "light_orange", // персиковые
+
+  // Красные
+  "#FFEBEE": "light_red", "#FFCDD2": "light_red", "#EF9A9A": "light_red",
+  "#E57373": "light_red", "#EF5350": "light_red", "#F44336": "light_red",
+  "#E53935": "light_red", "#D32F2F": "light_red",
+  "#FCE4EC": "light_pink", "#F8BBD0": "light_pink", // розовые → light_pink
+
+  // Фиолетовые
+  "#F3E5F5": "light_purple", "#E1BEE7": "light_purple", "#CE93D8": "light_purple",
+  "#BA68C8": "light_purple", "#AB47BC": "light_purple", "#9C27B0": "light_purple",
+  "#8E24AA": "light_purple", "#7B1FA2": "light_purple",
+  "#D1C4E9": "light_purple", "#EDE7F6": "light_purple",
+
+  // Розовые
+  "#FCE4EC": "light_pink", "#F8BBD0": "light_pink", "#F48FB1": "light_pink",
+  "#F06292": "light_pink", "#EC407A": "light_pink", "#E91E63": "light_pink",
+
+  // Бирюзовые/Teal
+  "#E0F7FA": "light_teal", "#B2DFDB": "light_teal", "#80CBC4": "light_teal",
+  "#4DB6AC": "light_teal", "#26A69A": "light_teal", "#009688": "light_teal",
+  "#E0F2F1": "light_teal",
+};
+
+/**
+ * Конвертировать HEX цвет в ближайший именованный
+ */
+function hexToNamedColor(hex) {
+  if (!hex) return "white";
+
+  // Если уже именованный — проверяем и возвращаем
+  if (VALID_COLORS.includes(hex)) return hex;
+
+  // Нормализуем HEX
+  const normalizedHex = hex.toUpperCase().trim();
+
+  // Ищем точное соответствие
+  if (HEX_TO_NAMED_COLOR[normalizedHex]) {
+    return HEX_TO_NAMED_COLOR[normalizedHex];
+  }
+
+  // Если не нашли — пытаемся определить по оттенку
+  // Простой алгоритм: анализируем RGB компоненты
+  const match = normalizedHex.match(/^#?([A-F0-9]{2})([A-F0-9]{2})([A-F0-9]{2})$/i);
+  if (match) {
+    const r = parseInt(match[1], 16);
+    const g = parseInt(match[2], 16);
+    const b = parseInt(match[3], 16);
+
+    // Определяем доминирующий цвет
+    const max = Math.max(r, g, b);
+    const min = Math.min(r, g, b);
+    const brightness = (r + g + b) / 3;
+
+    // Белый/серый
+    if (max - min < 30) {
+      return brightness > 200 ? "white" : "light_gray";
+    }
+
+    // Красный доминирует
+    if (r === max && r > g + 20 && r > b + 20) {
+      return g > 150 ? "light_orange" : (b > 100 ? "light_pink" : "light_red");
+    }
+
+    // Зелёный доминирует
+    if (g === max && g > r + 20 && g > b + 20) {
+      return b > 150 ? "light_teal" : "light_green";
+    }
+
+    // Синий доминирует
+    if (b === max && b > r + 20 && b > g + 20) {
+      return r > 150 ? "light_purple" : "light_blue";
+    }
+
+    // Жёлтый (R и G высокие, B низкий)
+    if (r > 200 && g > 200 && b < 150) {
+      return "light_yellow";
+    }
+
+    // Оранжевый (R высокий, G средний, B низкий)
+    if (r > 200 && g > 100 && g < 200 && b < 150) {
+      return "light_orange";
+    }
+  }
+
+  // Fallback
+  return "light_blue";
+}
+
+/**
+ * Нормализовать элементы — исправить типы, цвета, удалить лишние поля
+ * Возвращает { elements, warnings }
+ */
+function normalizeElements(elements) {
+  if (!elements || !Array.isArray(elements)) return { elements: [], warnings: [] };
+
+  const warnings = [];
+
+  const normalized = elements.map((el, index) => {
+    const fixed = {
+      id: el.id || generateId(),
+    };
+
+    // Тип: block/note → card
+    if (el.type === "block" || el.type === "note" || el.type === "group") {
+      fixed.type = "card";
+      warnings.push(`Элемент ${index + 1}: type "${el.type}" → "card"`);
+    } else if (el.type === "condition" || el.type === "diamond") {
+      fixed.type = "condition";
+    } else {
+      fixed.type = el.type || "card";
+    }
+
+    // Title: text → title
+    if (el.text && !el.title) {
+      fixed.title = el.text;
+      warnings.push(`Элемент ${index + 1}: "text" → "title"`);
+    } else {
+      fixed.title = el.title || "";
+    }
+
+    // Цвет: HEX → именованный
+    if (el.color) {
+      if (el.color.startsWith("#")) {
+        const namedColor = hexToNamedColor(el.color);
+        fixed.color = namedColor;
+        warnings.push(`Элемент ${index + 1}: color "${el.color}" → "${namedColor}"`);
+      } else if (VALID_COLORS.includes(el.color)) {
+        fixed.color = el.color;
+      } else {
+        fixed.color = "white";
+        warnings.push(`Элемент ${index + 1}: неизвестный color "${el.color}" → "white"`);
+      }
+    } else {
+      fixed.color = "white";
+    }
+
+    // borderColor — оставляем если валидный
+    const validBorderColors = ["default", "blue", "green", "orange", "purple", "red", "teal", "yellow", "gray", "black"];
+    if (el.borderColor && validBorderColors.includes(el.borderColor)) {
+      fixed.borderColor = el.borderColor;
+    }
+
+    // Description
+    if (el.description) {
+      fixed.description = el.description;
+    }
+
+    // Tags
+    if (el.tags && Array.isArray(el.tags)) {
+      fixed.tags = el.tags;
+    }
+
+    // НЕ копируем: x, y, width, height — они автоматические
+    if (el.x !== undefined || el.y !== undefined || el.width !== undefined || el.height !== undefined) {
+      warnings.push(`Элемент ${index + 1}: x/y/width/height удалены (рассчитываются автоматически)`);
+    }
+
+    return fixed;
+  });
+
+  return { elements: normalized, warnings };
+}
+
+/**
+ * Подготовить элементы — нормализовать и добавить ID
+ * Возвращает { elements, warnings }
  */
 function prepareElements(elements) {
-  if (!elements) return [];
-  return elements.map(el => ({
-    id: el.id || generateId(),
-    type: el.type || "card",
-    ...el
-  }));
+  return normalizeElements(elements);
 }
 
 /**
@@ -256,11 +449,22 @@ const TOOLS = [
 Возвращает:
 - name: название схемы
 - description: описание
-- elements: массив элементов (блоки, заметки, группы)
+- elements: массив элементов (card или condition)
 - connections: массив связей между элементами
+- tagsDictionary: справочник тегов
+
+Формат элемента:
+{
+  "id": "unique_id",
+  "type": "card",           // card или condition
+  "title": "Название",      // заголовок
+  "color": "light_blue",    // ТОЛЬКО: white, light_blue, light_green, light_yellow, light_orange, light_red, light_purple, light_gray, light_pink, light_teal
+  "description": "Текст",   // описание
+  "tags": ["тег1"]          // массив тегов
+}
 
-Каждый элемент содержит: id, type, x, y, text, width, height, color
-Каждая связь содержит: id, from, to, label, style`,
+ВАЖНО: НЕ используй x, y, width, height — они рассчитываются автоматически!
+ВАЖНО: Цвета ТОЛЬКО именованные (light_blue), НЕ HEX (#FFFFFF)!`,
     inputSchema: {
       type: "object",
       properties: {
@@ -834,12 +1038,15 @@ ${JSON.stringify(schema.data?.connections || [], null, 2)}`,
     }
 
     case "create_schema": {
-      const { name, description, project_id, elements, connections } = args;
+      const { name, description, project_id, elements, connections, tagsDictionary } = args;
+
+      // Нормализуем элементы и получаем предупреждения
+      const { elements: normalizedElements, warnings } = prepareElements(elements);
 
       const data = {
-        elements: prepareElements(elements),
+        elements: normalizedElements,
         connections: prepareConnections(connections),
-        tagsDictionary: [],
+        tagsDictionary: tagsDictionary || [],
       };
 
       const result = await apiRequest("/schemas", {
@@ -849,6 +1056,16 @@ ${JSON.stringify(schema.data?.connections || [], null, 2)}`,
 
       const projectInfo = project_id ? `Проект: ${project_id}` : 'Проект: Общие';
 
+      // Формируем сообщение о предупреждениях
+      let warningsText = "";
+      if (warnings.length > 0) {
+        warningsText = `\n\n⚠️ Автоисправления (${warnings.length}):\n• ${warnings.slice(0, 10).join("\n• ")}`;
+        if (warnings.length > 10) {
+          warningsText += `\n• ...и ещё ${warnings.length - 10}`;
+        }
+        warningsText += `\n\n💡 Подсказка: используй type "card"/"condition", цвета light_blue/light_green/etc, НЕ указывай x/y/width/height`;
+      }
+
       return {
         content: [{
           type: "text",
@@ -861,7 +1078,7 @@ ${projectInfo}
 
 URL: ${API_BASE_URL}/canvas?id=${result.schema.id}
 
-Открой ссылку в браузере чтобы увидеть схему.`,
+Открой ссылку в браузере чтобы увидеть схему.${warningsText}`,
         }],
       };
     }
@@ -876,6 +1093,7 @@ URL: ${API_BASE_URL}/canvas?id=${result.schema.id}
 
       // Формируем обновление
       const updateBody = {};
+      let warnings = [];
 
       if (name) updateBody.name = name;
       if (description !== undefined) updateBody.description = description;
@@ -883,7 +1101,9 @@ URL: ${API_BASE_URL}/canvas?id=${result.schema.id}
       // Обновляем данные только если переданы
       const newData = { ...currentData };
       if (elements !== undefined) {
-        newData.elements = prepareElements(elements);
+        const normalized = prepareElements(elements);
+        newData.elements = normalized.elements;
+        warnings = normalized.warnings;
       }
       if (connections !== undefined) {
         newData.connections = prepareConnections(connections);
@@ -895,6 +1115,16 @@ URL: ${API_BASE_URL}/canvas?id=${result.schema.id}
         body: JSON.stringify(updateBody),
       });
 
+      // Формируем сообщение о предупреждениях
+      let warningsText = "";
+      if (warnings.length > 0) {
+        warningsText = `\n\n⚠️ Автоисправления (${warnings.length}):\n• ${warnings.slice(0, 10).join("\n• ")}`;
+        if (warnings.length > 10) {
+          warningsText += `\n• ...и ещё ${warnings.length - 10}`;
+        }
+        warningsText += `\n\n💡 Подсказка: используй type "card"/"condition", цвета light_blue/light_green/etc, НЕ указывай x/y/width/height`;
+      }
+
       return {
         content: [{
           type: "text",
@@ -903,7 +1133,7 @@ URL: ${API_BASE_URL}/canvas?id=${result.schema.id}
 Элементов: ${result.schema.data?.elements?.length || 0}
 Связей: ${result.schema.data?.connections?.length || 0}
 
-URL: ${API_BASE_URL}/canvas?id=${schema_id}`,
+URL: ${API_BASE_URL}/canvas?id=${schema_id}${warningsText}`,
         }],
       };
     }
@@ -1208,7 +1438,7 @@ async function main() {
   const server = new Server(
     {
       name: "schemeog-mcp",
-      version: "2.2.1",
+      version: "2.3.0",
     },
     {
       capabilities: {
@@ -1238,7 +1468,7 @@ async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
 
-  console.error("SchemeOG MCP Server v2.2 запущен");
+  console.error("SchemeOG MCP Server v2.3 запущен");
 }
 
 main().catch(console.error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "schemeog-mcp",
-  "version": "2.2.1",
+  "version": "2.3.0",
   "description": "MCP Server for SchemeOG Cloud - Create and manage visual diagrams and flowcharts with AI assistance",
   "type": "module",
   "main": "index.js",