schemeog-mcp 2.3.0 → 2.5.0

package/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * SchemeOG MCP Server v2.2
+ * SchemeOG MCP Server v2.4
  *
  * MCP сервер для работы со схемами, проектами и тегами в SchemeOG Cloud.
  *
@@ -331,13 +331,18 @@ function hexToNamedColor(hex) {
 }
 
 /**
- * Нормализовать элементы — исправить типы, цвета, удалить лишние поля
- * Возвращает { elements, warnings }
+ * Нормализовать элементы — исправить типы, цвета, извлечь connections
+ * ВАЖНО: Поддерживает ОБА формата:
+ *   1. Локальный формат (connections внутри элементов)
+ *   2. Cloud формат (connections отдельным массивом)
+ *
+ * Возвращает { elements, extractedConnections, warnings }
  */
 function normalizeElements(elements) {
-  if (!elements || !Array.isArray(elements)) return { elements: [], warnings: [] };
+  if (!elements || !Array.isArray(elements)) return { elements: [], extractedConnections: [], warnings: [] };
 
   const warnings = [];
+  const extractedConnections = [];
 
   const normalized = elements.map((el, index) => {
     const fixed = {
@@ -394,20 +399,48 @@ function normalizeElements(elements) {
       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 удалены (рассчитываются автоматически)`);
+    // Координаты x, y — СОХРАНЯЕМ! (нужны для правильного отображения)
+    if (typeof el.x === "number") {
+      fixed.x = el.x;
+    }
+    if (typeof el.y === "number") {
+      fixed.y = el.y;
+    }
+
+    // КРИТИЧНО: Извлекаем connections из элемента (локальный формат)
+    // и конвертируем в формат сервера {from, to, label}
+    if (el.connections && Array.isArray(el.connections)) {
+      el.connections.forEach(conn => {
+        // Поддерживаем разные форматы connection:
+        // { to: "id" } или { to: "id", label: "text" } или полный { from, to, label }
+        const normalizedConn = {
+          id: conn.id || generateId(),
+          from: conn.from || el.id || fixed.id,
+          to: conn.to,
+        };
+        if (conn.label) {
+          normalizedConn.label = conn.label;
+        }
+        if (conn.style) {
+          normalizedConn.style = conn.style;
+        }
+        extractedConnections.push(normalizedConn);
+      });
     }
 
     return fixed;
   });
 
-  return { elements: normalized, warnings };
+  if (extractedConnections.length > 0) {
+    warnings.push(`Извлечено ${extractedConnections.length} связей из элементов (локальный формат → cloud формат)`);
+  }
+
+  return { elements: normalized, extractedConnections, warnings };
 }
 
 /**
  * Подготовить элементы — нормализовать и добавить ID
- * Возвращает { elements, warnings }
+ * Возвращает { elements, extractedConnections, warnings }
  */
 function prepareElements(elements) {
   return normalizeElements(elements);
@@ -498,12 +531,32 @@ const TOOLS = [
   "color": "light_blue",   // цвет фона: white, light_blue, light_green, light_yellow, light_orange, light_red, light_purple, light_gray, light_pink, light_teal
   "borderColor": "blue",   // цвет обводки: default, blue, green, orange, purple, red, teal, yellow, gray, black
   "tags": ["тег1"],        // массив названий тегов (опционально)
-  "description": "Описание процесса"  // подробное описание (опционально)
+  "description": "Описание процесса",  // подробное описание (опционально)
+  "x": 100,                // координата X (опционально, сохраняется если указана)
+  "y": 200,                // координата Y (опционально, сохраняется если указана)
+  "connections": [{"to": "id2"}]  // АЛЬТЕРНАТИВА: связи внутри элемента (локальный формат)
+}
+
+КООРДИНАТЫ x/y: Можно указывать для сохранения позиции. Если не указаны — рассчитываются автоматически.
+
+ДВА ФОРМАТА СВЯЗЕЙ (оба поддерживаются):
+
+1. Облачный формат — connections отдельным массивом:
+{
+  "elements": [...],
+  "connections": [{"from": "id1", "to": "id2"}]
+}
+
+2. Локальный формат — connections внутри каждого элемента:
+{
+  "elements": [
+    {"id": "id1", "title": "Card", "connections": [{"to": "id2"}]}
+  ]
 }
 
-НЕ указывай x, y, width, height - рассчитываются автоматически!
+MCP автоматически извлекает связи из элементов и объединяет с массивом connections!
 
-Формат связи:
+Формат связи (облачный):
 {
   "from": "source_id",     // ID элемента-источника
   "to": "target_id",       // ID элемента-назначения
@@ -511,6 +564,12 @@ const TOOLS = [
   "style": "solid"         // solid, dashed, dotted (опционально)
 }
 
+Формат связи (внутри элемента):
+{
+  "to": "target_id",       // ID элемента-назначения (from берётся из родительского элемента)
+  "label": "подпись"       // текст на связи (опционально)
+}
+
 Формат тега (tagsDictionary):
 {
   "id": "tag-1",           // уникальный ID тега
@@ -1040,12 +1099,18 @@ ${JSON.stringify(schema.data?.connections || [], null, 2)}`,
     case "create_schema": {
       const { name, description, project_id, elements, connections, tagsDictionary } = args;
 
-      // Нормализуем элементы и получаем предупреждения
-      const { elements: normalizedElements, warnings } = prepareElements(elements);
+      // Нормализуем элементы и извлекаем connections (поддержка локального формата)
+      const { elements: normalizedElements, extractedConnections, warnings } = prepareElements(elements);
+
+      // Объединяем: connections из параметров + извлечённые из элементов
+      const allConnections = [
+        ...prepareConnections(connections),
+        ...extractedConnections,
+      ];
 
       const data = {
         elements: normalizedElements,
-        connections: prepareConnections(connections),
+        connections: allConnections,
         tagsDictionary: tagsDictionary || [],
       };
 
@@ -1063,7 +1128,7 @@ ${JSON.stringify(schema.data?.connections || [], null, 2)}`,
         if (warnings.length > 10) {
           warningsText += `\n• ...и ещё ${warnings.length - 10}`;
         }
-        warningsText += `\n\n💡 Подсказка: используй type "card"/"condition", цвета light_blue/light_green/etc, НЕ указывай x/y/width/height`;
+        warningsText += `\n\n💡 Подсказка: используй type "card"/"condition", цвета light_blue/light_green/etc`;
       }
 
       return {
@@ -1100,13 +1165,25 @@ URL: ${API_BASE_URL}/canvas?id=${result.schema.id}
 
       // Обновляем данные только если переданы
       const newData = { ...currentData };
+      let extractedConnections = [];
       if (elements !== undefined) {
         const normalized = prepareElements(elements);
         newData.elements = normalized.elements;
+        extractedConnections = normalized.extractedConnections;
         warnings = normalized.warnings;
       }
       if (connections !== undefined) {
-        newData.connections = prepareConnections(connections);
+        // Объединяем переданные connections + извлечённые из элементов
+        newData.connections = [
+          ...prepareConnections(connections),
+          ...extractedConnections,
+        ];
+      } else if (extractedConnections.length > 0) {
+        // Если connections не переданы, но есть извлечённые — добавляем их к существующим
+        newData.connections = [
+          ...(currentData.connections || []),
+          ...extractedConnections,
+        ];
       }
       updateBody.data = newData;
 
@@ -1122,7 +1199,7 @@ URL: ${API_BASE_URL}/canvas?id=${result.schema.id}
         if (warnings.length > 10) {
           warningsText += `\n• ...и ещё ${warnings.length - 10}`;
         }
-        warningsText += `\n\n💡 Подсказка: используй type "card"/"condition", цвета light_blue/light_green/etc, НЕ указывай x/y/width/height`;
+        warningsText += `\n\n💡 Подсказка: используй type "card"/"condition", цвета light_blue/light_green/etc`;
       }
 
       return {
@@ -1468,7 +1545,7 @@ async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
 
-  console.error("SchemeOG MCP Server v2.3 запущен");
+  console.error("SchemeOG MCP Server v2.4 запущен");
 }
 
 main().catch(console.error);

package/package.json

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