schemeog-mcp 3.0.1 → 3.1.1

package/README.md

@@ -1,4 +1,4 @@
-# SchemeOG MCP Server v2.9
+# SchemeOG MCP Server v3.1
 
 MCP server for [Diagrams.love](https://diagrams.love) — create diagrams and flowcharts with AI.
 
@@ -8,6 +8,8 @@ MCP server for [Diagrams.love](https://diagrams.love) — create diagrams and fl
 - **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
+- **Shared links support**: Open schemas via public `/shared/` URLs (read-only)
+- **Large schema handling**: Automatic detection and preview for schemas >100 elements
 
 ## 17 Commands
 
@@ -248,15 +250,38 @@ When you edit a schema via MCP while viewing it in the browser:
 You can open any schema by URL using `get_schema_by_url`:
 
 ```
-# Canvas URL (основной формат)
+# Canvas URL (main format) — full access
 https://diagrams.love/canvas?schema=abc123
 
-# Shared link
+# Shared link — read-only access
 https://diagrams.love/shared/xyz789
 ```
 
 Just paste the URL and the MCP will extract the schema ID automatically.
 
+### Shared Links (Read-Only)
+
+When you open a schema via `/shared/` URL:
+- ✅ You can **view** the schema content
+- ✅ You can **analyze** the structure
+- ✅ You can **count** elements and connections
+- ❌ You **cannot edit** — need access to original schema
+
+This is useful for:
+- Analyzing schemas shared by others
+- Answering questions about schema structure
+- Getting inspiration for your own diagrams
+
+## Large Schema Handling
+
+For schemas with >100 elements or >50KB data:
+
+- `get_schema` shows first 5 elements as preview
+- `get_schema_by_url` shows statistics only
+- Full data available via `export_schema_to_json`
+
+This prevents context overflow in Claude Code when working with large diagrams.
+
 ## Schema Methodology
 
 Schema = complete tree of **ACTIONS** and **CONSEQUENCES**:

package/index.js

@@ -560,8 +560,11 @@ const TOOLS = [
 - https://diagrams.love/canvas?schema=ID (основной формат)
 - diagrams.love/canvas?schema=ID
 - https://diagrams.love/canvas?id=ID (устаревший)
+- https://diagrams.love/shared/TOKEN (публичная ссылка)
+- https://scheme.smartlaunchhub.com/... (старый домен)
 
 Автоматически извлекает ID схемы из URL и проверяет доступ.
+Для публичных ссылок (/shared/) использует специальный API эндпоинт.
 Если у пользователя есть доступ к схеме — возвращает полные данные.
 Если доступа нет — возвращает ошибку.
 
@@ -1150,6 +1153,10 @@ Claude урезает большие параметры, но file_path чита
  * - https://diagrams.love/canvas?schema=ID (основной)
  * - diagrams.love/canvas?schema=ID
  * - https://diagrams.love/canvas?id=ID (устаревший)
+ * - https://diagrams.love/shared/TOKEN (публичная ссылка)
+ * - https://scheme.smartlaunchhub.com/... (старый домен)
+ *
+ * Возвращает: { id, type } где type = "schema" | "shared"
  */
 function extractSchemaIdFromUrl(url) {
   if (!url || typeof url !== "string") return null;
@@ -1165,18 +1172,39 @@ function extractSchemaIdFromUrl(url) {
 
     // Проверяем что это наш домен
     if (!urlObj.hostname.includes("diagrams.love") &&
+        !urlObj.hostname.includes("smartlaunchhub.com") &&
         !urlObj.hostname.includes("localhost")) {
       return null;
     }
 
+    // Формат /shared/TOKEN — публичная ссылка
+    const sharedMatch = urlObj.pathname.match(/^\/shared\/([a-zA-Z0-9_-]+)/);
+    if (sharedMatch) {
+      return { id: sharedMatch[1], type: "shared" };
+    }
+
     // Извлекаем ID из query параметров
     const schemaId = urlObj.searchParams.get("schema") || urlObj.searchParams.get("id");
 
-    return schemaId || null;
+    if (schemaId) {
+      return { id: schemaId, type: "schema" };
+    }
+
+    return null;
   } catch (e) {
-    // Пробуем простой regex для извлечения
-    const match = url.match(/[?&](schema|id)=([a-zA-Z0-9_-]+)/);
-    return match ? match[2] : null;
+    // Пробуем regex для /shared/ формата
+    const sharedMatch = url.match(/\/shared\/([a-zA-Z0-9_-]+)/);
+    if (sharedMatch) {
+      return { id: sharedMatch[1], type: "shared" };
+    }
+
+    // Пробуем простой regex для query параметров
+    const queryMatch = url.match(/[?&](schema|id)=([a-zA-Z0-9_-]+)/);
+    if (queryMatch) {
+      return { id: queryMatch[2], type: "schema" };
+    }
+
+    return null;
   }
 }
 
@@ -1302,6 +1330,38 @@ async function handleTool(name, args) {
 
       const schema = result.schema;
 
+      // Проверяем размер данных для предупреждения о больших схемах
+      const elementsCount = schema.data?.elements?.length || 0;
+      const connectionsCount = schema.data?.connections?.length || 0;
+      const dataSize = JSON.stringify(schema.data || {}).length;
+      const isLargeSchema = dataSize > 50000 || elementsCount > 100;
+
+      // Формируем вывод в зависимости от размера
+      let elementsText, connectionsText, sizeWarning;
+
+      if (isLargeSchema) {
+        // Большая схема — выводим только краткую статистику и первые элементы
+        const previewElements = (schema.data?.elements || []).slice(0, 5);
+        elementsText = `⚠️ БОЛЬШАЯ СХЕМА: ${elementsCount} элементов, ~${Math.round(dataSize / 1024)}KB
+
+Первые 5 элементов (для предпросмотра):
+${JSON.stringify(previewElements, null, 2)}
+
+Для получения полных данных используй:
+• export_schema_to_json с format="compact" — выгрузит JSON
+• export_schema_to_json с format="elements_only" — только элементы`;
+
+        connectionsText = `[${connectionsCount} связей — используй export_schema_to_json для полного списка]`;
+
+        sizeWarning = `\n\n⚠️ ВНИМАНИЕ: Схема содержит ${elementsCount} элементов (~${Math.round(dataSize / 1024)}KB).
+Полный вывод может переполнить контекст!
+Для работы с большими схемами рекомендуется использовать export_schema_to_json.`;
+      } else {
+        elementsText = JSON.stringify(schema.data?.elements || [], null, 2);
+        connectionsText = JSON.stringify(schema.data?.connections || [], null, 2);
+        sizeWarning = "";
+      }
+
       return {
         content: [{
           type: "text",
@@ -1310,15 +1370,16 @@ async function handleTool(name, args) {
 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}
+Элементов: ${elementsCount}
+Связей: ${connectionsCount}
+Размер данных: ~${Math.round(dataSize / 1024)}KB
+URL: ${API_BASE_URL}/canvas?schema=${schema.id}${sizeWarning}
 
 Элементы:
-${JSON.stringify(schema.data?.elements || [], null, 2)}
+${elementsText}
 
 Связи:
-${JSON.stringify(schema.data?.connections || [], null, 2)}`,
+${connectionsText}`,
         }],
       };
     }
@@ -1327,20 +1388,56 @@ ${JSON.stringify(schema.data?.connections || [], null, 2)}`,
       const { url } = args;
 
       // Извлекаем ID из URL
-      const schemaId = extractSchemaIdFromUrl(url);
+      const urlInfo = extractSchemaIdFromUrl(url);
 
-      if (!schemaId) {
+      if (!urlInfo) {
         const error = createError(
           ErrorCodes.VALIDATION_ERROR,
-          `Не удалось извлечь ID схемы из URL: "${url}"\n\nПоддерживаемые форматы:\n• https://diagrams.love/canvas?schema=ID\n• https://diagrams.love/canvas?id=ID`
+          `Не удалось извлечь ID схемы из URL: "${url}"\n\nПоддерживаемые форматы:\n• https://diagrams.love/canvas?schema=ID\n• https://diagrams.love/canvas?id=ID\n• https://diagrams.love/shared/TOKEN`
         );
         throw new Error(error.message);
       }
 
-      // Получаем схему по ID (проверка доступа происходит на сервере)
-      const result = await apiRequest(`/schemas/${schemaId}`);
+      let result;
+      let isSharedLink = false;
+
+      if (urlInfo.type === "shared") {
+        // Публичная ссылка — используем специальный API эндпоинт
+        result = await apiRequest(`/schemas/shared/${urlInfo.id}`);
+        isSharedLink = true;
+      } else {
+        // Обычная ссылка — получаем схему по ID
+        result = await apiRequest(`/schemas/${urlInfo.id}`);
+      }
+
       const schema = result.schema;
 
+      // Проверяем размер данных для предупреждения о больших схемах
+      const elementsCount = schema.data?.elements?.length || 0;
+      const connectionsCount = schema.data?.connections?.length || 0;
+      const dataSize = JSON.stringify(schema.data || {}).length;
+      const isLargeSchema = dataSize > 50000 || elementsCount > 100;
+
+      // Формируем вывод в зависимости от размера
+      let elementsText, connectionsText;
+
+      if (isLargeSchema) {
+        // Большая схема — выводим только краткую статистику
+        elementsText = `[Схема слишком большая для полного вывода: ${elementsCount} элементов, ~${Math.round(dataSize / 1024)}KB]
+
+Для работы с большой схемой используй:
+• export_schema_to_json с format="compact" для получения данных в файл
+• Редактируй отдельные элементы через replace_schema`;
+        connectionsText = `[${connectionsCount} связей]`;
+      } else {
+        elementsText = JSON.stringify(schema.data?.elements || [], null, 2);
+        connectionsText = JSON.stringify(schema.data?.connections || [], null, 2);
+      }
+
+      const accessNote = isSharedLink
+        ? "\n⚠️ Это публичная ссылка. Для редактирования нужен доступ к оригинальной схеме."
+        : "";
+
       return {
         content: [{
           type: "text",
@@ -1351,15 +1448,16 @@ ${JSON.stringify(schema.data?.connections || [], null, 2)}`,
 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}
+Элементов: ${elementsCount}
+Связей: ${connectionsCount}
+Размер данных: ~${Math.round(dataSize / 1024)}KB
+URL: ${API_BASE_URL}/canvas?schema=${schema.id}${accessNote}
 
 Элементы:
-${JSON.stringify(schema.data?.elements || [], null, 2)}
+${elementsText}
 
 Связи:
-${JSON.stringify(schema.data?.connections || [], null, 2)}
+${connectionsText}
 
 Теперь ты можешь:
 • Редактировать схему с помощью replace_schema (schema_id: "${schema.id}")

package/package.json

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