drawio-mcp-server 2.0.3 → 2.1.0

package/build/tools/get-selected-cell.js

@@ -1,5 +1,8 @@
 import { default_tool } from "../tool.js";
+import { target_page_field } from "./shared.js";
 export const TOOL_get_selected_cell = "get-selected-cell";
 export const registerGetSelectedCellTool = (server, context) => {
-    server.tool(TOOL_get_selected_cell, "This tool allows you to retrieve selected cell (whether vertex or edge) on the current page of a Draw.io diagram. The response is a JSON containing attributes of the cell.", {}, default_tool(TOOL_get_selected_cell, context));
+    server.tool(TOOL_get_selected_cell, "This tool retrieves the selected cell on the target page of the current Draw.io document. If the target page is not currently visible, Draw.io may switch the visible page first because selection is UI-bound.", {
+        target_page: target_page_field(),
+    }, default_tool(TOOL_get_selected_cell, context, { queue: true }));
 };

package/build/tools/import-diagram.js

@@ -1,8 +1,10 @@
 import { z } from "zod";
 import { default_tool } from "../tool.js";
+import { target_page_field } from "./shared.js";
 export const TOOL_import_diagram = "import-diagram";
 export const registerImportDiagramTool = (server, context) => {
-    server.tool(TOOL_import_diagram, "Import a diagram from XML, SVG with embedded XML, or PNG with embedded XML into the current Draw.io instance.", {
+    server.tool(TOOL_import_diagram, "Import a diagram from XML, SVG with embedded XML, or PNG with embedded XML into the current Draw.io instance. `target_page` is required for `replace` and `add`, and optional for `new-page`.", {
+        target_page: target_page_field().optional(),
         data: z
             .string()
             .describe("The diagram data: raw XML string, or base64-encoded SVG/PNG with embedded XML"),
@@ -18,5 +20,13 @@ export const registerImportDiagramTool = (server, context) => {
             .string()
             .optional()
             .describe("Optional original filename for context"),
-    }, default_tool(TOOL_import_diagram, context));
+    }, async (args, extra) => {
+        if (args.mode !== "new-page" && !args.target_page) {
+            throw new Error("`target_page` is required when import-diagram mode is `replace` or `add`");
+        }
+        const handler = default_tool(TOOL_import_diagram, context, {
+            queue: true,
+        });
+        return handler(args, extra);
+    });
 };

package/build/tools/import-mermaid.js

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import { default_tool } from "../tool.js";
+import { target_page_field } from "./shared.js";
+export const TOOL_import_mermaid = "import-mermaid";
+export const registerImportMermaidTool = (server, context) => {
+    server.tool(TOOL_import_mermaid, "Insert a Mermaid diagram into the target Draw.io page. Conversion runs inside the Draw.io editor via its bundled Mermaid pipeline (EditorUi.parseMermaidDiagram). mode='native' converts supported Mermaid types into native mxGraph cells; unsupported types fall back to an embedded image cell. mode='embed' always emits a single image cell that preserves the Mermaid source for re-editing inside Draw.io. `target_page` is required for `replace` and `add`, and optional for `new-page`.", {
+        target_page: target_page_field().optional(),
+        mermaid_source: z
+            .string()
+            .min(1)
+            .describe("Raw Mermaid syntax. Examples: 'graph TD; A-->B;', 'sequenceDiagram\\nA->>B: hi'."),
+        mode: z
+            .enum(["native", "embed"])
+            .optional()
+            .default("native")
+            .describe("native = convert to native mxGraph cells when the diagram type is supported (best editability). embed = single image cell with mermaidData attribute for round-trip Mermaid editing in Draw.io."),
+        insert_mode: z
+            .enum(["replace", "add", "new-page"])
+            .optional()
+            .default("add")
+            .describe("How the resulting XML is merged into the diagram: replace, add, or new-page."),
+    }, async (args, extra) => {
+        if (args.insert_mode !== "new-page" && !args.target_page) {
+            throw new Error("`target_page` is required when import-mermaid insert_mode is `replace` or `add`");
+        }
+        const handler = default_tool(TOOL_import_mermaid, context, {
+            queue: true,
+        });
+        return handler(args, extra);
+    });
+};

package/build/tools/index.js

@@ -1,20 +1,27 @@
 import { registerAddCellOfShapeTool } from "./add-cell-of-shape.js";
 import { registerAddEdgeTool } from "./add-edge.js";
 import { registerAddRectangleTool } from "./add-rectangle.js";
+import { registerCopyPageTool } from "./copy-page.js";
 import { registerCreateLayerTool } from "./create-layer.js";
+import { registerCreatePageTool } from "./create-page.js";
 import { registerDeleteCellByIdTool } from "./delete-cell-by-id.js";
 import { registerEditCellTool } from "./edit-cell.js";
 import { registerEditEdgeTool } from "./edit-edge.js";
 import { registerExportDiagramTool } from "./export-diagram.js";
 import { registerGetActiveLayerTool } from "./get-active-layer.js";
+import { registerGetCurrentPageTool } from "./get-current-page.js";
 import { registerGetSelectedCellTool } from "./get-selected-cell.js";
 import { registerGetShapeByNameTool } from "./get-shape-by-name.js";
 import { registerGetShapeCategoriesTool } from "./get-shape-categories.js";
 import { registerGetShapesInCategoryTool } from "./get-shapes-in-category.js";
 import { registerImportDiagramTool } from "./import-diagram.js";
+import { registerImportMermaidTool } from "./import-mermaid.js";
 import { registerListLayersTool } from "./list-layers.js";
+import { registerListDocumentsTool } from "./list-documents.js";
+import { registerListPagesTool } from "./list-pages.js";
 import { registerListPagedModelTool } from "./list-paged-model.js";
 import { registerMoveCellToLayerTool } from "./move-cell-to-layer.js";
+import { registerRenamePageTool } from "./rename-page.js";
 import { registerSetActiveLayerTool } from "./set-active-layer.js";
 import { registerSetCellDataTool } from "./set-cell-data.js";
 import { registerSetCellParentTool } from "./set-cell-parent.js";
@@ -41,6 +48,13 @@ const registrars = [
     registerCreateLayerTool,
     registerExportDiagramTool,
     registerImportDiagramTool,
+    registerImportMermaidTool,
+    registerListDocumentsTool,
+    registerListPagesTool,
+    registerGetCurrentPageTool,
+    registerCreatePageTool,
+    registerCopyPageTool,
+    registerRenamePageTool,
 ];
 export function registerTools(...args) {
     for (const register of registrars) {

package/build/tools/list-documents.js

@@ -0,0 +1,17 @@
+export const TOOL_list_documents = "list-documents";
+export const registerListDocumentsTool = (server, context) => {
+    server.tool(TOOL_list_documents, "Lists all connected Draw.io document instances with their stable instance IDs and basic metadata.", {}, async () => {
+        const documents = await context.document_routing.list_documents();
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: true,
+                        result: documents,
+                    }),
+                },
+            ],
+        };
+    });
+};

