schemeog-mcp 3.4.0 → 3.6.0

package/index.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 
 /**
- * SchemeOG MCP Server v2.9.3
+ * SchemeOG MCP Server v3.0.0
  *
- * MCP сервер для работы со схемами, проектами и тегами в SchemeOG Cloud.
+ * MCP сервер для работы со схемами, проектами, тегами и версиями в SchemeOG Cloud.
  *
  * Команды для схем:
  * - list_schemas: Список всех схем
@@ -29,6 +29,12 @@
  * - add_tag: Добавить тег в схему
  * - remove_tag: Удалить тег из схемы
  * - tag_element: Присвоить/убрать тег с элемента
+ *
+ * Команды для версий (история):
+ * - list_versions: Список версий схемы
+ * - get_version: Получить данные конкретной версии
+ * - restore_version: Восстановить схему из версии
+ * - create_version: Создать ручную версию (checkpoint)
  */
 
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -1131,6 +1137,10 @@ Claude урезает большие параметры, но file_path чита
   - "full" (по умолчанию) — полный экспорт с метаданными
   - "compact" — только elements, connections, tagsDictionary
   - "elements_only" — только массив elements (с connections внутри)
+- file_path: Путь для сохранения JSON файла (опционально)
+  - Если указан — JSON сохраняется в файл, возвращается только путь и статистика
+  - Если не указан — JSON возвращается в ответе (как раньше)
+  - РЕКОМЕНДУЕТСЯ для больших схем (>20 элементов) — экономит токены!
 
 Пример ответа (format: "full"):
 {
@@ -1158,6 +1168,141 @@ Claude урезает большие параметры, но file_path чита
           enum: ["full", "compact", "elements_only"],
           description: "Формат экспорта: full (с метаданными), compact (только данные), elements_only (только элементы)",
         },
+        file_path: {
+          type: "string",
+          description: "Путь для сохранения JSON файла. Если указан — JSON сохраняется в файл, Claude получает только путь (экономит токены!)",
+        },
+      },
+      required: ["schema_id"],
+    },
+  },
+
+  // ========== ВЕРСИИ ==========
+  {
+    name: "list_versions",
+    description: `Получить список версий (истории) схемы.
+
+Возвращает список всех сохранённых версий схемы — как автоматических (автосохранение),
+так и ручных (созданных пользователем).
+
+Каждая версия содержит:
+- id: уникальный ID версии
+- versionNumber: номер версии (1, 2, 3...)
+- createdAt: дата создания
+- isManual: true если создана вручную, false если автосохранение
+- comment: комментарий (только для ручных версий)
+- elementsCount: количество элементов в этой версии
+
+Используй для:
+- Просмотра истории изменений схемы
+- Поиска версии для восстановления
+- Аудита изменений`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        schema_id: {
+          type: "string",
+          description: "ID схемы",
+        },
+        limit: {
+          type: "number",
+          description: "Максимальное количество версий (по умолчанию 50, максимум 100)",
+        },
+        offset: {
+          type: "number",
+          description: "Смещение для пагинации (по умолчанию 0)",
+        },
+      },
+      required: ["schema_id"],
+    },
+  },
+  {
+    name: "get_version",
+    description: `Получить данные конкретной версии схемы.
+
+Возвращает полные данные версии, включая:
+- Все элементы на момент создания версии
+- Все связи
+- Viewport (позиция камеры)
+- Метаданные (дата, автор, комментарий)
+
+Используй для:
+- Просмотра содержимого конкретной версии перед восстановлением
+- Сравнения версий
+- Анализа изменений`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        schema_id: {
+          type: "string",
+          description: "ID схемы",
+        },
+        version_id: {
+          type: "string",
+          description: "ID версии",
+        },
+      },
+      required: ["schema_id", "version_id"],
+    },
+  },
+  {
+    name: "restore_version",
+    description: `Восстановить схему из указанной версии.
+
+⚠️ ВАЖНО: Перед восстановлением автоматически создаётся резервная копия текущего состояния!
+
+Процесс:
+1. Создаётся версия с текущим состоянием схемы (как backup)
+2. Данные схемы заменяются на данные из выбранной версии
+3. Позиция камеры (viewport) также восстанавливается
+
+Используй когда нужно:
+- Откатить нежелательные изменения
+- Восстановить случайно удалённые элементы
+- Вернуться к предыдущей версии схемы`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        schema_id: {
+          type: "string",
+          description: "ID схемы",
+        },
+        version_id: {
+          type: "string",
+          description: "ID версии для восстановления",
+        },
+      },
+      required: ["schema_id", "version_id"],
+    },
+  },
+  {
+    name: "create_version",
+    description: `Создать ручную версию (checkpoint) схемы.
+
+Используй для создания именованной точки восстановления перед важными изменениями.
+
+Параметры:
+- schema_id: ID схемы (обязательно)
+- comment: комментарий к версии (опционально, рекомендуется)
+
+Примеры комментариев:
+- "Перед рефакторингом структуры"
+- "Стабильная версия v1.0"
+- "До добавления новых экранов"
+
+Автоматические версии создаются при каждом сохранении схемы.
+Ручные версии отмечаются специальным флагом и не удаляются при очистке старых автосохранений.`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        schema_id: {
+          type: "string",
+          description: "ID схемы",
+        },
+        comment: {
+          type: "string",
+          description: "Комментарий к версии (опционально, но рекомендуется)",
+        },
       },
       required: ["schema_id"],
     },
