schemeog-mcp 2.0.0

package/README.md

@@ -0,0 +1,133 @@
+# SchemeOG MCP Server v2.0
+
+MCP сервер для [SchemeOG Cloud](https://scheme.smartlaunchhub.com) — создавай диаграммы и схемы с помощью AI.
+
+## 5 команд — всё что нужно
+
+| Команда | Описание |
+|---------|----------|
+| `list_schemas` | Список всех схем |
+| `get_schema` | Получить схему с данными |
+| `create_schema` | Создать новую схему |
+| `replace_schema` | Заменить содержимое схемы |
+| `delete_schema` | Удалить схему |
+
+## Установка
+
+### Через npx (рекомендуется)
+
+```bash
+npx schemeog-cloud-mcp
+```
+
+## Настройка
+
+### 1. Получи токен
+
+1. Открой https://scheme.smartlaunchhub.com
+2. Войди по email
+3. DevTools (F12) → Application → Local Storage
+4. Скопируй значение `token`
+
+### 2. Добавь в Claude Code / Cline
+
+В `~/.claude.json` (или настройки Cline):
+
+```json
+{
+  "mcpServers": {
+    "schemeog": {
+      "command": "npx",
+      "args": ["-y", "schemeog-cloud-mcp"],
+      "env": {
+        "SCHEMEOG_TOKEN": "твой-jwt-токен"
+      }
+    }
+  }
+}
+```
+
+## Примеры использования
+
+### Создать схему
+
+```
+Создай схему "User Registration Flow" с блоками:
+- Форма регистрации
+- Валидация
+- Сохранение в БД
+- Отправка email
+- Успех
+```
+
+AI сгенерирует:
+
+```json
+{
+  "name": "User Registration Flow",
+  "elements": [
+    {"id": "1", "type": "block", "x": 100, "y": 100, "text": "Форма регистрации"},
+    {"id": "2", "type": "block", "x": 300, "y": 100, "text": "Валидация"},
+    {"id": "3", "type": "block", "x": 500, "y": 100, "text": "Сохранение в БД"},
+    {"id": "4", "type": "block", "x": 700, "y": 100, "text": "Отправка email"},
+    {"id": "5", "type": "block", "x": 900, "y": 100, "text": "Успех"}
+  ],
+  "connections": [
+    {"from": "1", "to": "2"},
+    {"from": "2", "to": "3"},
+    {"from": "3", "to": "4"},
+    {"from": "4", "to": "5"}
+  ]
+}
+```
+
+### Обновить схему
+
+```
+Добавь в схему блок "Обработка ошибок" после валидации
+```
+
+AI получит текущую схему, добавит блок и связи, отправит обновление.
+
+### Посмотреть схемы
+
+```
+Покажи мои схемы
+```
+
+## Формат данных
+
+### Элемент
+
+```json
+{
+  "id": "unique_id",
+  "type": "block",       // block, note, group
+  "x": 100,              // X координата
+  "y": 100,              // Y координата
+  "text": "Текст",       // содержимое
+  "width": 200,          // ширина (опционально)
+  "height": 100,         // высота (опционально)
+  "color": "#E3F2FD"     // цвет фона (опционально)
+}
+```
+
+### Связь
+
+```json
+{
+  "from": "id1",         // ID источника
+  "to": "id2",           // ID назначения
+  "label": "текст",      // подпись (опционально)
+  "style": "solid"       // solid, dashed, dotted
+}
+```
+
+## Ссылки
+
+- [SchemeOG Cloud](https://scheme.smartlaunchhub.com)
+- [GitLab](https://gitlab.com/serter2069/schemeog-cloud)
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,491 @@
+#!/usr/bin/env node
+
+/**
+ * SchemeOG Cloud MCP Server v2.0
+ *
+ * Минималистичный MCP сервер для работы со схемами.
+ * 5 команд — максимум мощи, минимум сложности.
+ *
+ * Команды:
+ * - list_schemas: Список всех схем
+ * - get_schema: Получить схему с данными
+ * - create_schema: Создать схему (с элементами и связями)
+ * - replace_schema: Полностью заменить содержимое схемы
+ * - delete_schema: Удалить схему
+ */
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+
+// Конфигурация
+const API_BASE_URL = process.env.SCHEMEOG_API_URL || "https://scheme.smartlaunchhub.com";
+const AUTH_TOKEN = process.env.SCHEMEOG_TOKEN || "";
+
+/**
+ * Выполнить запрос к API SchemeOG
+ */
+async function apiRequest(endpoint, options = {}) {
+  const url = `${API_BASE_URL}/api${endpoint}`;
+
+  const headers = {
+    "Content-Type": "application/json",
+    ...(AUTH_TOKEN && { "Authorization": `Bearer ${AUTH_TOKEN}` }),
+    ...options.headers,
+  };
+
+  try {
+    const response = await fetch(url, {
+      ...options,
+      headers,
+    });
+
+    const data = await response.json();
+
+    if (!response.ok) {
+      throw new Error(data.message || data.error || `HTTP ${response.status}`);
+    }
+
+    return data;
+  } catch (error) {
+    throw new Error(`API Error: ${error.message}`);
+  }
+}
+
+/**
+ * Генерация уникального ID для элементов
+ */
+function generateId() {
+  return `el_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+}
+
+/**
+ * Подготовить элементы — добавить ID если нет
+ */
+function prepareElements(elements) {
+  if (!elements) return [];
+  return elements.map(el => ({
+    id: el.id || generateId(),
+    type: el.type || "block",
+    x: el.x || 0,
+    y: el.y || 0,
+    text: el.text || "",
+    ...el
+  }));
+}
+
+/**
+ * Подготовить связи — добавить ID если нет
+ */
+function prepareConnections(connections) {
+  if (!connections) return [];
+  return connections.map(conn => ({
+    id: conn.id || generateId(),
+    ...conn
+  }));
+}
+
+/**
+ * 5 основных инструментов MCP
+ */
+const TOOLS = [
+  {
+    name: "list_schemas",
+    description: `Получить список всех схем пользователя.
+
+Возвращает: ID, название, описание, дату обновления каждой схемы.
+
+Используй эту команду чтобы узнать какие схемы есть у пользователя.`,
+    inputSchema: {
+      type: "object",
+      properties: {},
+      required: [],
+    },
+  },
+  {
+    name: "get_schema",
+    description: `Получить полные данные схемы по ID.
+
+Возвращает:
+- name: название схемы
+- description: описание
+- elements: массив элементов (блоки, заметки, группы)
+- connections: массив связей между элементами
+
+Каждый элемент содержит: id, type, x, y, text, width, height, color
+Каждая связь содержит: id, from, to, label, style`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        schema_id: {
+          type: "string",
+          description: "ID схемы (UUID)",
+        },
+      },
+      required: ["schema_id"],
+    },
+  },
+  {
+    name: "create_schema",
+    description: `Создать новую схему с элементами и связями.
+
+ВАЖНО: Генерируй сразу полную схему с elements и connections!
+
+Параметры:
+- name: название схемы (обязательно)
+- description: описание
+- elements: массив элементов
+- connections: массив связей
+
+Формат элемента:
+{
+  "id": "node1",           // уникальный ID (можно не указывать - сгенерируется)
+  "type": "block",         // block, note, group
+  "x": 100,                // координата X
+  "y": 100,                // координата Y
+  "text": "Текст блока",   // текст внутри
+  "width": 200,            // ширина (опционально)
+  "height": 100,           // высота (опционально)
+  "color": "#E3F2FD"       // цвет фона (опционально)
+}
+
+Формат связи:
+{
+  "from": "node1",         // ID элемента-источника
+  "to": "node2",           // ID элемента-назначения
+  "label": "подпись",      // текст на связи (опционально)
+  "style": "solid"         // solid, dashed, dotted (опционально)
+}
+
+Пример: создать схему с 3 блоками и 2 связями:
+{
+  "name": "User Flow",
+  "elements": [
+    {"id": "1", "type": "block", "x": 100, "y": 100, "text": "Login"},
+    {"id": "2", "type": "block", "x": 300, "y": 100, "text": "Dashboard"},
+    {"id": "3", "type": "block", "x": 500, "y": 100, "text": "Settings"}
+  ],
+  "connections": [
+    {"from": "1", "to": "2", "label": "success"},
+    {"from": "2", "to": "3"}
+  ]
+}`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: {
+          type: "string",
+          description: "Название схемы",
+        },
+        description: {
+          type: "string",
+          description: "Описание схемы",
+        },
+        elements: {
+          type: "array",
+          description: "Массив элементов схемы",
+          items: {
+            type: "object",
+            properties: {
+              id: { type: "string" },
+              type: { type: "string", enum: ["block", "note", "group"] },
+              x: { type: "number" },
+              y: { type: "number" },
+              text: { type: "string" },
+              width: { type: "number" },
+              height: { type: "number" },
+              color: { type: "string" },
+            },
+          },
+        },
+        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"],
+          },
+        },
+      },
+      required: ["name"],
+    },
+  },
+  {
+    name: "replace_schema",
+    description: `Полностью заменить содержимое существующей схемы.
+
+Используй когда нужно:
+- Обновить схему новыми данными
+- Добавить/удалить элементы
+- Изменить связи
+
+ВАЖНО: Эта команда ЗАМЕНЯЕТ все данные схемы!
+Сначала получи текущую схему через get_schema,
+модифицируй данные, затем отправь через replace_schema.
+
+Параметры:
+- schema_id: ID схемы (обязательно)
+- name: новое название (опционально)
+- description: новое описание (опционально)
+- elements: новый массив элементов (опционально)
+- connections: новый массив связей (опционально)
+
+Если elements или connections не указаны - они останутся прежними.`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        schema_id: {
+          type: "string",
+          description: "ID схемы для обновления",
+        },
+        name: {
+          type: "string",
+          description: "Новое название схемы",
+        },
+        description: {
+          type: "string",
+          description: "Новое описание схемы",
+        },
+        elements: {
+          type: "array",
+          description: "Новый массив элементов (заменяет все существующие)",
+          items: { type: "object" },
+        },
+        connections: {
+          type: "array",
+          description: "Новый массив связей (заменяет все существующие)",
+          items: { type: "object" },
+        },
+      },
+      required: ["schema_id"],
+    },
+  },
+  {
+    name: "delete_schema",
+    description: `Удалить схему по ID.
+
+ВНИМАНИЕ: Это действие необратимо! Схема будет удалена навсегда.`,
+    inputSchema: {
+      type: "object",
+      properties: {
+        schema_id: {
+          type: "string",
+          description: "ID схемы для удаления",
+        },
+      },
+      required: ["schema_id"],
+    },
+  },
+];
+
+/**
+ * Обработчики инструментов
+ */
+async function handleTool(name, args) {
+  switch (name) {
+    // ========== LIST SCHEMAS ==========
+    case "list_schemas": {
+      const result = await apiRequest("/schemas");
+
+      if (!result.schemas || result.schemas.length === 0) {
+        return {
+          content: [{
+            type: "text",
+            text: "Схемы не найдены.\n\nСоздай первую схему с помощью create_schema.",
+          }],
+        };
+      }
+
+      const schemasList = result.schemas.map(s => ({
+        id: s.id,
+        name: s.name,
+        description: s.description || "",
+        updatedAt: s.updatedAt,
+        elementsCount: s.data?.elements?.length || 0,
+        connectionsCount: s.data?.connections?.length || 0,
+      }));
+
+      return {
+        content: [{
+          type: "text",
+          text: `Найдено ${schemasList.length} схем:\n\n${JSON.stringify(schemasList, null, 2)}`,
+        }],
+      };
+    }
+
+    // ========== GET SCHEMA ==========
+    case "get_schema": {
+      const { schema_id } = args;
+      const result = await apiRequest(`/schemas/${schema_id}`);
+
+      const schema = result.schema;
+
+      return {
+        content: [{
+          type: "text",
+          text: `Схема "${schema.name}"
+
+ID: ${schema.id}
+Описание: ${schema.description || "(нет)"}
+Элементов: ${schema.data?.elements?.length || 0}
+Связей: ${schema.data?.connections?.length || 0}
+URL: ${API_BASE_URL}/canvas?id=${schema.id}
+
+Элементы:
+${JSON.stringify(schema.data?.elements || [], null, 2)}
+
+Связи:
+${JSON.stringify(schema.data?.connections || [], null, 2)}`,
+        }],
+      };
+    }
+
+    // ========== CREATE SCHEMA ==========
+    case "create_schema": {
+      const { name, description, elements, connections } = args;
+
+      const data = {
+        elements: prepareElements(elements),
+        connections: prepareConnections(connections),
+        tagsDictionary: [],
+      };
+
+      const result = await apiRequest("/schemas", {
+        method: "POST",
+        body: JSON.stringify({ name, description, data }),
+      });
+
+      return {
+        content: [{
+          type: "text",
+          text: `Схема "${result.schema.name}" создана!
+
+ID: ${result.schema.id}
+Элементов: ${data.elements.length}
+Связей: ${data.connections.length}
+
+URL: ${API_BASE_URL}/canvas?id=${result.schema.id}
+
+Открой ссылку в браузере чтобы увидеть схему.`,
+        }],
+      };
+    }
+
+    // ========== REPLACE SCHEMA ==========
+    case "replace_schema": {
+      const { schema_id, name, description, elements, connections } = args;
+
+      // Получаем текущую схему
+      const currentResult = await apiRequest(`/schemas/${schema_id}`);
+      const currentSchema = currentResult.schema;
+      const currentData = currentSchema.data || { elements: [], connections: [], tagsDictionary: [] };
+
+      // Формируем обновление
+      const updateBody = {};
+
+      if (name) updateBody.name = name;
+      if (description !== undefined) updateBody.description = description;
+
+      // Обновляем данные только если переданы
+      const newData = { ...currentData };
+      if (elements !== undefined) {
+        newData.elements = prepareElements(elements);
+      }
+      if (connections !== undefined) {
+        newData.connections = prepareConnections(connections);
+      }
+      updateBody.data = newData;
+
+      const result = await apiRequest(`/schemas/${schema_id}`, {
+        method: "PUT",
+        body: JSON.stringify(updateBody),
+      });
+
+      return {
+        content: [{
+          type: "text",
+          text: `Схема "${result.schema.name}" обновлена!
+
+Элементов: ${result.schema.data?.elements?.length || 0}
+Связей: ${result.schema.data?.connections?.length || 0}
+
+URL: ${API_BASE_URL}/canvas?id=${schema_id}`,
+        }],
+      };
+    }
+
+    // ========== DELETE SCHEMA ==========
+    case "delete_schema": {
+      const { schema_id } = args;
+
+      await apiRequest(`/schemas/${schema_id}`, {
+        method: "DELETE",
+      });
+
+      return {
+        content: [{
+          type: "text",
+          text: `Схема удалена.`,
+        }],
+      };
+    }
+
+    default:
+      throw new Error(`Неизвестная команда: ${name}`);
+  }
+}
+
+/**
+ * Запуск MCP сервера
+ */
+async function main() {
+  if (!AUTH_TOKEN) {
+    console.error("⚠️  SCHEMEOG_TOKEN не установлен. Укажите токен в переменной окружения.");
+  }
+
+  const server = new Server(
+    {
+      name: "schemeog-mcp",
+      version: "2.0.0",
+    },
+    {
+      capabilities: {
+        tools: {},
+      },
+    }
+  );
+
+  server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return { tools: TOOLS };
+  });
+
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    try {
+      return await handleTool(request.params.name, request.params.arguments || {});
+    } catch (error) {
+      return {
+        content: [{
+          type: "text",
+          text: `Ошибка: ${error.message}`,
+        }],
+        isError: true,
+      };
+    }
+  });
+
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+
+  console.error("SchemeOG MCP Server v2.0 запущен");
+}
+
+main().catch(console.error);

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "schemeog-mcp",
+  "version": "2.0.0",
+  "description": "MCP Server for SchemeOG Cloud - Create and manage visual diagrams and flowcharts with AI assistance",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "schemeog-mcp": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js",
+    "prepublishOnly": "echo 'Ready to publish'"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "anthropic",
+    "ai",
+    "diagrams",
+    "flowcharts",
+    "schemas",
+    "visualization",
+    "schemeog"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/serter2069/schemeog-cloud.git"
+  },
+  "homepage": "https://scheme.smartlaunchhub.com",
+  "bugs": {
+    "url": "https://gitlab.com/serter2069/schemeog-cloud/-/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "index.js",
+    "README.md"
+  ],
+  "author": {
+    "name": "Sergei Terekhov",
+    "email": "serter2069@gmail.com"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}