schemeog-mcp 2.5.1 → 2.6.0

package/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * SchemeOG MCP Server v2.4
+ * SchemeOG MCP Server v2.6
  *
  * MCP сервер для работы со схемами, проектами и тегами в SchemeOG Cloud.
  *
@@ -482,8 +482,7 @@ const TOOLS = [
 Возвращает:
 - name: название схемы
 - description: описание
-- elements: массив элементов (card или condition)
-- connections: массив связей между элементами
+- elements: массив элементов (card или condition) со связями внутри
 - tagsDictionary: справочник тегов
 
 Формат элемента:
@@ -492,12 +491,15 @@ const TOOLS = [
   "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
+  "borderColor": "blue",    // default, blue, green, orange, purple, red, teal, yellow, gray, black
   "description": "Текст",   // описание
-  "tags": ["тег1"]          // массив тегов
+  "tags": ["тег1"],         // массив тегов
+  "connections": [{"to": "target_id", "label": "подпись"}]  // исходящие связи
 }
 
 ВАЖНО: НЕ используй x, y, width, height — они рассчитываются автоматически!
-ВАЖНО: Цвета ТОЛЬКО именованные (light_blue), НЕ HEX (#FFFFFF)!`,
+ВАЖНО: Цвета ТОЛЬКО именованные (light_blue), НЕ HEX (#FFFFFF)!
+ВАЖНО: Связи указываются ВНУТРИ элементов в поле "connections"!`,
     inputSchema: {
       type: "object",
       properties: {
@@ -509,18 +511,42 @@ const TOOLS = [
       required: ["schema_id"],
     },
   },
+  {
+    name: "get_schema_by_url",
+    description: `Получить схему по URL ссылке.
+
+Поддерживаемые форматы URL:
+- https://scheme.smartlaunchhub.com/canvas?schema=ID
+- https://scheme.smartlaunchhub.com/canvas?id=ID
+- scheme.smartlaunchhub.com/canvas?schema=ID
+
+Автоматически извлекает ID схемы из URL и проверяет доступ.
+Если у пользователя есть доступ к схеме — возвращает полные данные.
+Если доступа нет — возвращает ошибку.
+
+Используй эту команду когда пользователь скидывает ссылку на схему.`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: {
+          type: "string",
+          description: "URL ссылка на схему (например https://scheme.smartlaunchhub.com/canvas?schema=xxx)",
+        },
+      },
+      required: ["url"],
+    },
+  },
   {
     name: "create_schema",
     description: `Создать новую схему с элементами и связями.
 
-ВАЖНО: Генерируй сразу полную схему с elements, connections и tagsDictionary!
+ВАЖНО: Генерируй схему с elements и tagsDictionary. Связи указывай ВНУТРИ элементов!
 
 Параметры:
 - name: название схемы (обязательно)
 - description: описание
 - project_id: ID проекта (опционально)
-- elements: массив элементов
-- connections: массив связей
+- elements: массив элементов (со связями внутри)
 - tagsDictionary: справочник тегов (опционально)
 
 Формат элемента:
@@ -531,42 +557,13 @@ 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": "Описание процесса",  // подробное описание (опционально)
-  "x": 100,                // координата X (опционально, сохраняется если указана)
-  "y": 200,                // координата Y (опционально, сохраняется если указана)
-  "connections": [{"to": "id2"}]  // АЛЬТЕРНАТИВА: связи внутри элемента (локальный формат)
-}
-
-КООРДИНАТЫ x/y: Можно указывать для сохранения позиции. Если не указаны — рассчитываются автоматически.
-
-ДВА ФОРМАТА СВЯЗЕЙ (оба поддерживаются):
-
-1. Облачный формат — connections отдельным массивом:
-{
-  "elements": [...],
-  "connections": [{"from": "id1", "to": "id2"}]
+  "description": "Описание",  // подробное описание (опционально)
+  "connections": [{"to": "target_id", "label": "подпись"}]  // ИСХОДЯЩИЕ СВЯЗИ (опционально)
 }
 
-2. Локальный формат — connections внутри каждого элемента:
+СВЯЗИ (inline формат — внутри элемента):
 {
-  "elements": [
-    {"id": "id1", "title": "Card", "connections": [{"to": "id2"}]}
-  ]
-}
-
-MCP автоматически извлекает связи из элементов и объединяет с массивом connections!
-
-Формат связи (облачный):
-{
-  "from": "source_id",     // ID элемента-источника
   "to": "target_id",       // ID элемента-назначения
-  "label": "подпись",      // текст на связи (опционально)
-  "style": "solid"         // solid, dashed, dotted (опционально)
-}
-
-Формат связи (внутри элемента):
-{
-  "to": "target_id",       // ID элемента-назначения (from берётся из родительского элемента)
   "label": "подпись"       // текст на связи (опционально)
 }
 
@@ -581,18 +578,12 @@ MCP автоматически извлекает связи из элемент
 {
   "name": "User Registration",
   "elements": [
-    {"id": "start", "type": "card", "title": "Форма регистрации", "color": "light_green", "tags": ["пользователь"]},
-    {"id": "validate", "type": "condition", "title": "Валидация", "color": "light_yellow", "tags": ["система"]},
-    {"id": "save", "type": "card", "title": "Сохранение в БД", "color": "light_blue", "tags": ["система"]},
+    {"id": "start", "type": "card", "title": "Форма регистрации", "color": "light_green", "tags": ["пользователь"], "connections": [{"to": "validate"}]},
+    {"id": "validate", "type": "condition", "title": "Валидация", "color": "light_yellow", "tags": ["система"], "connections": [{"to": "save", "label": "OK"}, {"to": "error", "label": "ошибка"}]},
+    {"id": "save", "type": "card", "title": "Сохранение в БД", "color": "light_blue", "tags": ["система"], "connections": [{"to": "success"}]},
     {"id": "error", "type": "card", "title": "Ошибка", "color": "light_red", "tags": ["система"]},
     {"id": "success", "type": "card", "title": "Успех", "color": "light_green", "tags": ["пользователь"]}
   ],
-  "connections": [
-    {"from": "start", "to": "validate"},
-    {"from": "validate", "to": "save", "label": "OK"},
-    {"from": "validate", "to": "error", "label": "ошибка"},
-    {"from": "save", "to": "success"}
-  ],
   "tagsDictionary": [
     {"id": "tag-user", "name": "пользователь", "color": "#4CAF50"},
     {"id": "tag-system", "name": "система", "color": "#2196F3"}
@@ -629,20 +620,6 @@ MCP автоматически извлекает связи из элемент
             },
           },
         },
-        connections: {
-          type: "array",
-          description: "Массив связей между элементами",
-          items: {
-            type: "object",
-            properties: {
-              from: { type: "string" },
-              to: { type: "string" },
-              label: { type: "string" },
-              style: { type: "string", enum: ["solid", "dashed", "dotted"] },
-            },
-            required: ["from", "to"],
-          },
-        },
         tagsDictionary: {
           type: "array",
           description: "Справочник тегов схемы",
@@ -676,10 +653,21 @@ MCP автоматически извлекает связи из элемент
 - schema_id: ID схемы (обязательно)
 - name: новое название (опционально)
 - description: новое описание (опционально)
-- elements: новый массив элементов (опционально)
-- connections: новый массив связей (опционально)
+- elements: новый массив элементов со связями внутри (опционально)
+
+Формат элемента (такой же как в create_schema):
+{
+  "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
+  "borderColor": "blue",   // default, blue, green, orange, purple, red, teal, yellow, gray, black
+  "tags": ["тег1"],
+  "description": "Описание",
+  "connections": [{"to": "target_id", "label": "подпись"}]  // ИСХОДЯЩИЕ СВЯЗИ внутри элемента
+}
 
-Если elements или connections не указаны - они останутся прежними.`,
+Если elements не указаны - они останутся прежними.`,
     inputSchema: {
       type: "object",
       properties: {
@@ -697,12 +685,7 @@ MCP автоматически извлекает связи из элемент
         },
         elements: {
           type: "array",
-          description: "Новый массив элементов (заменяет все существующие)",
-          items: { type: "object" },
-        },
-        connections: {
-          type: "array",
-          description: "Новый массив связей (заменяет все существующие)",
+          description: "Новый массив элементов со связями внутри (заменяет все существующие)",
           items: { type: "object" },
         },
       },
@@ -953,6 +936,42 @@ MCP автоматически извлекает связи из элемент
   },
 ];
 
