schemeog-mcp 2.7.0 → 2.8.2

package/README.md

@@ -1,7 +1,14 @@
-# SchemeOG MCP Server v2.7
+# SchemeOG MCP Server v2.8
 
 MCP server for [SchemeOG Cloud](https://scheme.smartlaunchhub.com) — create diagrams and flowcharts with AI.
 
+## Features
+
+- **15 commands** for schemas, projects, and tags
+- **Auto-refresh**: Browser automatically reloads when MCP updates schema
+- **Smart positioning**: Existing elements keep their positions, new elements get auto-layout
+- **No coordinate conflicts**: MCP ignores x/y to prevent overlapping cards
+
 ## 15 Commands
 
 ### Schemas (6 commands)
@@ -71,88 +78,6 @@ In `~/.claude.json` (or Cline settings):
 
 ## Schema Data Format
 
-### Full schema example (inline connections)
-
-Connections are defined **inside each element** in the `connections` array:
-
-```json
-{
-  "name": "User Registration Flow",
-  "description": "User registration process",
-  "elements": [
-    {
-      "id": "start",
-      "type": "card",
-      "title": "Registration Form",
-      "color": "light_green",
-      "x": 100,
-      "y": 100,
-      "tags": ["user"],
-      "description": "User fills in email and password",
-      "connections": [
-        {"to": "validate", "label": "submit"}
-      ]
-    },
-    {
-      "id": "validate",
-      "type": "condition",
-      "title": "Validate Data",
-      "color": "light_yellow",
-      "x": 300,
-      "y": 100,
-      "tags": ["system", "check"],
-      "description": "Check email format and password strength",
-      "connections": [
-        {"to": "save", "label": "valid"},
-        {"to": "error", "label": "invalid", "style": "dashed"}
-      ]
-    },
-    {
-      "id": "save",
-      "type": "card",
-      "title": "Save to Database",
-      "color": "light_blue",
-      "x": 500,
-      "y": 50,
-      "tags": ["system"],
-      "description": "Create user record in database",
-      "connections": [
-        {"to": "success"}
-      ]
-    },
-    {
-      "id": "error",
-      "type": "card",
-      "title": "Validation Error",
-      "color": "light_red",
-      "x": 500,
-      "y": 150,
-      "tags": ["system", "error"],
-      "description": "Show validation errors to user",
-      "connections": [
-        {"to": "start", "label": "retry"}
-      ]
-    },
-    {
-      "id": "success",
-      "type": "card",
-      "title": "Registration Complete",
-      "color": "light_green",
-      "x": 700,
-      "y": 100,
-      "tags": ["user"],
-      "description": "User successfully registered"
-    }
-  ],
-  "tagsDictionary": [
-    {"id": "tag-user", "name": "user", "color": "#4CAF50"},
-    {"id": "tag-system", "name": "system", "color": "#2196F3"},
-    {"id": "tag-check", "name": "check", "color": "#FF9800"},
-    {"id": "tag-error", "name": "error", "color": "#F44336"}
-  ]
-}
-```
-
 ### Element (card or condition)
 
 ```json
@@ -161,8 +86,6 @@ Connections are defined **inside each element** in the `connections` array:
   "type": "card",
   "title": "Card Title",
   "color": "light_blue",
-  "x": 100,
-  "y": 200,
   "tags": ["tag1", "tag2"],
   "description": "Detailed description",
   "borderColor": "blue",
@@ -174,14 +97,16 @@ Connections are defined **inside each element** in the `connections` array:
 }
 ```
 
+**IMPORTANT: Do NOT specify `x` and `y` coordinates!**
+- MCP automatically ignores coordinates to prevent cards from overlapping
+- Existing elements keep their positions
+- New elements are automatically positioned by auto-layout
+- This prevents the common problem of Claude copying coordinates from existing cards
+
 **Element types:**
 - `card` — regular process/action card
 - `condition` — decision point (diamond shape)
 
-**Coordinates (`x`, `y`):**
-- Optional but recommended for precise positioning
-- If omitted, auto-layout will arrange elements
-
 **Completion status (`completed`):**
 - `true` — card is marked as completed (done)
 - `false` or omitted — card is not completed
@@ -224,14 +149,73 @@ Connections are defined inside each element's `connections` array:
 
 **Line styles (`style`):** `solid` (default), `dashed`, `dotted`
 
+### Full schema example
+
+```json
+{
+  "name": "User Registration Flow",
+  "description": "User registration process",
+  "elements": [
+    {
+      "id": "start",
+      "type": "card",
+      "title": "Registration Form",
+      "color": "light_green",
+      "tags": ["user"],
+      "description": "User fills in email and password",
+      "connections": [
+        {"to": "validate", "label": "submit"}
+      ]
+    },
+    {
+      "id": "validate",
+      "type": "condition",
+      "title": "Validate Data",
+      "color": "light_yellow",
+      "tags": ["system"],
+      "connections": [
+        {"to": "save", "label": "valid"},
+        {"to": "error", "label": "invalid"}
+      ]
+    },
+    {
+      "id": "save",
+      "type": "card",
+      "title": "Save to Database",
+      "color": "light_blue",
+      "tags": ["system"],
+      "connections": [{"to": "success"}]
+    },
+    {
+      "id": "error",
+      "type": "card",
+      "title": "Validation Error",
+      "color": "light_red",
+      "tags": ["system"],
+      "connections": [{"to": "start", "label": "retry"}]
+    },
+    {
+      "id": "success",
+      "type": "card",
+      "title": "Registration Complete",
+      "color": "light_green",
+      "tags": ["user"]
+    }
+  ],
+  "tagsDictionary": [
+    {"id": "tag-user", "name": "user", "color": "#4CAF50"},
+    {"id": "tag-system", "name": "system", "color": "#2196F3"}
+  ]
+}
+```
+
 ### Tags Dictionary (tagsDictionary)
 
 ```json
 {
   "tagsDictionary": [
     {"id": "tag-1", "name": "system", "color": "#2196F3"},
-    {"id": "tag-2", "name": "user", "color": "#4CAF50"},
-    {"id": "tag-3", "name": "check", "color": "#FF9800"}
+    {"id": "tag-2", "name": "user", "color": "#4CAF50"}
   ]
 }
 ```
@@ -240,13 +224,25 @@ Connections are defined inside each element's `connections` array:
 - `system`, `user`, `admin`
 - `client`, `manager`, `bot`
 
+## Auto-Refresh Feature
+
+When you edit a schema via MCP while viewing it in the browser:
+- Browser automatically detects changes every 3 seconds
+- Page reloads ONLY when changes are made by MCP (not by your own edits)
+- No manual refresh needed — just edit via MCP and watch the browser update!
+
+**How it works:**
+- MCP marks all updates with `updatedBy: 'mcp'`
+- Browser ignores its own updates (`updatedBy: 'web'`)
+- This prevents infinite reload loops when you edit in browser
+
 ## Opening Schema by URL
 
 You can open any schema by URL using `get_schema_by_url`:
 
 ```
-# Canvas URL
-https://scheme.smartlaunchhub.com/canvas?id=abc123
+# Canvas URL (основной формат)
+https://scheme.smartlaunchhub.com/canvas?schema=abc123
 
 # Shared link
 https://scheme.smartlaunchhub.com/shared/xyz789

package/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * SchemeOG MCP Server v2.6
+ * SchemeOG MCP Server v2.8
  *
  * MCP сервер для работы со схемами, проектами и тегами в SchemeOG Cloud.
  *
@@ -399,13 +399,13 @@ function normalizeElements(elements) {
       fixed.tags = el.tags;
     }
 
-    // Координаты x, y — СОХРАНЯЕМ! (нужны для правильного отображения)
-    if (typeof el.x === "number") {
-      fixed.x = el.x;
-    }
-    if (typeof el.y === "number") {
-      fixed.y = el.y;
-    }
+    // Координаты x, y — НЕ сохраняем от MCP!
+    // Причина: Claude часто копирует координаты существующих карточек,
+    // что приводит к наложению карточек друг на друга.
+    // Клиент сам расположит новые карточки через auto-layout.
+    //
+    // Если нужно ОБНОВИТЬ существующий элемент с сохранением позиции,
+    // координаты будут взяты из текущих данных схемы на сервере.
 
     // Completed — отметка о завершении карточки
     if (typeof el.completed === "boolean") {
@@ -551,9 +551,9 @@ const TOOLS = [
     description: `Получить схему по URL ссылке.
 
 Поддерживаемые форматы URL:
-- https://scheme.smartlaunchhub.com/canvas?schema=ID
-- https://scheme.smartlaunchhub.com/canvas?id=ID
+- https://scheme.smartlaunchhub.com/canvas?schema=ID (основной формат)
 - scheme.smartlaunchhub.com/canvas?schema=ID
+- https://scheme.smartlaunchhub.com/canvas?id=ID (устаревший)
 
 Автоматически извлекает ID схемы из URL и проверяет доступ.
 Если у пользователя есть доступ к схеме — возвращает полные данные.
@@ -577,6 +577,10 @@ const TOOLS = [
 
 ВАЖНО: Генерируй схему с elements и tagsDictionary. Связи указывай ВНУТРИ элементов!
 
+⚠️ КРИТИЧНО: НЕ указывай x и y координаты для НОВЫХ элементов!
+Карточки без координат автоматически расположатся через auto-layout.
+Если указать x/y — карточки наложатся друг на друга!
+
 Параметры:
 - name: название схемы (обязательно)
 - description: описание
@@ -594,6 +598,7 @@ const TOOLS = [
   "tags": ["тег1"],        // массив названий тегов (опционально)
   "description": "Описание",  // подробное описание (опционально)
   "connections": [{"to": "target_id", "label": "подпись"}]  // ИСХОДЯЩИЕ СВЯЗИ (опционально)
+  // НЕ указывай x, y — они рассчитаются автоматически!
 }
 
 СВЯЗИ (inline формат — внутри элемента):
@@ -609,7 +614,7 @@ const TOOLS = [
   "color": "#2196F3"       // цвет в HEX
 }
 
-Пример: создать схему регистрации:
+Пример: создать схему регистрации (БЕЗ координат x/y!):
 {
   "name": "User Registration",
   "elements": [
@@ -974,9 +979,9 @@ const TOOLS = [
 /**
  * Извлечь ID схемы из URL
  * Поддерживает форматы:
- * - https://scheme.smartlaunchhub.com/canvas?schema=ID
- * - https://scheme.smartlaunchhub.com/canvas?id=ID
+ * - https://scheme.smartlaunchhub.com/canvas?schema=ID (основной)
  * - scheme.smartlaunchhub.com/canvas?schema=ID
+ * - https://scheme.smartlaunchhub.com/canvas?id=ID (устаревший)
  */
 function extractSchemaIdFromUrl(url) {
   if (!url || typeof url !== "string") return null;
@@ -1139,7 +1144,7 @@ ID: ${schema.id}
 Проект: ${schema.project?.name || "Общие"}
 Элементов: ${schema.data?.elements?.length || 0}
 Связей: ${schema.data?.connections?.length || 0}
-URL: ${API_BASE_URL}/canvas?id=${schema.id}
+URL: ${API_BASE_URL}/canvas?schema=${schema.id}
 
 Элементы:
 ${JSON.stringify(schema.data?.elements || [], null, 2)}
@@ -1246,7 +1251,7 @@ ${projectInfo}
 Элементов: ${data.elements.length}
 Связей: ${data.connections.length}
 
-URL: ${API_BASE_URL}/canvas?id=${result.schema.id}
+URL: ${API_BASE_URL}/canvas?schema=${result.schema.id}
 
 Открой ссылку в браузере чтобы увидеть схему.${warningsText}`,
         }],
@@ -1284,6 +1289,24 @@ URL: ${API_BASE_URL}/canvas?id=${result.schema.id}
           };
         }
 
+        // ВАЖНО: Сохраняем координаты существующих элементов!
+        // MCP не передаёт x/y, поэтому берём их из текущих данных.
+        const existingPositions = {};
+        (currentData.elements || []).forEach(el => {
+          if (el.id && (typeof el.x === 'number' || typeof el.y === 'number')) {
+            existingPositions[el.id] = { x: el.x, y: el.y };
+          }
+        });
+
+        // Применяем сохранённые координаты к элементам
+        normalized.elements.forEach(el => {
+          if (existingPositions[el.id]) {
+            el.x = existingPositions[el.id].x;
+            el.y = existingPositions[el.id].y;
+          }
+          // Новые элементы (без координат) будут расположены через auto-layout на клиенте
+        });
+
         newData.elements = normalized.elements;
         // Связи извлекаются из элементов (inline формат)
         newData.connections = normalized.extractedConnections;
@@ -1291,6 +1314,9 @@ URL: ${API_BASE_URL}/canvas?id=${result.schema.id}
       }
       updateBody.data = newData;
 
+      // ВАЖНО: Отправляем updatedBy: 'mcp' чтобы браузер знал что обновление от MCP
+      updateBody.updatedBy = 'mcp';
+
       const result = await apiRequest(`/schemas/${schema_id}`, {
         method: "PUT",
         body: JSON.stringify(updateBody),
@@ -1314,7 +1340,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}${warningsText}`,
+URL: ${API_BASE_URL}/canvas?schema=${schema_id}${warningsText}`,
         }],
       };
     }
@@ -1464,11 +1490,12 @@ URL: ${API_BASE_URL}/canvas?id=${schema_id}${warningsText}`,
       const tagsDictionary = currentData.tagsDictionary || [];
       tagsDictionary.push(newTag);
 
-      // Обновляем схему
+      // Обновляем схему (с пометкой от MCP)
       await apiRequest(`/schemas/${schema_id}`, {
         method: "PUT",
         body: JSON.stringify({
           data: { ...currentData, tagsDictionary },
+          updatedBy: 'mcp',
         }),
       });
 
@@ -1498,11 +1525,12 @@ URL: ${API_BASE_URL}/canvas?id=${schema_id}${warningsText}`,
         return el;
       });
 
-      // Обновляем схему
+      // Обновляем схему (с пометкой от MCP)
       await apiRequest(`/schemas/${schema_id}`, {
         method: "PUT",
         body: JSON.stringify({
           data: { ...currentData, tagsDictionary, elements },
+          updatedBy: 'mcp',
         }),
       });
 
@@ -1540,11 +1568,12 @@ URL: ${API_BASE_URL}/canvas?id=${schema_id}${warningsText}`,
         return el;
       });
 
-      // Обновляем схему
+      // Обновляем схему (с пометкой от MCP)
       await apiRequest(`/schemas/${schema_id}`, {
         method: "PUT",
         body: JSON.stringify({
           data: { ...currentData, elements },
+          updatedBy: 'mcp',
         }),
       });
 
@@ -1619,7 +1648,7 @@ async function main() {
   const server = new Server(
     {
       name: "schemeog-mcp",
-      version: "2.6.0",
+      version: "2.8.1",
     },
     {
       capabilities: {
@@ -1649,7 +1678,7 @@ async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
 
-  console.error("SchemeOG MCP Server v2.6 запущен");
+  console.error("SchemeOG MCP Server v2.8.1 запущен");
 }
 
 main().catch(console.error);

package/package.json

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