@@ -2197,7 +2342,7 @@ URL: ${API_BASE_URL}/canvas?schema=${result.schema.id}${warningsText}`,
     }
 
     case "export_schema_to_json": {
-      const { schema_id, format = "full" } = args;
+      const { schema_id, format = "full", file_path } = args;
 
       // Получаем схему
       const result = await apiRequest(`/schemas/${schema_id}`);
@@ -2208,7 +2353,6 @@ URL: ${API_BASE_URL}/canvas?schema=${result.schema.id}${warningsText}`,
       const tagsDictionary = schema.data?.tagsDictionary || [];
 
       let exportData;
-      let exportText;
 
       switch (format) {
         case "compact":
@@ -2220,7 +2364,6 @@ URL: ${API_BASE_URL}/canvas?schema=${result.schema.id}${warningsText}`,
             connections,
             tagsDictionary,
           };
-          exportText = `Компактный экспорт схемы "${schema.name}":\n\n\`\`\`json\n${JSON.stringify(exportData, null, 2)}\n\`\`\``;
           break;
 
         case "elements_only":
@@ -2242,7 +2385,6 @@ URL: ${API_BASE_URL}/canvas?schema=${result.schema.id}${warningsText}`,
           if (tagsDictionary.length > 0) {
             exportData.tagsDictionary = tagsDictionary;
           }
-          exportText = `Элементы схемы "${schema.name}" (локальный формат):\n\n\`\`\`json\n${JSON.stringify(exportData, null, 2)}\n\`\`\``;
           break;
 
         case "full":
@@ -2262,10 +2404,52 @@ URL: ${API_BASE_URL}/canvas?schema=${result.schema.id}${warningsText}`,
               tagsDictionary,
             },
           };
-          exportText = `Полный экспорт схемы "${schema.name}":\n\n\`\`\`json\n${JSON.stringify(exportData, null, 2)}\n\`\`\``;
           break;
       }
 
