drawio-mcp-server 1.5.0 → 1.7.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2025 Ladislav Gazo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,8 +1,9 @@
+
 # Draw.io MCP server
 
 Let's do some Vibe Diagramming with the most wide-spread diagramming tool called Draw.io (Diagrams.net).
 
-[![Discord channel](https://shields.io/static/v1?logo=discord&message=draw.io%20mcp&label=chat&color=5865F2&logoColor=white)](https://discord.gg/dM4PWdf42q) [![Build project](https://github.com/lgazo/drawio-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/lgazo/drawio-mcp-server/actions/workflows/ci.yml)
+[![Discord channel](https://shields.io/static/v1?logo=discord&message=draw.io%20mcp&label=chat&color=5865F2&logoColor=white)](https://discord.gg/dM4PWdf42q) [![Build project](https://github.com/lgazo/drawio-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/lgazo/drawio-mcp-server/actions/workflows/ci.yml) [![Verified on MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/5fc2b7fe-8ceb-4683-97bd-6d31e07b5888)
 
 ## Introduction
 
@@ -246,14 +247,15 @@ To use a custom extension port (e.g., 8080), add `"--extension-port", "8080"` to
 {
   /// The name of your MCP server
   "drawio": {
-    "command": {
-      /// The path to the executable
-      "path": "npx",
-      /// The arguments to pass to the executable
-      "args": ["-y","drawio-mcp-server"],
-      /// The environment variables to set for the executable
-      "env": {}
-    }
+	/// The path to the executable
+	"command": "npx",
+	/// The arguments to pass to the executable
+	"args": [
+	  "-y",
+	  "drawio-mcp-server"
+	],
+	/// The environment variables to set for the executable
+    "env": {}
   }
 }
 ```
@@ -266,14 +268,15 @@ To use a custom extension port (e.g., 8080), add `"--extension-port", "8080"` to
 {
   /// The name of your MCP server
   "drawio": {
-    "command": {
-      /// The path to the executable
-      "path": "pnpm",
-      /// The arguments to pass to the executable
-      "args": ["dlx","drawio-mcp-server"],
-      /// The environment variables to set for the executable
-      "env": {}
-    }
+	/// The path to the executable
+	"command": "pnpm",
+	/// The arguments to pass to the executable
+	"args": [
+	  "dlx",
+	  "drawio-mcp-server"
+	],
+	/// The environment variables to set for the executable
+    "env": {}
   }
 }
 ```
@@ -283,16 +286,15 @@ To use a custom extension port (e.g., 8080), add `"--extension-port", "8080"` to
 
 ```json
 {
-  /// The name of your MCP server
   "drawio": {
-    "command": {
-      /// The path to the executable
-      "path": "npx",
-      /// The arguments to pass to the executable
-      "args": ["-y","drawio-mcp-server","--extension-port","8080"],
-      /// The environment variables to set for the executable
-      "env": {}
-    }
+    "command": "npx",
+    "args": [
+      "-y",
+      "drawio-mcp-server",
+      "--extension-port",
+      "8080"
+    ],
+    "env": {}
   }
 }
 ```
@@ -482,6 +484,34 @@ The Draw.io MCP server provides the following tools for programmatic diagram int
     - `source_id`, `target_id`: Optional IDs of new source/target cells
     - `style`: Optional replacement style string
 
+### Layer Management Tools
+- **`list-layers`**
+  Lists all available layers in the diagram with their IDs and names
+  *Returns*: Array of layer objects with properties (ID, name, visibility, locked status)
+
+- **`set-active-layer`**
+  Sets the active layer for creating new elements. All subsequent element creation will happen in this layer
+  *Parameters*:
+    - `layer_id`: ID of the layer to set as active
+  *Returns*: Information about the newly active layer
+
+- **`move-cell-to-layer`**
+  Moves a cell from its current layer to a target layer
+  *Parameters*:
+    - `cell_id`: ID of the cell to move
+    - `target_layer_id`: ID of the target layer where the cell will be moved
+  *Returns*: Confirmation of the move operation
+
+- **`get-active-layer`**
+  Gets the currently active layer information
+  *Returns*: Information about the current active layer (ID and name)
+
+- **`create-layer`**
+  Creates a new layer in the diagram
+  *Parameters*:
+    - `name`: Name for the new layer
+  *Returns*: Information about the newly created layer
+
 ## Related Resources
 
 [Troubleshooting](./TROUBLESHOOTING.md)
@@ -503,3 +533,7 @@ The Draw.io MCP server provides the following tools for programmatic diagram int
    <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=lgazo/drawio-mcp-server&type=Date" />
  </picture>
 </a>
+
+## Assessments
+
+[![MSeeP.ai Security Assessment Badge](https://mseep.net/pr/lgazo-drawio-mcp-server-badge.png)](https://mseep.ai/app/lgazo-drawio-mcp-server)

package/build/index.js

@@ -16,12 +16,13 @@ import { default_tool } from "./tool.js";
 import { nanoid_id_generator } from "./nanoid_id_generator.js";
 import { create_logger as create_console_logger } from "./mcp_console_logger.js";
 import { create_logger as create_server_logger, validLogLevels, } from "./mcp_server_logger.js";
+const VERSION = "1.7.0";
 /**
  * Display help message and exit
  */
 function showHelp() {
     console.log(`
-Draw.io MCP Server
+Draw.io MCP Server (${VERSION})
 
 Usage: drawio-mcp-server [options]
 
@@ -66,7 +67,7 @@ const bus_to_ws_forwarder_listener = (event) => {
 };
 emitter.on(bus_request_stream, bus_to_ws_forwarder_listener);
 async function start_websocket_server(extensionPort) {
-    log.debug(`Draw.io MCP Server starting (WebSocket extension port: ${extensionPort})`);
+    log.debug(`Draw.io MCP Server (${VERSION}) starting (WebSocket extension port: ${extensionPort})`);
     const isPortAvailable = await checkPortAvailable(extensionPort);
     if (!isPortAvailable) {
         console.error(`[start_websocket_server] Error: Port ${extensionPort} is already in use. Please stop the process using this port and try again.`);
@@ -122,7 +123,7 @@ if (logger_type === "mcp_server") {
 // Create server instance
 const server = new McpServer({
     name: "drawio-mcp-server",
-    version: "1.4.0",
+    version: VERSION,
 }, {
     capabilities,
 });
@@ -332,12 +333,43 @@ server.tool(TOOL_list_paged_model, "Retrieves a paginated view of all cells (ver
             .enum(["edge", "vertex", "object", "layer", "group"])
             .optional()
             .describe("Filter by cell type: 'edge' for connection lines, 'vertex' for vertices/shapes, 'object' for any cell type, 'layer' for layer cells, 'group' for grouped cells"),
+        parent_ids: z
+            .array(z.string())
+            .optional()
+            .describe("Filter cells to only those whose parent is one of the specified parent IDs."),
+        layer_ids: z
+            .array(z.string())
+            .optional()
+            .describe("Filter cells to only those whose parent is one of the specified layer IDs. Alias for parent_ids."),
+        ids: z
+            .array(z.string())
+            .optional()
+            .describe("Filter cells to only those whose ID is one of the specified IDs."),
         attributes: Attributes.optional().describe('Boolean logic array expressions for filtering cell attributes. Format: ["and" | "or", ...expressions] or ["equal", key, value]. Matches against cell attributes and parsed style properties.'),
     })
         .optional()
         .describe("Optional filter criteria to apply to cells before pagination")
         .default({}),
 }, default_tool(TOOL_list_paged_model, context));
+const TOOL_list_layers = "list-layers";
+server.tool(TOOL_list_layers, "Lists all available layers in the diagram with their IDs and names.", {}, default_tool(TOOL_list_layers, context));
+const TOOL_set_active_layer = "set-active-layer";
+server.tool(TOOL_set_active_layer, "Sets the active layer for creating new elements. All subsequent element creation will happen in this layer.", {
+    layer_id: z.string().describe("ID of the layer to set as active"),
+}, default_tool(TOOL_set_active_layer, context));
+const TOOL_move_cell_to_layer = "move-cell-to-layer";
+server.tool(TOOL_move_cell_to_layer, "Moves a cell from its current layer to a target layer.", {
+    cell_id: z.string().describe("ID of the cell to move"),
+    target_layer_id: z
+        .string()
+        .describe("ID of the target layer where the cell will be moved"),
+}, default_tool(TOOL_move_cell_to_layer, context));
+const TOOL_get_active_layer = "get-active-layer";
+server.tool(TOOL_get_active_layer, "Gets the currently active layer information.", {}, default_tool(TOOL_get_active_layer, context));
+const TOOL_create_layer = "create-layer";
+server.tool(TOOL_create_layer, "Creates a new layer in the diagram.", {
+    name: z.string().describe("Name for the new layer"),
+}, default_tool(TOOL_create_layer, context));
 async function start_stdio_transport() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/package.json

@@ -1,12 +1,27 @@
 {
   "name": "drawio-mcp-server",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "Provides Draw.io services to MCP Clients",
   "type": "module",
   "main": "index.js",
   "bin": {
     "drawio-mcp-server": "./build/index.js"
   },
+  "scripts": {
+    "build": "tsc",
+    "ci": "pnpm install --frozen-lockfile",
+    "dev": "tsc --watch",
+    "inspect": "HOST=0.0.0.0 pnpx @modelcontextprotocol/inspector --config ./inspector.json --server drawio",
+    "prepublishOnly": "pnpm run build",
+    "lint": "tsc --noEmit",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "test": "NODE_OPTIONS=--experimental-vm-modules jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "NODE_OPTIONS=--experimental-vm-modules jest --coverage",
+    "clean": "rimraf build coverage .eslintcache",
+    "prebuild": "pnpm run clean"
+  },
   "engines": {
     "node": ">=20.0.0"
   },
@@ -26,6 +41,11 @@
   ],
   "author": "Ladislav Gazo",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lgazo/drawio-mcp-server"
+  },
+  "packageManager": "pnpm@10.8.1",
   "dependencies": {
     "@hono/node-server": "1.19.7",
     "@modelcontextprotocol/sdk": "1.25.1",
@@ -46,19 +66,5 @@
     "rimraf": "6.1.2",
     "ts-jest": "29.4.6",
     "typescript": "5.9.3"
-  },
-  "scripts": {
-    "build": "tsc",
-    "ci": "pnpm install --frozen-lockfile",
-    "dev": "tsc --watch",
-    "inspect": "HOST=0.0.0.0 pnpx @modelcontextprotocol/inspector --config ./inspector.json --server drawio",
-    "lint": "tsc --noEmit",
-    "format": "prettier --write \"src/**/*.ts\"",
-    "format:check": "prettier --check \"src/**/*.ts\"",
-    "test": "NODE_OPTIONS=--experimental-vm-modules jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "NODE_OPTIONS=--experimental-vm-modules jest --coverage",
-    "clean": "rimraf build coverage .eslintcache",
-    "prebuild": "pnpm run clean"
   }
-}
+}