drawio-mcp-server 1.0.3 → 1.1.1

package/README.md

@@ -130,6 +130,54 @@ The configuration is usually in: ~/.local/share/oterm/config.json
 ```
 </details>
 
+### Connect with Zed
+
+1. Open the Zed Preview application.
+1. Click the Assistant (✨) icon in the bottom right corner.
+1. Click Settings in the top right panel of the Assistant.
+1. In the Context Servers section, click + Add Context Server.
+1. Configure with the following:
+
+<details>
+  <summary>Using <code>npm</code></summary>
+
+```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"],
+      /// The environment variables to set for the executable
+      "env": {}
+    }
+  }
+}
+```
+</details>
+
+<details>
+  <summary>Using <code>pnpm</code></summary>
+
+```json
+{
+  /// 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": {}
+    }
+  }
+}
+```
+</details>
+
 ### Browser Extension Setup
 
 In order to control the Draw.io diagram, you need to install dedicated Browser Extension.
@@ -151,6 +199,28 @@ In order to control the Draw.io diagram, you need to install dedicated Browser E
 3. Ensure it is connected, the Extension icon should indicate green signal overlay <img alt="Extension connected" src="https://raw.githubusercontent.com/lgazo/drawio-mcp-extension/refs/heads/main/public/icon/logo_connected_32.png" />
 
 
+## Sponsoring
+
+If you enjoy the project or find it useful, consider supporting its continued development.
+
+
+lightning invoice:
+
+![lightning invoice](./lightning_qr.png)
+
+```
+lnbc1p5f8wvnpp5kk0qt60waplesw3sjxu7tcqwmdp6ysq570dc4ln52krd3u5nzq6sdp82pshjgr5dusyymrfde4jq4mpd3kx2apq24ek2uscqzpuxqr8pqsp5gvr72xcs883qt4hea6v3u7803stcwfnk5c9w0ykqr9a40qqwnpys9qxpqysgqfzlhm0cz5vqy7wqt7rwpmkacukrk59k89ltd5n642wzru2jn88tyd78gr4y3j6u64k2u4sd4qgavlsnccl986velrg3x0pe95sx7p4sqtatttp
+```
+
+lightning address:
+```
+ladislav@blink.sv
+```
+
+<div align="center">
+<a href="https://liberapay.com/ladislav/donate"><img alt="Donate using Liberapay" src="https://liberapay.com/assets/widgets/donate.svg"></a>
+</div>
+
 ## Features
 
 The Draw.io MCP server provides the following tools for programmatic diagram interaction:
@@ -176,6 +246,9 @@ The Draw.io MCP server provides the following tools for programmatic diagram int
     - `shape_name`: Name of the shape to retrieve
   *Returns*: Shape object including its category and style information
 
+- **`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.
+
 ### Diagram Modification Tools
 - **`add-rectangle`**
   Creates a new rectangle shape on the active Draw.io page with customizable properties:
@@ -217,3 +290,13 @@ The Draw.io MCP server provides the following tools for programmatic diagram int
 [Architecture](./ARCHITECTURE.md)
 
 [Development](./DEVELOPMENT.md)
+
+## Star History
+
+<a href="https://star-history.com/#lgazo/drawio-mcp-server&Date">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=lgazo/drawio-mcp-server&type=Date&theme=dark" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=lgazo/drawio-mcp-server&type=Date" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=lgazo/drawio-mcp-server&type=Date" />
+ </picture>
+</a>

package/build/index.js

@@ -36,6 +36,7 @@ const bus_to_ws_forwarder_listener = (event) => {
 };
 emitter.on(bus_request_stream, bus_to_ws_forwarder_listener);
 const ws_handler = {
+    maxPayloadLength: 128 * 1024,
     open: (ws) => {
         log.debug(`[ws_handler] A WebSocket client #${conns.length} connected, presumably MCP Extension!`);
         conns.push(ws);
@@ -50,7 +51,7 @@ const ws_handler = {
         emitter.emit(bus_reply_stream, json);
     },
     close: (ws, code, message) => {
-        log.debug("[ws_handler] WebSocket client closed");
+        log.debug(`[ws_handler] WebSocket client closed with code ${code}`);
         //todo remove conn
     },
 };
@@ -197,6 +198,33 @@ server.tool(TOOL_add_cell_of_shape, "This tool allows you to add new vertex cell
         .optional()
         .describe("Semi-colon separated list of Draw.io visual styles, in the form of `key=value`. Example: `whiteSpace=wrap;html=1;fillColor=#f5f5f5;strokeColor=#666666;`"),
 }, default_tool(TOOL_add_cell_of_shape, context));
+const TOOL_list_paged_model = "list-paged-model";
+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.", {
+    page: z
+        .number()
+        .optional()
+        .describe("Zero-based page number for pagination. Page 0 returns the first batch of cells, page 1 returns the next batch, etc. Default is 0.")
+        .default(0),
+    page_size: z
+        .number()
+        .optional()
+        .describe("Maximum number of cells to return in a single page. Controls response size and performance. Must be between 1 and 1000. Default is 50.")
+        .default(50),
+    filter: z
+        .object({
+        cell_type: z
+            .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"),
+        attributes: z
+            .array(z.any())
+            .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));
 async function main() {
     log.debug("Draw.io MCP Server starting");
     await start_websocket_server();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "drawio-mcp-server",
-  "version": "1.0.3",
+  "version": "1.1.1",
   "description": "Provides Draw.io services to MCP Clients",
   "type": "module",
   "main": "index.js",
@@ -47,7 +47,7 @@
     "build": "tsc",
     "ci": "pnpm install --frozen-lockfile",
     "dev": "tsc --watch",
-    "inspect": "pnpx @modelcontextprotocol/inspector node build/index.js",
+    "inspect": "HOST=0.0.0.0 pnpx @modelcontextprotocol/inspector node build/index.js",
     "lint": "tsc --noEmit",
     "format": "prettier --write \"src/**/*.ts\"",
     "format:check": "prettier --check \"src/**/*.ts\"",