package/build/tools/list-layers.js

@@ -1,5 +1,8 @@
 import { default_tool } from "../tool.js";
+import { target_page_field } from "./shared.js";
 export const TOOL_list_layers = "list-layers";
 export const registerListLayersTool = (server, context) => {
-    server.tool(TOOL_list_layers, "Lists all available layers in the diagram with their IDs and names.", {}, default_tool(TOOL_list_layers, context));
+    server.tool(TOOL_list_layers, "Lists all available layers on the target page with their IDs and names.", {
+        target_page: target_page_field(),
+    }, default_tool(TOOL_list_layers, context, { queue: true }));
 };

package/build/tools/list-paged-model.js

@@ -1,9 +1,10 @@
 import { z } from "zod";
 import { default_tool } from "../tool.js";
-import { Attributes } from "./shared.js";
+import { Attributes, target_page_field } from "./shared.js";
 export const TOOL_list_paged_model = "list-paged-model";
 export const registerListPagedModelTool = (server, context) => {
-    server.tool(TOOL_list_paged_model, "Retrieves a paginated view of all cells (vertices and edges) in the current Draw.io diagram. This tool provides access to the complete model data with essential fields only, sanitized to remove circular dependencies and excessive data. It allows to filter based on multiple criteria and attribute boolean logic. Useful for programmatic inspection of diagram structure without overwhelming response sizes.", {
+    server.tool(TOOL_list_paged_model, "Retrieves a paginated view of all cells (vertices and edges) on the target page. This tool provides access to the complete model data with essential fields only, sanitized to remove circular dependencies and excessive data.", {
+        target_page: target_page_field(),
         page: z
             .number()
             .optional()
@@ -37,5 +38,5 @@ export const registerListPagedModelTool = (server, context) => {
             .optional()
             .describe("Optional filter criteria to apply to cells before pagination")
             .default({}),
-    }, default_tool(TOOL_list_paged_model, context));
+    }, default_tool(TOOL_list_paged_model, context, { queue: true }));
 };

package/build/tools/list-pages.js

@@ -0,0 +1,5 @@
+import { default_tool } from "../tool.js";
+export const TOOL_list_pages = "list-pages";
+export const registerListPagesTool = (server, context) => {
+    server.tool(TOOL_list_pages, "Lists all pages in the current Draw.io document with their index, id, name, and current-page flag.", {}, default_tool(TOOL_list_pages, context, { queue: true }));
+};

package/build/tools/move-cell-to-layer.js

@@ -1,11 +1,13 @@
 import { z } from "zod";
 import { default_tool } from "../tool.js";
+import { target_page_field } from "./shared.js";
 export const TOOL_move_cell_to_layer = "move-cell-to-layer";
 export const registerMoveCellToLayerTool = (server, context) => {
     server.tool(TOOL_move_cell_to_layer, "Moves a cell from its current layer to a target layer.", {
+        target_page: target_page_field(),
         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));
+    }, default_tool(TOOL_move_cell_to_layer, context, { queue: true }));
 };

