schemeog-mcp 2.2.0 → 2.2.1

package/README.md

@@ -1,58 +1,58 @@
-# SchemeOG MCP Server v2.1
+# SchemeOG MCP Server v2.2
 
-MCP сервер для [SchemeOG Cloud](https://scheme.smartlaunchhub.com) — создавай диаграммы и схемы с помощью AI.
+MCP server for [SchemeOG Cloud](https://scheme.smartlaunchhub.com) — create diagrams and flowcharts with AI.
 
-## 14 команд для полного контроля
+## 14 Commands
 
-### Схемы (5 команд)
+### Schemas (5 commands)
 
-| Команда | Описание |
-|---------|----------|
-| `list_schemas` | Список всех схем |
-| `get_schema` | Получить схему с данными |
-| `create_schema` | Создать новую схему |
-| `replace_schema` | Заменить содержимое схемы |
-| `delete_schema` | Удалить схему |
+| Command | Description |
+|---------|-------------|
+| `list_schemas` | List all schemas |
+| `get_schema` | Get schema with data |
+| `create_schema` | Create new schema |
+| `replace_schema` | Replace schema content |
+| `delete_schema` | Delete schema |
 
-### Проекты (5 команд)
+### Projects (5 commands)
 
-| Команда | Описание |
-|---------|----------|
-| `list_projects` | Список проектов (папок) |
-| `create_project` | Создать проект |
-| `update_project` | Обновить проект |
-| `delete_project` | Удалить проект |
-| `move_schema_to_project` | Переместить схему в проект |
+| Command | Description |
+|---------|-------------|
+| `list_projects` | List projects (folders) |
+| `create_project` | Create project |
+| `update_project` | Update project |
+| `delete_project` | Delete project |
+| `move_schema_to_project` | Move schema to project |
 
-### Теги (4 команды)
+### Tags (4 commands)
 
-| Команда | Описание |
-|---------|----------|
-| `list_tags` | Список тегов схемы |
-| `add_tag` | Добавить тег в схему |
-| `remove_tag` | Удалить тег из схемы |
-| `tag_element` | Присвоить/убрать тег с элемента |
+| Command | Description |
+|---------|-------------|
+| `list_tags` | List schema tags |
+| `add_tag` | Add tag to schema |
+| `remove_tag` | Remove tag from schema |
+| `tag_element` | Assign/remove tag from element |
 
-## Установка
+## Installation
 
-### Через npx (рекомендуется)
+### Via npx (recommended)
 
 ```bash
 npx schemeog-mcp
 ```
 
-## Настройка
+## Setup
 
-### 1. Получи токен
+### 1. Get your token
 
-1. Открой https://scheme.smartlaunchhub.com
-2. Войди по email
-3. Перейди в Профиль
-4. Скопируй токен из секции "Claude Code Integration"
+1. Open https://scheme.smartlaunchhub.com
+2. Sign in with email
+3. Go to Profile
+4. Copy token from "Claude Code Integration" section
 
-### 2. Добавь в Claude Code / Cline
+### 2. Add to Claude Code / Cline
 
-В `~/.claude.json` (или настройки Cline):
+In `~/.claude.json` (or Cline settings):
 
 ```json
 {
@@ -68,199 +68,154 @@ npx schemeog-mcp
 }
 ```
 
-## Формат данных схемы
+## Schema Data Format
 
-### Полный пример схемы
+### Full schema example
 
 ```json
 {
   "name": "User Registration Flow",
-  "description": "Процесс регистрации пользователя",
+  "description": "User registration process",
   "elements": [
     {
       "id": "start",
       "type": "card",
-      "title": "Форма регистрации",
+      "title": "Registration Form",
       "color": "light_green",
-      "borderColor": "green",
-      "tags": ["пользователь"],
-      "description": "Пользователь заполняет форму с email и паролем"
+      "tags": ["user"],
+      "description": "User fills in email and password"
     },
     {
       "id": "validate",
       "type": "condition",
-      "title": "Валидация данных",
+      "title": "Validate Data",
       "color": "light_yellow",
-      "borderColor": "yellow",
-      "tags": ["система", "проверка"],
-      "description": "Проверка корректности email и сложности пароля"
+      "tags": ["system", "check"],
+      "description": "Check email format and password strength"
     },
     {
       "id": "save",
       "type": "card",
-      "title": "Сохранение в БД",
+      "title": "Save to Database",
       "color": "light_blue",
-      "borderColor": "blue",
-      "tags": ["система"],
-      "description": "Создание записи пользователя в базе данных"
+      "tags": ["system"],
+      "description": "Create user record in database"
     },
     {
       "id": "error",
       "type": "card",
-      "title": "Ошибка валидации",
+      "title": "Validation Error",
       "color": "light_red",
-      "borderColor": "red",
-      "tags": ["система", "ошибка"],
-      "description": "Показать пользователю ошибки валидации"
+      "tags": ["system", "error"],
+      "description": "Show validation errors to user"
     },
     {
       "id": "success",
       "type": "card",
-      "title": "Успешная регистрация",
+      "title": "Registration Complete",
       "color": "light_green",
-      "borderColor": "green",
-      "tags": ["пользователь"],
-      "description": "Пользователь успешно зарегистрирован"
+      "tags": ["user"],
+      "description": "User successfully registered"
     }
   ],
   "connections": [
-    {"from": "start", "to": "validate", "label": "отправка формы"},
-    {"from": "validate", "to": "save", "label": "данные корректны"},
-    {"from": "validate", "to": "error", "label": "ошибка"},
+    {"from": "start", "to": "validate", "label": "submit"},
+    {"from": "validate", "to": "save", "label": "valid"},
+    {"from": "validate", "to": "error", "label": "invalid"},
     {"from": "save", "to": "success"},
-    {"from": "error", "to": "start", "label": "исправить"}
+    {"from": "error", "to": "start", "label": "retry"}
   ],
   "tagsDictionary": [
-    {"id": "tag-user", "name": "пользователь", "color": "#4CAF50"},
-    {"id": "tag-system", "name": "система", "color": "#2196F3"},
-    {"id": "tag-check", "name": "проверка", "color": "#FF9800"},
-    {"id": "tag-error", "name": "ошибка", "color": "#F44336"}
+    {"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"}
   ]
 }
 ```
 
-### Элемент (card или condition)
+### Element (card or condition)
 
 ```json
 {
   "id": "unique_id",
   "type": "card",
-  "title": "Название карточки",
+  "title": "Card Title",
   "color": "light_blue",
-  "borderColor": "blue",
-  "tags": ["тег1", "тег2"],
-  "description": "Подробное описание действия или процесса"
+  "tags": ["tag1", "tag2"],
+  "description": "Detailed description of the action or process"
 }
 ```
 
-**Типы элементов:**
-- `card` — обычная карточка процесса/действия
-- `condition` — точка принятия решения (ромб)
+**Element types:**
+- `card` — regular process/action card
+- `condition` — decision point (diamond shape)
 
-**Доступные цвета фона (`color`):**
-| Цвет | Назначение |
-|------|------------|
-| `white` | Базовый белый |
-| `light_blue` | Основные процессы |
-| `light_green` | Старт и успех |
-| `light_yellow` | Проверки и условия |
-| `light_orange` | Предупреждения |
-| `light_red` | Ошибки и критичное |
-| `light_purple` | Решения |
-| `light_gray` | Завершение |
-| `light_pink` | Дополнительные процессы |
-| `light_teal` | Специальные операции |
+**Available colors (`color`):**
+| Color | Purpose |
+|-------|---------|
+| `white` | Default white |
+| `light_blue` | Main processes |
+| `light_green` | Start and success |
+| `light_yellow` | Checks and conditions |
+| `light_orange` | Warnings |
+| `light_red` | Errors and critical |
+| `light_purple` | Decisions |
+| `light_gray` | Completion |
+| `light_pink` | Additional processes |
+| `light_teal` | Special operations |
 
-**Цвета обводки (`borderColor`):**
-`default`, `blue`, `green`, `orange`, `purple`, `red`, `teal`, `yellow`, `gray`, `black`
+**Border colors (`borderColor`):** `default`, `blue`, `green`, `orange`, `purple`, `red`, `teal`, `yellow`, `gray`, `black`
 
-**Важно:** НЕ указывай `width`, `height`, `x`, `y` — они рассчитываются автоматически!
+**Important:** Do NOT specify `width`, `height`, `x`, `y` — they are calculated automatically!
 
-### Связь (connection)
+### Connection
 
 ```json
 {
   "from": "source_id",
   "to": "target_id",
-  "label": "подпись (опционально)",
+  "label": "optional label",
   "style": "solid"
 }
 ```
 
-**Стили линий (`style`):** `solid`, `dashed`, `dotted`
+**Line styles (`style`):** `solid`, `dashed`, `dotted`
 
-### Справочник тегов (tagsDictionary)
+### Tags Dictionary (tagsDictionary)
 
 ```json
 {
   "tagsDictionary": [
-    {"id": "tag-1", "name": "система", "color": "#2196F3"},
-    {"id": "tag-2", "name": "пользователь", "color": "#4CAF50"},
-    {"id": "tag-3", "name": "проверка", "color": "#FF9800"}
+    {"id": "tag-1", "name": "system", "color": "#2196F3"},
+    {"id": "tag-2", "name": "user", "color": "#4CAF50"},
+    {"id": "tag-3", "name": "check", "color": "#FF9800"}
   ]
 }
 ```
 
-**Теги = роли/акторы.** Указывают КТО выполняет действие:
-- `система`, `пользователь`, `администратор`
-- `клиент`, `менеджер`, `бот`
-- `муж`, `жена`, `ребёнок` (для личных схем)
+**Tags = roles/actors.** Indicate WHO performs the action:
+- `system`, `user`, `admin`
+- `client`, `manager`, `bot`
 
-## Примеры использования
+## Schema Methodology
 
-### Создать схему
+Schema = complete tree of **ACTIONS** and **CONSEQUENCES**:
 
-```
-Создай схему "Авторизация пользователя" с этапами:
-1. Ввод логина/пароля (пользователь)
-2. Проверка в базе (система)
-3. Успех или ошибка
-```
-
-### Обновить схему
-
-```
-Добавь в схему блок "Двухфакторная аутентификация" между проверкой и успехом
-```
-
-### Работа с проектами
-
-```
-Создай проект "Backend API" с иконкой 🚀 и синим цветом
-```
-
-```
-Перемести схему в проект Backend API
-```
-
-### Работа с тегами
-
-```
-Добавь тег "Critical" красного цвета в схему
-```
-
-```
-Пометь элемент "Валидация" тегом Critical
-```
-
-## Методология создания схем
-
-Схема = полное дерево **ДЕЙСТВИЙ** и **ПОСЛЕДСТВИЙ**:
-
-1. Каждое решение → показать ВСЕ возможные варианты
-2. Каждый вариант → показать ВСЕ последствия
-3. Использовать `condition` для точек принятия решений
-4. НЕ абстрактные размышления — КОНКРЕТНЫЕ пути развития
-5. Теги указывают КТО выполняет действие
+1. Each decision → show ALL possible options
+2. Each option → show ALL consequences
+3. Use `condition` for decision points
+4. NOT abstract thoughts — CONCRETE paths
+5. Tags indicate WHO performs the action
 
-**Пример:**
+**Example:**
 ```
-"Отправка формы" → condition "Валидация" →
-  ├── "Данные корректны" → "Сохранение" → "Успех"
-  └── "Ошибка" → "Показать ошибки" → "Исправить форму"
+"Submit Form" → condition "Validate" →
+  ├── "Data Valid" → "Save" → "Success"
+  └── "Error" → "Show Errors" → "Fix Form"
 ```
 
-## Ссылки
+## Links
 
 - [SchemeOG Cloud](https://scheme.smartlaunchhub.com)
 - [GitLab](https://gitlab.com/serter2069/schemeog-cloud)

package/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * SchemeOG MCP Server v2.1
+ * SchemeOG MCP Server v2.2
  *
  * MCP сервер для работы со схемами, проектами и тегами в SchemeOG Cloud.
  *
@@ -114,11 +114,11 @@ async function apiRequest(endpoint, options = {}) {
     throw new Error(error.message);
   }
 
-  // Базовая валидация формата токена
-  if (!AUTH_TOKEN.startsWith("sk-") || AUTH_TOKEN.length < 20) {
+  // Базовая валидация формата токена (schog_ - новый формат)
+  if (!AUTH_TOKEN.startsWith("schog_") || AUTH_TOKEN.length < 20) {
     const error = createError(
       ErrorCodes.AUTH_INVALID,
-      `Неверный формат токена. Токен должен начинаться с "sk-" и содержать минимум 20 символов.\n\nПолучен: ${AUTH_TOKEN.substring(0, 10)}...`
+      `Неверный формат токена. Токен должен начинаться с "schog_" и содержать минимум 20 символов.\n\nПолучен: ${AUTH_TOKEN.substring(0, 10)}...`
     );
     throw new Error(error.message);
   }
@@ -215,10 +215,7 @@ 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 || "",
+    type: el.type || "card",
     ...el
   }));
 }
@@ -1192,16 +1189,16 @@ async function main() {
 2. Добавьте в настройки MCP:
 
    "env": {
-     "SCHEMEOG_TOKEN": "sk-ваш-токен"
+     "SCHEMEOG_TOKEN": "schog_ваш-токен"
    }
 
 Документация: ${DOCS_URL}
 `);
-  } else if (!AUTH_TOKEN.startsWith("sk-")) {
+  } else if (!AUTH_TOKEN.startsWith("schog_")) {
     console.error(`
 ⚠️  Неверный формат токена!
 
-Токен должен начинаться с "sk-".
+Токен должен начинаться с "schog_".
 Получен: ${AUTH_TOKEN.substring(0, 10)}...
 
 Создайте новый токен: ${PROFILE_URL}
@@ -1211,7 +1208,7 @@ async function main() {
   const server = new Server(
     {
       name: "schemeog-mcp",
-      version: "2.1.0",
+      version: "2.2.1",
     },
     {
       capabilities: {
@@ -1241,7 +1238,7 @@ async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
 
-  console.error("SchemeOG MCP Server v2.1 запущен");
+  console.error("SchemeOG MCP Server v2.2 запущен");
 }
 
 main().catch(console.error);

package/package.json

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