+      // Если указан file_path — сохраняем в файл
+      if (file_path) {
+        const fs = require('fs');
+        const path = require('path');
+
+        // Создаём директорию если не существует
+        const dir = path.dirname(file_path);
+        if (!fs.existsSync(dir)) {
+          fs.mkdirSync(dir, { recursive: true });
+        }
+
+        // Сохраняем JSON в файл
+        const jsonContent = JSON.stringify(exportData, null, 2);
+        fs.writeFileSync(file_path, jsonContent, 'utf8');
+
+        const fileSizeKB = Math.round(jsonContent.length / 1024);
+
+        return {
+          content: [{
+            type: "text",
+            text: `✅ Схема "${schema.name}" экспортирована в файл!
+
+📁 Путь: ${file_path}
+📊 Размер: ${fileSizeKB}KB
+
+Статистика:
+• Элементов: ${elements.length}
+• Связей: ${connections.length}
+• Тегов: ${tagsDictionary.length}
+
+Используй Read tool чтобы прочитать файл, или import_schema_from_json с file_path для импорта в другую схему.`,
+          }],
+        };
+      }
+
+      // Без file_path — возвращаем JSON в ответе (как раньше)
+      const formatNames = {
+        full: "Полный экспорт",
+        compact: "Компактный экспорт",
+        elements_only: "Элементы"
+      };
+      const exportText = `${formatNames[format] || "Экспорт"} схемы "${schema.name}":\n\n\`\`\`json\n${JSON.stringify(exportData, null, 2)}\n\`\`\``;
+
       return {
         content: [{
           type: "text",
@@ -2278,13 +2462,178 @@ URL: ${API_BASE_URL}/canvas?schema=${result.schema.id}${warningsText}`,
 • Тегов: ${tagsDictionary.length}
 
 Этот JSON можно:
-• Сохранить в файл
+• Сохранить в файл (укажи file_path в следующий раз!)
 • Импортировать через import_schema_from_json
 • Передать в другую систему`,
         }],
       };
     }
 