+/**
+ * Извлечь ID схемы из URL
+ * Поддерживает форматы:
+ * - https://scheme.smartlaunchhub.com/canvas?schema=ID
+ * - https://scheme.smartlaunchhub.com/canvas?id=ID
+ * - scheme.smartlaunchhub.com/canvas?schema=ID
+ */
+function extractSchemaIdFromUrl(url) {
+  if (!url || typeof url !== "string") return null;
+
+  try {
+    // Добавляем https:// если нет протокола
+    let normalizedUrl = url.trim();
+    if (!normalizedUrl.startsWith("http://") && !normalizedUrl.startsWith("https://")) {
+      normalizedUrl = "https://" + normalizedUrl;
+    }
+
+    const urlObj = new URL(normalizedUrl);
+
+    // Проверяем что это наш домен
+    if (!urlObj.hostname.includes("scheme.smartlaunchhub.com") &&
+        !urlObj.hostname.includes("localhost")) {
+      return null;
+    }
+
+    // Извлекаем ID из query параметров
+    const schemaId = urlObj.searchParams.get("schema") || urlObj.searchParams.get("id");
+
+    return schemaId || null;
+  } catch (e) {
+    // Пробуем простой regex для извлечения
+    const match = url.match(/[?&](schema|id)=([a-zA-Z0-9_-]+)/);
+    return match ? match[2] : null;
+  }
+}
+
 /**
  * Валидация UUID формата
  */