package/build/tools/rename-page.js

@@ -0,0 +1,10 @@
+import { z } from "zod";
+import { default_tool } from "../tool.js";
+import { target_page_field } from "./shared.js";
+export const TOOL_rename_page = "rename-page";
+export const registerRenamePageTool = (server, context) => {
+    server.tool(TOOL_rename_page, "Renames the selected page without changing the visible page.", {
+        page: target_page_field().describe("Page selector for the page to rename. Provide exactly one of `{ index }` or `{ id }`."),
+        name: z.string().describe("New page name"),
+    }, default_tool(TOOL_rename_page, context, { queue: true }));
+};

package/build/tools/set-active-layer.js

@@ -1,8 +1,10 @@
 import { z } from "zod";
 import { default_tool } from "../tool.js";
+import { target_page_field } from "./shared.js";
 export const TOOL_set_active_layer = "set-active-layer";
 export const registerSetActiveLayerTool = (server, context) => {
-    server.tool(TOOL_set_active_layer, "Sets the active layer for creating new elements. All subsequent element creation will happen in this layer.", {
+    server.tool(TOOL_set_active_layer, "Sets the active layer for creating new elements. All subsequent element creation will happen in this layer. If the target page is not currently visible, Draw.io may switch the visible page first because active-layer state is UI-bound.", {
+        target_page: target_page_field(),
         layer_id: z.string().describe("ID of the layer to set as active"),
-    }, default_tool(TOOL_set_active_layer, context));
+    }, default_tool(TOOL_set_active_layer, context, { queue: true }));
 };

package/build/tools/set-cell-data.js

@@ -1,8 +1,10 @@
 import { z } from "zod";
 import { default_tool } from "../tool.js";
