schemeog-mcp 3.8.0 → 3.9.0

package/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 /**
- * SchemeOG MCP Server v3.8.0
+ * SchemeOG MCP Server v3.8.1
  *
  * MCP сервер для работы со схемами, проектами и тегами в SchemeOG Cloud.
  *
@@ -37,7 +37,8 @@ import {
   CallToolRequestSchema,
   ListToolsRequestSchema,
 } from "@modelcontextprotocol/sdk/types.js";
-import { readFileSync } from "fs";
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { dirname } from "path";
 
 // Конфигурация
 const API_BASE_URL = process.env.SCHEMEOG_API_URL || "https://diagrams.love";
@@ -216,8 +217,16 @@ function generateId() {
 
 /**
  * Допустимые именованные цвета для элементов
+ * Включает:
+ * - Fill colors (light_*): используются для заливки карточек
+ * - Border colors (blue, green, etc.): используются для цвета обводки в app.js
  */
-const VALID_COLORS = ["white", "light_blue", "light_green", "light_yellow", "light_orange", "light_red", "light_purple", "light_gray", "light_pink", "light_teal"];
+const VALID_COLORS = [
+  // Fill colors (background)
+  "white", "light_blue", "light_green", "light_yellow", "light_orange", "light_red", "light_purple", "light_gray", "light_pink", "light_teal",
+  // Border colors (stroke) - совместимость с app.js CARD_COLORS
+  "default", "blue", "green", "orange", "purple", "red", "teal", "yellow", "gray", "black"
+];
 
 /**
  * Маппинг HEX цветов к именованным (ближайшее соответствие)
@@ -541,8 +550,7 @@ Use this command to see what schemas the user has.`,
   "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
+  "color": "blue",          // Цвет: default, blue, green, orange, purple, red, teal, yellow, gray, black, white, light_blue, light_green, light_yellow, light_orange, light_red, light_purple, light_gray, light_pink, light_teal
   "description": "Текст",   // описание
   "tags": ["тег1"],         // массив тегов
   "connections": [{"to": "target_id", "label": "подпись"}]  // исходящие связи
@@ -612,8 +620,7 @@ Element format:
   "id": "unique_id",       // unique ID
   "type": "card",          // card, condition (diamond), or ascii (ASCII diagram card)
   "title": "Title",        // card title
-  "color": "light_blue",   // background: white, light_blue, light_green, light_yellow, light_orange, light_red, light_purple, light_gray, light_pink, light_teal
-  "borderColor": "blue",   // border: default, blue, green, orange, purple, red, teal, yellow, gray, black
+  "color": "blue",         // Color: default, blue, green, orange, purple, red, teal, yellow, gray, black, white, light_blue, light_green, light_yellow, light_orange, light_red, light_purple, light_gray, light_pink, light_teal
   "tags": ["tag1"],        // tag names array (optional)
   "description": "Desc",   // detailed description (optional)
   "asciiContent": "...",   // ASCII diagram content (REQUIRED for type: "ascii")
@@ -629,7 +636,7 @@ Example:
   "type": "ascii",
   "title": "Request Flow",
   "asciiContent": "┌─────────┐     ┌─────────┐\\n│ Request │────▶│ Process │\\n└─────────┘     └─────────┘",
-  "borderColor": "purple"
+  "color": "purple"
 }
 
 СВЯЗИ (inline формат — внутри элемента):
@@ -684,8 +691,7 @@ Example:
               id: { type: "string" },
               type: { type: "string", enum: ["card", "condition"] },
               title: { type: "string" },
-              color: { type: "string", enum: ["white", "light_blue", "light_green", "light_yellow", "light_orange", "light_red", "light_purple", "light_gray", "light_pink", "light_teal"] },
-              borderColor: { type: "string", enum: ["default", "blue", "green", "orange", "purple", "red", "teal", "yellow", "gray", "black"] },
+              color: { type: "string", enum: ["default", "blue", "green", "orange", "purple", "red", "teal", "yellow", "gray", "black", "white", "light_blue", "light_green", "light_yellow", "light_orange", "light_red", "light_purple", "light_gray", "light_pink", "light_teal"] },
               tags: { type: "array", items: { type: "string" } },
               description: { type: "string" },
             },
@@ -741,8 +747,7 @@ Claude обрезает большие параметры, но file_path чит
   "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
+  "color": "blue",         // Цвет: default, blue, green, orange, purple, red, teal, yellow, gray, black, white, light_blue, light_green, light_yellow, light_orange, light_red, light_purple, light_gray, light_pink, light_teal
   "tags": ["тег1"],
   "description": "Описание",
   "connections": [{"to": "target_id", "label": "подпись"}]  // ИСХОДЯЩИЕ СВЯЗИ внутри элемента
@@ -2333,18 +2338,15 @@ export_schema_to_json(
 
       // Если указан 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 });
+        const dir = dirname(file_path);
+        if (!existsSync(dir)) {
+          mkdirSync(dir, { recursive: true });
         }
 
         // Сохраняем JSON в файл
         const jsonContent = JSON.stringify(exportData, null, 2);
-        fs.writeFileSync(file_path, jsonContent, 'utf8');
+        writeFileSync(file_path, jsonContent, 'utf8');
 
         const fileSizeKB = Math.round(jsonContent.length / 1024);
 

package/package.json

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

package/README.md

@@ -1,368 +0,0 @@
-# SchemeOG MCP Server v2.9
-
-MCP server for [SchemeOG Cloud](https://scheme.smartlaunchhub.com) — create diagrams and flowcharts with AI.
-
-## Features
-
-- **17 commands** for schemas, projects, tags, and import/export
-- **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
-
-## 17 Commands
-
-### Schemas (6 commands)
-
-| Command | Description |
-|---------|-------------|
-| `list_schemas` | List all schemas |
-| `get_schema` | Get schema by ID |
-| `get_schema_by_url` | Get schema by URL (canvas or shared link) |
-| `create_schema` | Create new schema |
-| `replace_schema` | Replace schema content |
-| `delete_schema` | Delete schema |
-
-### Import/Export (2 commands)
-
-| Command | Description |
-|---------|-------------|
-| `import_schema_from_json` | Import schema from JSON (multiple formats supported) |
-| `export_schema_to_json` | Export schema to JSON file |
-
-### Projects (5 commands)
-
-| 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 |
-
-### Tags (4 commands)
-
-| 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
-
-### Via npx (recommended)
-
-```bash
-npx schemeog-mcp
-```
-
-## Setup
-
-### 1. Get your token
-
-1. Open https://scheme.smartlaunchhub.com
-2. Sign in with email
-3. Go to Profile
-4. Copy token from "Claude Code Integration" section
-
-### 2. Add to Claude Code / Cline
-
-In `~/.claude.json` (or Cline settings):
-
-```json
-{
-  "mcpServers": {
-    "schemeog": {
-      "command": "npx",
-      "args": ["-y", "schemeog-mcp"],
-      "env": {
-        "SCHEMEOG_TOKEN": "schog_xxxxx..."
-      }
-    }
-  }
-}
-```
-
-## Schema Data Format
-
-### Element (card or condition)
-
-```json
-{
-  "id": "unique_id",
-  "type": "card",
-  "title": "Card Title",
-  "color": "light_blue",
-  "tags": ["tag1", "tag2"],
-  "description": "Detailed description",
-  "borderColor": "blue",
-  "completed": false,
-  "eventDate": "2025-03-15",
-  "connections": [
-    {"to": "next_element_id", "label": "optional label"}
-  ]
-}
-```
-
-**IMPORTANT: Do NOT specify `x` and `y` coordinates!**
-- MCP automatically ignores coordinates to prevent cards from overlapping
-- Existing elements keep their positions
-- New elements are automatically positioned by auto-layout
-- This prevents the common problem of Claude copying coordinates from existing cards
-
-**Element types:**
-- `card` — regular process/action card
-- `condition` — decision point (diamond shape)
-
-**Completion status (`completed`):**
-- `true` — card is marked as completed (done)
-- `false` or omitted — card is not completed
-
-**Event date (`eventDate`):**
-- ISO 8601 format: `"2025-03-15"` or `"2025-03-15T10:00:00Z"`
-- Used for deadlines, milestones, or scheduled events
-
-**ID uniqueness:**
-- Each element MUST have a unique `id`
-- Duplicate IDs will cause an error and prevent schema creation
-
-**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 |
-
-**Border colors (`borderColor`):** `default`, `blue`, `green`, `orange`, `purple`, `red`, `teal`, `yellow`, `gray`, `black`
-
-### Connection (inline format)
-
-Connections are defined inside each element's `connections` array:
-
-```json
-{
-  "connections": [
-    {"to": "target_id", "label": "optional label", "style": "solid"}
-  ]
-}
-```
-
-**Line styles (`style`):** `solid` (default), `dashed`, `dotted`
-
-### Full schema example
-
-```json
-{
-  "name": "User Registration Flow",
-  "description": "User registration process",
-  "elements": [
-    {
-      "id": "start",
-      "type": "card",
-      "title": "Registration Form",
-      "color": "light_green",
-      "tags": ["user"],
-      "description": "User fills in email and password",
-      "connections": [
-        {"to": "validate", "label": "submit"}
-      ]
-    },
-    {
-      "id": "validate",
-      "type": "condition",
-      "title": "Validate Data",
-      "color": "light_yellow",
-      "tags": ["system"],
-      "connections": [
-        {"to": "save", "label": "valid"},
-        {"to": "error", "label": "invalid"}
-      ]
-    },
-    {
-      "id": "save",
-      "type": "card",
-      "title": "Save to Database",
-      "color": "light_blue",
-      "tags": ["system"],
-      "connections": [{"to": "success"}]
-    },
-    {
-      "id": "error",
-      "type": "card",
-      "title": "Validation Error",
-      "color": "light_red",
-      "tags": ["system"],
-      "connections": [{"to": "start", "label": "retry"}]
-    },
-    {
-      "id": "success",
-      "type": "card",
-      "title": "Registration Complete",
-      "color": "light_green",
-      "tags": ["user"]
-    }
-  ],
-  "tagsDictionary": [
-    {"id": "tag-user", "name": "user", "color": "#4CAF50"},
-    {"id": "tag-system", "name": "system", "color": "#2196F3"}
-  ]
-}
-```
-
-### Tags Dictionary (tagsDictionary)
-
-```json
-{
-  "tagsDictionary": [
-    {"id": "tag-1", "name": "system", "color": "#2196F3"},
-    {"id": "tag-2", "name": "user", "color": "#4CAF50"}
-  ]
-}
-```
-
-**Tags = roles/actors.** Indicate WHO performs the action:
-- `system`, `user`, `admin`
-- `client`, `manager`, `bot`
-
-## Auto-Refresh Feature
-
-When you edit a schema via MCP while viewing it in the browser:
-- Browser automatically detects changes every 3 seconds
-- Page reloads ONLY when changes are made by MCP (not by your own edits)
-- No manual refresh needed — just edit via MCP and watch the browser update!
-
-**How it works:**
-- MCP marks all updates with `updatedBy: 'mcp'`
-- Browser ignores its own updates (`updatedBy: 'web'`)
-- This prevents infinite reload loops when you edit in browser
-
-## Opening Schema by URL
-
-You can open any schema by URL using `get_schema_by_url`:
-
-```
-# Canvas URL (основной формат)
-https://scheme.smartlaunchhub.com/canvas?schema=abc123
-
-# Shared link
-https://scheme.smartlaunchhub.com/shared/xyz789
-```
-
-Just paste the URL and the MCP will extract the schema ID automatically.
-
-## Schema Methodology
-
-Schema = complete tree of **ACTIONS** and **CONSEQUENCES**:
-
-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:**
-```
-"Submit Form" → condition "Validate" →
-  ├── "Data Valid" → "Save" → "Success"
-  └── "Error" → "Show Errors" → "Fix Form"
-```
-
-## Import/Export Formats
-
-### Export formats
-
-Use `export_schema_to_json` with the `format` parameter:
-
-| Format | Description |
-|--------|-------------|
-| `full` | Complete export with metadata, viewport, and all data |
-| `compact` | Schema name + elements + tagsDictionary only |
-| `elements_only` | Just the elements array |
-
-### Import formats
-
-`import_schema_from_json` automatically detects and supports:
-
-**1. Full SchemeOG export:**
-```json
-{
-  "exportVersion": "1.0",
-  "schema": {
-    "name": "...",
-    "elements": [...],
-    "tagsDictionary": [...]
-  }
-}
-```
-
-**2. Simple format:**
-```json
-{
-  "name": "...",
-  "elements": [...],
-  "connections": [...],
-  "tagsDictionary": [...]
-}
-```
-
-**3. Local format (connections inside elements):**
-```json
-{
-  "name": "...",
-  "elements": [
-    {
-      "id": "1",
-      "title": "...",
-      "connections": [{"to": "2"}]
-    }
-  ]
-}
-```
-
-**4. Elements array only:**
-```json
-[
-  {"id": "1", "title": "...", "connections": [{"to": "2"}]}
-]
-```
-
-### Import examples
-
-**Create new schema:**
-```
-import_schema_from_json(
-  json_content: {...},
-  name: "My Schema"
-)
-```
-
-**Update existing schema:**
-```
-import_schema_from_json(
-  json_content: {...},
-  schema_id: "existing-id"
-)
-```
-
-## Version History
-
-MCP now automatically creates versions when updating schemas:
-- Before each update via MCP, a snapshot is saved
-- View version history in the web interface (History tab)
-- Restore any previous version with one click
-
-## Links
-
-- [SchemeOG Cloud](https://scheme.smartlaunchhub.com)
-- [GitLab](https://gitlab.com/serter2069/schemeog-mcp)
-
-## License
-
-MIT