@@ -1096,21 +1115,61 @@ ${JSON.stringify(schema.data?.connections || [], null, 2)}`,
       };
     }
 
+    case "get_schema_by_url": {
+      const { url } = args;
+
+      // Извлекаем ID из URL
+      const schemaId = extractSchemaIdFromUrl(url);
+
+      if (!schemaId) {
+        const error = createError(
+          ErrorCodes.VALIDATION_ERROR,
+          `Не удалось извлечь ID схемы из URL: "${url}"\n\nПоддерживаемые форматы:\n• https://scheme.smartlaunchhub.com/canvas?schema=ID\n• https://scheme.smartlaunchhub.com/canvas?id=ID`
+        );
+        throw new Error(error.message);
+      }
+
+      // Получаем схему по ID (проверка доступа происходит на сервере)
+      const result = await apiRequest(`/schemas/${schemaId}`);
+      const schema = result.schema;
+
+      return {
+        content: [{
+          type: "text",
+          text: `✅ Доступ к схеме получен!
+
+Схема "${schema.name}"
+
+ID: ${schema.id}
+Описание: ${schema.description || "(нет)"}
+Проект: ${schema.project?.name || "Общие"}
+Элементов: ${schema.data?.elements?.length || 0}
+Связей: ${schema.data?.connections?.length || 0}
+URL: ${API_BASE_URL}/canvas?schema=${schema.id}
+
+Элементы:
+${JSON.stringify(schema.data?.elements || [], null, 2)}
+
+Связи:
+${JSON.stringify(schema.data?.connections || [], null, 2)}
+
+Теперь ты можешь:
+• Редактировать схему с помощью replace_schema (schema_id: "${schema.id}")
+• Удалить схему с помощью delete_schema
+• Работать с тегами через add_tag, remove_tag, tag_element`,
+        }],
+      };
+    }
+
     case "create_schema": {
-      const { name, description, project_id, elements, connections, tagsDictionary } = args;
+      const { name, description, project_id, elements, tagsDictionary } = args;
 
-      // Нормализуем элементы и извлекаем connections (поддержка локального формата)
+      // Нормализуем элементы и извлекаем connections (inline формат)
       const { elements: normalizedElements, extractedConnections, warnings } = prepareElements(elements);
 
-      // Объединяем: connections из параметров + извлечённые из элементов
-      const allConnections = [
-        ...prepareConnections(connections),
-        ...extractedConnections,
-      ];
-
       const data = {
         elements: normalizedElements,
-        connections: allConnections,
+        connections: extractedConnections,
         tagsDictionary: tagsDictionary || [],
       };
 
@@ -1149,7 +1208,7 @@ URL: ${API_BASE_URL}/canvas?id=${result.schema.id}
     }
 
     case "replace_schema": {
-      const { schema_id, name, description, elements, connections } = args;
+      const { schema_id, name, description, elements } = args;
 
       // Получаем текущую схему
       const currentResult = await apiRequest(`/schemas/${schema_id}`);
@@ -1165,26 +1224,13 @@ 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;
+        // Связи извлекаются из элементов (inline формат)
+        newData.connections = normalized.extractedConnections;
         warnings = normalized.warnings;
       }
-      if (connections !== undefined) {
-        // Объединяем переданные connections + извлечённые из элементов
-        newData.connections = [
-          ...prepareConnections(connections),
-          ...extractedConnections,
-        ];
-      } else if (extractedConnections.length > 0) {
-        // Если connections не переданы, но есть извлечённые — добавляем их к существующим
-        newData.connections = [
-          ...(currentData.connections || []),
-          ...extractedConnections,
-        ];
-      }
       updateBody.data = newData;
 
       const result = await apiRequest(`/schemas/${schema_id}`, {
@@ -1515,7 +1561,7 @@ async function main() {
   const server = new Server(
     {
       name: "schemeog-mcp",
-      version: "2.3.0",
+      version: "2.6.0",
     },
     {
       capabilities: {
@@ -1545,7 +1591,7 @@ async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
 
-  console.error("SchemeOG MCP Server v2.4 запущен");
+  console.error("SchemeOG MCP Server v2.6 запущен");
 }
 
 main().catch(console.error);

package/package.json

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