+import { target_page_field } from "./shared.js";
 export const TOOL_set_cell_data = "set-cell-data";
 export const registerSetCellDataTool = (server, context) => {
     server.tool(TOOL_set_cell_data, "Sets or updates a custom attribute on an existing cell.", {
+        target_page: target_page_field(),
         cell_id: z
             .string()
             .describe("Identifier (`id` attribute) of the cell to update with custom data."),
@@ -10,5 +12,5 @@ export const registerSetCellDataTool = (server, context) => {
         value: z
             .union([z.string(), z.number(), z.boolean()])
             .describe("Value to store for the attribute. Non-string values are stringified before storage."),
-    }, default_tool(TOOL_set_cell_data, context));
+    }, default_tool(TOOL_set_cell_data, context, { queue: true }));
 };

package/build/tools/set-cell-parent.js

@@ -1,9 +1,11 @@
 import { z } from "zod";
 import { default_tool } from "../tool.js";
+import { target_page_field } from "./shared.js";
 export const TOOL_set_cell_parent = "set-cell-parent";
 export const registerSetCellParentTool = (server, context) => {
     server.tool(TOOL_set_cell_parent, "Sets the parent of a cell, making it a child of the specified parent cell. This allows creating hierarchical relationships where moving the parent also moves its children.", {
+        target_page: target_page_field(),
         cell_id: z.string().describe("ID of the cell to reparent"),
         parent_id: z.string().describe("ID of the new parent cell"),
-    }, default_tool(TOOL_set_cell_parent, context));
+    }, default_tool(TOOL_set_cell_parent, context, { queue: true }));
 };

package/build/tools/set-cell-shape.js

@@ -1,13 +1,15 @@
 import { z } from "zod";
 import { default_tool } from "../tool.js";
+import { target_page_field } from "./shared.js";
 export const TOOL_set_cell_shape = "set-cell-shape";
 export const registerSetCellShapeTool = (server, context) => {
     server.tool(TOOL_set_cell_shape, "Updates the visual style of an existing vertex cell to match a library shape by name.", {
+        target_page: target_page_field(),
         cell_id: z
             .string()
             .describe("Identifier (`id` attribute) of the cell whose shape should change."),
         shape_name: z
             .string()
             .describe("Name of the library shape whose style should be applied to the existing cell."),
-    }, default_tool(TOOL_set_cell_shape, context));
+    }, default_tool(TOOL_set_cell_shape, context, { queue: true }));
 };

package/build/tools/shared.js

@@ -5,3 +5,38 @@ export const Attributes = z.lazy(() => z
     message: "If not empty, the first element must be a string operator",
 })
     .default([]));
+const BaseTargetPageSchema = z
+    .object({
+    index: z
+        .number()
+        .int()
+        .nonnegative()
+        .optional()
+        .describe("Zero-based page index in the current Draw.io document."),
+    id: z
+        .string()
+        .optional()
+        .describe("Stable Draw.io page identifier from `list-pages`."),
+})
+    .superRefine((value, ctx) => {
+    const hasIndex = value.index !== undefined;
+    const hasId = value.id !== undefined && value.id.length > 0;
+    if (hasIndex === hasId) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "Provide exactly one of `index` or `id`.",
+        });
+    }
+});
+const BaseTargetDocumentSchema = z.object({
+    id: z
+        .string()
+        .min(1)
+        .describe("Stable Draw.io document instance identifier from `list-documents`."),
+});
+export function target_page_field() {
+    return BaseTargetPageSchema.describe("Target page selector. Provide exactly one of `{ index }` or `{ id }` from `list-pages`.");
+}
+export function target_document_field() {
+    return BaseTargetDocumentSchema.describe("Target document selector. Provide `{ id }` from `list-documents`.");
+}

package/build/tools/shared.test.js

