schemeog-mcp 3.1.0 → 3.2.0

package/README.md

@@ -1,13 +1,45 @@
-# SchemeOG MCP Server v2.9
+# SchemeOG MCP Server v3.1
 
 MCP server for [Diagrams.love](https://diagrams.love) — create diagrams and flowcharts with AI.
 
+## 📊 ASCII Diagrams vs SchemeOG — When to Use What
+
+**✅ USE ASCII DIAGRAMS (text in chat) for:**
+- Quick architecture explanation
+- Temporary diagram for discussion
+- Simple flowcharts in conversation
+- When user just needs to understand something
+
+**Example ASCII:**
+```
+┌─────────────┐     ┌─────────────┐     ┌─────────────┐
+│   Request   │────▶│  Validate   │────▶│   Process   │
+└─────────────┘     └─────────────┘     └──────┬──────┘
+                                               │
+                    ┌─────────────┐            │
+                    │  Response   │◀───────────┘
+                    └─────────────┘
+```
+
+**➡️ USE SchemeOG (this MCP) ONLY when:**
+- User explicitly asks to CREATE/SAVE a schema
+- User wants to EDIT an existing schema
+- Schema needs to be SHARED with team
+- User flow for documentation
+
+**⚠️ DO NOT suggest SchemeOG automatically!**
+ASCII diagrams are for quick explanations, SchemeOG is for persistent cloud storage.
+
+---
+
 ## 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
+- **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 +280,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

@@ -505,11 +505,37 @@ const TOOLS = [
   // ========== СХЕМЫ ==========
   {
     name: "list_schemas",
-    description: `Получить список всех схем пользователя.
+    description: `Get list of all user schemas.
 
-Возвращает: ID, название, описание, проект, дату обновления каждой схемы.
+Returns: ID, name, description, project, update date for each schema.
 
-Используй эту команду чтобы узнать какие схемы есть у пользователя.`,
+Use this command to see what schemas the user has.
+
+---
+
+📊 ASCII DIAGRAMS vs SchemeOG — WHEN TO USE WHAT:
+
+✅ USE ASCII DIAGRAMS (text in chat) for:
+- Quick architecture explanation
+- Temporary diagram for discussion
+- Simple flowcharts in conversation
+- When user just needs to understand something
+
+Example ASCII:
+\`\`\`
+┌─────────┐     ┌─────────┐
+│ Request │────▶│ Process │
+└─────────┘     └─────────┘
+\`\`\`
+
+➡️ USE SchemeOG (this MCP) ONLY when:
+- User explicitly asks to CREATE/SAVE a schema
+- User wants to EDIT an existing schema
+- Schema needs to be SHARED with team
+- User flow for documentation
+
+⚠️ DO NOT suggest SchemeOG automatically!
+ASCII diagrams are for quick explanations, SchemeOG is for persistent cloud storage.`,
     inputSchema: {
       type: "object",
       properties: {},

package/package.json

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