+    // ========== ВЕРСИИ ==========
+    case "list_versions": {
+      const { schema_id, limit = 50, offset = 0 } = args;
+
+      const result = await apiRequest(`/schemas/${schema_id}/versions?limit=${Math.min(limit, 100)}&offset=${offset}`);
+
+      if (!result.versions || result.versions.length === 0) {
+        return {
+          content: [{
+            type: "text",
+            text: `История схемы пуста.
+
+Версии создаются автоматически при каждом сохранении схемы.
+Также можно создать ручную версию (checkpoint) с помощью create_version.`,
+          }],
+        };
+      }
+
+      const versionsList = result.versions.map(v => {
+        const date = new Date(v.createdAt);
+        const dateStr = date.toLocaleDateString('ru-RU');
+        const timeStr = date.toLocaleTimeString('ru-RU', { hour: '2-digit', minute: '2-digit' });
+        const typeLabel = v.isManual ? '📌 Ручная' : '⏱️ Авто';
+        const commentText = v.comment ? ` — "${v.comment}"` : '';
+        return `#${v.versionNumber} | ${dateStr} ${timeStr} | ${typeLabel} | ${v.elementsCount} элем.${commentText}\n   ID: ${v.id}`;
+      });
+
+      return {
+        content: [{
+          type: "text",
+          text: `📜 История схемы (${result.versions.length} из ${result.total} версий)
+
+${versionsList.join('\n\n')}
+
+${result.hasMore ? `\n⏩ Есть ещё версии. Используй offset=${offset + result.versions.length} для продолжения.` : ''}
+
+Команды:
+• get_version — посмотреть содержимое версии
+• restore_version — восстановить схему из версии
+• create_version — создать ручную версию (checkpoint)`,
+        }],
+      };
+    }
+
+    case "get_version": {
+      const { schema_id, version_id } = args;
+
+      const result = await apiRequest(`/schemas/${schema_id}/versions/${version_id}`);
+      const version = result.version;
+
+      // Парсим данные версии
+      let versionData = {};
+      try {
+        versionData = JSON.parse(version.data);
+      } catch (e) {
+        versionData = { elements: [], connections: [] };
+      }
+
+      const elementsCount = versionData.elements?.length || 0;
+      const connectionsCount = versionData.connections?.length || 0;
+      const dataSize = version.data?.length || 0;
+      const isLargeVersion = dataSize > 50000 || elementsCount > 100;
+
+      const date = new Date(version.createdAt);
+      const dateStr = date.toLocaleDateString('ru-RU');
+      const timeStr = date.toLocaleTimeString('ru-RU', { hour: '2-digit', minute: '2-digit' });
+      const typeLabel = version.isManual ? '📌 Ручная версия' : '⏱️ Автосохранение';
+
+      let elementsText;
+      if (isLargeVersion) {
+        const previewElements = (versionData.elements || []).slice(0, 5);
+        elementsText = `⚠️ Большая версия: ${elementsCount} элементов, ~${Math.round(dataSize / 1024)}KB
+
+Первые 5 элементов:
+${JSON.stringify(previewElements, null, 2)}`;
+      } else {
+        elementsText = JSON.stringify(versionData.elements || [], null, 2);
+      }
+
+      return {
+        content: [{
+          type: "text",
+          text: `📋 Версия #${version.versionNumber}
+
+ID версии: ${version.id}
+Тип: ${typeLabel}
+Дата: ${dateStr} ${timeStr}
+${version.comment ? `Комментарий: "${version.comment}"` : ''}
+
+Статистика:
+• Элементов: ${elementsCount}
+• Связей: ${connectionsCount}
+• Размер: ~${Math.round(dataSize / 1024)}KB
+
+Элементы:
+${elementsText}
+
+Команды:
+• restore_version — восстановить схему из этой версии
+• list_versions — вернуться к списку версий`,
+        }],
+      };
+    }
+
+    case "restore_version": {
+      const { schema_id, version_id } = args;
+
+      const result = await apiRequest(`/schemas/${schema_id}/versions/${version_id}/restore`, {
+        method: "POST",
+      });
+
+      const restored = result.restoredVersion;
+      const date = new Date(restored.createdAt);
+      const dateStr = date.toLocaleDateString('ru-RU');
+      const timeStr = date.toLocaleTimeString('ru-RU', { hour: '2-digit', minute: '2-digit' });
+
+      return {
+        content: [{
+          type: "text",
+          text: `✅ Схема восстановлена!
+
+Восстановлено из версии #${restored.versionNumber}
+Дата версии: ${dateStr} ${timeStr}
+
+⚠️ Перед восстановлением была автоматически создана резервная копия текущего состояния.
+
+URL: ${API_BASE_URL}/canvas?schema=${schema_id}
+
+Совет: используй list_versions чтобы увидеть обновлённую историю.`,
+        }],
+      };
+    }
+
+    case "create_version": {
+      const { schema_id, comment } = args;
+
+      const result = await apiRequest(`/schemas/${schema_id}/versions`, {
+        method: "POST",
+        body: JSON.stringify({
+          isManual: true,
+          comment: comment || null,
+        }),
+      });
+
+      const version = result.version;
+      const date = new Date(version.createdAt);
+      const dateStr = date.toLocaleDateString('ru-RU');
+      const timeStr = date.toLocaleTimeString('ru-RU', { hour: '2-digit', minute: '2-digit' });
+
+      return {
+        content: [{
+          type: "text",
+          text: `✅ Ручная версия создана!
+
+Версия: #${version.versionNumber}
+Дата: ${dateStr} ${timeStr}
+${version.comment ? `Комментарий: "${version.comment}"` : ''}
+
+📌 Ручные версии не удаляются при очистке старых автосохранений.
+
+Используй restore_version чтобы восстановить схему из этой версии в будущем.`,
+        }],
+      };
+    }
+
     default:
       throw new Error(`Неизвестная команда: ${name}`);
   }
@@ -2323,7 +2672,7 @@ async function main() {
   const server = new Server(
     {
       name: "schemeog-mcp",
-      version: "2.9.3",
+      version: "3.0.0",
     },
     {
       capabilities: {
@@ -2353,7 +2702,7 @@ async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
 
-  console.error("SchemeOG MCP Server v2.9.3 запущен");
+  console.error("SchemeOG MCP Server v3.0.0 запущен");
 }
 
 main().catch(console.error);

package/package.json

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