@@ -0,0 +1,29 @@
+import { describe, expect, it } from "@jest/globals";
+import { target_document_field, target_page_field } from "./shared.js";
+describe("target_page schema", () => {
+    const schema = target_page_field();
+    it("accepts an index selector", () => {
+        expect(schema.safeParse({ index: 0 }).success).toBe(true);
+    });
+    it("accepts an id selector", () => {
+        expect(schema.safeParse({ id: "page-123" }).success).toBe(true);
+    });
+    it("rejects missing selector fields", () => {
+        const result = schema.safeParse({});
+        expect(result.success).toBe(false);
+    });
+    it("rejects providing both index and id", () => {
+        const result = schema.safeParse({ index: 1, id: "page-123" });
+        expect(result.success).toBe(false);
+    });
+});
+describe("target_document schema", () => {
+    const schema = target_document_field();
+    it("accepts a document id selector", () => {
+        expect(schema.safeParse({ id: "doc-123" }).success).toBe(true);
+    });
+    it("rejects an empty document id", () => {
+        const result = schema.safeParse({ id: "" });
+        expect(result.success).toBe(false);
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drawio-mcp-server",
-  "version": "2.0.3",
+  "version": "2.1.0",
   "description": "Provides Draw.io services to MCP Clients",
   "type": "module",
   "main": "build/index.js",
@@ -31,42 +31,50 @@
     "url": "git+https://github.com/lgazo/drawio-mcp-server.git"
   },
   "dependencies": {
-    "@hono/node-server": "1.19.7",
-    "@modelcontextprotocol/sdk": "1.25.1",
-    "cachedir": "^2.4.0",
-    "hono": "4.11.1",
+    "@hono/node-server": "1.19.13",
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "cachedir": "2.4.0",
+    "hono": "4.12.14",
     "nanoid": "5.1.6",
-    "unzipper": "^0.12.0",
+    "node-forge": "1.4.0",
+    "unzipper": "0.12.3",
     "ws": "8.18.3",
     "zod": "4.2.1"
   },
   "devDependencies": {
+    "@biomejs/biome": "2.4.13",
     "@jest/globals": "30.2.0",
-    "@playwright/test": "1.54.2",
+    "@playwright/test": "1.59.1",
     "@types/jest": "30.0.0",
     "@types/node": "25.0.3",
-    "@types/unzipper": "^0.10.11",
-    "@types/ws": "^8.18.1",
-    "esbuild": "^0.24.0",
+    "@types/node-forge": "1.3.11",
+    "@types/unzipper": "0.10.11",
+    "@types/ws": "8.18.1",
+    "concurrently": "9.1.2",
+    "esbuild": "0.25.12",
     "globals": "16.5.0",
     "jest": "30.2.0",
     "jest-environment-node": "30.2.0",
     "prettier": "3.7.4",
-    "rimraf": "6.1.2",
-    "ts-jest": "29.4.6",
+    "rimraf": "6.1.3",
+    "ts-jest": "29.4.9",
     "typescript": "5.9.3",
-    "drawio-mcp-plugin": "2.0.0"
+    "drawio-mcp-dev-proxy": "1.0.0",
+    "drawio-mcp-plugin": "2.1.0"
   },
   "scripts": {
     "build": "rimraf build && tsc && mkdir -p build/plugin && cp node_modules/drawio-mcp-plugin/dist/mcp-plugin.js build/plugin/mcp-plugin.js",
     "ci": "pnpm install --frozen-lockfile",
     "dev": "tsc --watch",
+    "dev:server": "concurrently --kill-others-on-fail -n tsc,node -c cyan,green \"tsc --watch --preserveWatchOutput\" \"node --watch --watch-path=build build/index.js\"",
     "inspect": "HOST=0.0.0.0 pnpx @modelcontextprotocol/inspector --config ./inspector.json --server drawio",
-    "lint": "tsc --noEmit",
+    "lint": "biome check src/ && tsc --noEmit",
+    "lint:fix": "biome check --write src/",
     "prefetch-assets": "node build/prefetch-assets.js",
     "format": "prettier --write \"**/*.ts\"",
     "format:check": "prettier --check \"**/*.ts\"",
     "test:real-environment": "NODE_OPTIONS=--experimental-vm-modules jest build/real-environment --runInBand",
+    "test:real-environment:https": "HARNESS_HTTPS=1 NODE_OPTIONS=--experimental-vm-modules jest build/real-environment --runInBand",
     "test": "NODE_OPTIONS=--experimental-vm-modules jest build/",
     "test:watch": "jest --watch",
     "test:coverage": "jest --config ../../jest.config.js --coverage",