@milaboratories/pl-mcp-server 0.2.0

package/dist/tools/ui-interaction.cjs

@@ -0,0 +1,117 @@
+const require_types = require("./types.cjs");
+let zod = require("zod");
+//#region src/tools/ui-interaction.ts
+function registerUIInteractionTools(server, ctx) {
+	server.registerTool("click", {
+		description: "Click at coordinates (x, y) in the application window. Use capture_screenshot to find element positions.",
+		inputSchema: {
+			x: zod.z.number().describe("X coordinate"),
+			y: zod.z.number().describe("Y coordinate"),
+			doubleClick: zod.z.boolean().optional().describe("Double click")
+		}
+	}, async ({ x, y, doubleClick }) => {
+		if (!ctx.callbacks.sendInputEvent) return require_types.errorResult("UI interaction is not available.", "Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log");
+		const clickCount = doubleClick ? 2 : 1;
+		await ctx.callbacks.sendInputEvent({
+			type: "mouseDown",
+			x,
+			y,
+			button: "left",
+			clickCount
+		});
+		await ctx.callbacks.sendInputEvent({
+			type: "mouseUp",
+			x,
+			y,
+			button: "left",
+			clickCount
+		});
+		return require_types.textResult({ ok: true });
+	});
+	server.registerTool("type_text", {
+		description: "Type text into the currently focused element",
+		inputSchema: { text: zod.z.string().describe("Text to type") }
+	}, async ({ text }) => {
+		if (!ctx.callbacks.sendInputEvent) return require_types.errorResult("UI interaction is not available.", "Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log");
+		for (const char of text) {
+			await ctx.callbacks.sendInputEvent({
+				type: "keyDown",
+				keyCode: char
+			});
+			await ctx.callbacks.sendInputEvent({
+				type: "char",
+				keyCode: char
+			});
+			await ctx.callbacks.sendInputEvent({
+				type: "keyUp",
+				keyCode: char
+			});
+		}
+		return require_types.textResult({ ok: true });
+	});
+	server.registerTool("press_key", {
+		description: "Press a keyboard key (Enter, Tab, Escape, Backspace, ArrowDown, ArrowUp, etc.)",
+		inputSchema: {
+			key: zod.z.string().describe("Key name (e.g. 'Enter', 'Tab', 'Escape', 'Backspace', 'ArrowDown')"),
+			modifiers: zod.z.array(zod.z.enum([
+				"shift",
+				"control",
+				"alt",
+				"meta"
+			])).optional().describe("Modifier keys to hold")
+		}
+	}, async ({ key, modifiers }) => {
+		if (!ctx.callbacks.sendInputEvent) return require_types.errorResult("UI interaction is not available.", "Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log");
+		await ctx.callbacks.sendInputEvent({
+			type: "keyDown",
+			keyCode: key,
+			...modifiers && {
+				shift: modifiers.includes("shift"),
+				control: modifiers.includes("control"),
+				alt: modifiers.includes("alt"),
+				meta: modifiers.includes("meta")
+			}
+		});
+		await ctx.callbacks.sendInputEvent({
+			type: "keyUp",
+			keyCode: key,
+			...modifiers && {
+				shift: modifiers.includes("shift"),
+				control: modifiers.includes("control"),
+				alt: modifiers.includes("alt"),
+				meta: modifiers.includes("meta")
+			}
+		});
+		return require_types.textResult({ ok: true });
+	});
+	server.registerTool("scroll", {
+		description: "Scroll the page at a given position",
+		inputSchema: {
+			x: zod.z.number().describe("X coordinate to scroll at"),
+			y: zod.z.number().describe("Y coordinate to scroll at"),
+			deltaX: zod.z.number().optional().default(0).describe("Horizontal scroll amount"),
+			deltaY: zod.z.number().describe("Vertical scroll amount (negative = up, positive = down)")
+		}
+	}, async ({ x, y, deltaX, deltaY }) => {
+		if (!ctx.callbacks.sendInputEvent) return require_types.errorResult("UI interaction is not available.", "Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log");
+		await ctx.callbacks.sendInputEvent({
+			type: "mouseWheel",
+			x,
+			y,
+			deltaX: deltaX ?? 0,
+			deltaY
+		});
+		return require_types.textResult({ ok: true });
+	});
+	server.registerTool("execute_js", {
+		description: "Execute JavaScript in the renderer process and return the result. Useful for querying DOM, reading text, or complex interactions.",
+		inputSchema: { code: zod.z.string().describe("JavaScript code to execute") }
+	}, async ({ code }) => {
+		if (!ctx.callbacks.executeJavaScript) return require_types.errorResult("JS execution is not available.", "Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log");
+		return require_types.textResult(await ctx.callbacks.executeJavaScript(code));
+	});
+}
+//#endregion
+exports.registerUIInteractionTools = registerUIInteractionTools;
+
+//# sourceMappingURL=ui-interaction.cjs.map

package/dist/tools/ui-interaction.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-interaction.cjs","names":["z","errorResult","textResult"],"sources":["../../src/tools/ui-interaction.ts"],"sourcesContent":["import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport type { ToolContext } from \"./types\";\nimport { errorResult, textResult } from \"./types\";\n\nexport function registerUIInteractionTools(server: McpServer, ctx: ToolContext): void {\n  server.registerTool(\n    \"click\",\n    {\n      description:\n        \"Click at coordinates (x, y) in the application window. Use capture_screenshot to find element positions.\",\n      inputSchema: {\n        x: z.number().describe(\"X coordinate\"),\n        y: z.number().describe(\"Y coordinate\"),\n        doubleClick: z.boolean().optional().describe(\"Double click\"),\n      },\n    },\n    async ({ x, y, doubleClick }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      const clickCount = doubleClick ? 2 : 1;\n      await ctx.callbacks.sendInputEvent({\n        type: \"mouseDown\",\n        x,\n        y,\n        button: \"left\",\n        clickCount,\n      });\n      await ctx.callbacks.sendInputEvent({ type: \"mouseUp\", x, y, button: \"left\", clickCount });\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"type_text\",\n    {\n      description: \"Type text into the currently focused element\",\n      inputSchema: {\n        text: z.string().describe(\"Text to type\"),\n      },\n    },\n    async ({ text }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      for (const char of text) {\n        await ctx.callbacks.sendInputEvent({ type: \"keyDown\", keyCode: char });\n        await ctx.callbacks.sendInputEvent({ type: \"char\", keyCode: char });\n        await ctx.callbacks.sendInputEvent({ type: \"keyUp\", keyCode: char });\n      }\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"press_key\",\n    {\n      description: \"Press a keyboard key (Enter, Tab, Escape, Backspace, ArrowDown, ArrowUp, etc.)\",\n      inputSchema: {\n        key: z\n          .string()\n          .describe(\"Key name (e.g. 'Enter', 'Tab', 'Escape', 'Backspace', 'ArrowDown')\"),\n        modifiers: z\n          .array(z.enum([\"shift\", \"control\", \"alt\", \"meta\"]))\n          .optional()\n          .describe(\"Modifier keys to hold\"),\n      },\n    },\n    async ({ key, modifiers }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      await ctx.callbacks.sendInputEvent({\n        type: \"keyDown\",\n        keyCode: key,\n        ...(modifiers && {\n          shift: modifiers.includes(\"shift\"),\n          control: modifiers.includes(\"control\"),\n          alt: modifiers.includes(\"alt\"),\n          meta: modifiers.includes(\"meta\"),\n        }),\n      });\n      await ctx.callbacks.sendInputEvent({\n        type: \"keyUp\",\n        keyCode: key,\n        ...(modifiers && {\n          shift: modifiers.includes(\"shift\"),\n          control: modifiers.includes(\"control\"),\n          alt: modifiers.includes(\"alt\"),\n          meta: modifiers.includes(\"meta\"),\n        }),\n      });\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"scroll\",\n    {\n      description: \"Scroll the page at a given position\",\n      inputSchema: {\n        x: z.number().describe(\"X coordinate to scroll at\"),\n        y: z.number().describe(\"Y coordinate to scroll at\"),\n        deltaX: z.number().optional().default(0).describe(\"Horizontal scroll amount\"),\n        deltaY: z.number().describe(\"Vertical scroll amount (negative = up, positive = down)\"),\n      },\n    },\n    async ({ x, y, deltaX, deltaY }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      await ctx.callbacks.sendInputEvent({\n        type: \"mouseWheel\",\n        x,\n        y,\n        deltaX: deltaX ?? 0,\n        deltaY,\n      });\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"execute_js\",\n    {\n      description:\n        \"Execute JavaScript in the renderer process and return the result. Useful for querying DOM, reading text, or complex interactions.\",\n      inputSchema: {\n        code: z.string().describe(\"JavaScript code to execute\"),\n      },\n    },\n    async ({ code }) => {\n      if (!ctx.callbacks.executeJavaScript) {\n        return errorResult(\n          \"JS execution is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      const result = await ctx.callbacks.executeJavaScript(code);\n      return textResult(result);\n    },\n  );\n}\n"],"mappings":";;;AAKA,SAAgB,2BAA2B,QAAmB,KAAwB;AACpF,QAAO,aACL,SACA;EACE,aACE;EACF,aAAa;GACX,GAAGA,IAAAA,EAAE,QAAQ,CAAC,SAAS,eAAe;GACtC,GAAGA,IAAAA,EAAE,QAAQ,CAAC,SAAS,eAAe;GACtC,aAAaA,IAAAA,EAAE,SAAS,CAAC,UAAU,CAAC,SAAS,eAAe;GAC7D;EACF,EACD,OAAO,EAAE,GAAG,GAAG,kBAAkB;AAC/B,MAAI,CAAC,IAAI,UAAU,eACjB,QAAOC,cAAAA,YACL,oCACA,sJACD;EAEH,MAAM,aAAa,cAAc,IAAI;AACrC,QAAM,IAAI,UAAU,eAAe;GACjC,MAAM;GACN;GACA;GACA,QAAQ;GACR;GACD,CAAC;AACF,QAAM,IAAI,UAAU,eAAe;GAAE,MAAM;GAAW;GAAG;GAAG,QAAQ;GAAQ;GAAY,CAAC;AACzF,SAAOC,cAAAA,WAAW,EAAE,IAAI,MAAM,CAAC;GAElC;AAED,QAAO,aACL,aACA;EACE,aAAa;EACb,aAAa,EACX,MAAMF,IAAAA,EAAE,QAAQ,CAAC,SAAS,eAAe,EAC1C;EACF,EACD,OAAO,EAAE,WAAW;AAClB,MAAI,CAAC,IAAI,UAAU,eACjB,QAAOC,cAAAA,YACL,oCACA,sJACD;AAEH,OAAK,MAAM,QAAQ,MAAM;AACvB,SAAM,IAAI,UAAU,eAAe;IAAE,MAAM;IAAW,SAAS;IAAM,CAAC;AACtE,SAAM,IAAI,UAAU,eAAe;IAAE,MAAM;IAAQ,SAAS;IAAM,CAAC;AACnE,SAAM,IAAI,UAAU,eAAe;IAAE,MAAM;IAAS,SAAS;IAAM,CAAC;;AAEtE,SAAOC,cAAAA,WAAW,EAAE,IAAI,MAAM,CAAC;GAElC;AAED,QAAO,aACL,aACA;EACE,aAAa;EACb,aAAa;GACX,KAAKF,IAAAA,EACF,QAAQ,CACR,SAAS,qEAAqE;GACjF,WAAWA,IAAAA,EACR,MAAMA,IAAAA,EAAE,KAAK;IAAC;IAAS;IAAW;IAAO;IAAO,CAAC,CAAC,CAClD,UAAU,CACV,SAAS,wBAAwB;GACrC;EACF,EACD,OAAO,EAAE,KAAK,gBAAgB;AAC5B,MAAI,CAAC,IAAI,UAAU,eACjB,QAAOC,cAAAA,YACL,oCACA,sJACD;AAEH,QAAM,IAAI,UAAU,eAAe;GACjC,MAAM;GACN,SAAS;GACT,GAAI,aAAa;IACf,OAAO,UAAU,SAAS,QAAQ;IAClC,SAAS,UAAU,SAAS,UAAU;IACtC,KAAK,UAAU,SAAS,MAAM;IAC9B,MAAM,UAAU,SAAS,OAAO;IACjC;GACF,CAAC;AACF,QAAM,IAAI,UAAU,eAAe;GACjC,MAAM;GACN,SAAS;GACT,GAAI,aAAa;IACf,OAAO,UAAU,SAAS,QAAQ;IAClC,SAAS,UAAU,SAAS,UAAU;IACtC,KAAK,UAAU,SAAS,MAAM;IAC9B,MAAM,UAAU,SAAS,OAAO;IACjC;GACF,CAAC;AACF,SAAOC,cAAAA,WAAW,EAAE,IAAI,MAAM,CAAC;GAElC;AAED,QAAO,aACL,UACA;EACE,aAAa;EACb,aAAa;GACX,GAAGF,IAAAA,EAAE,QAAQ,CAAC,SAAS,4BAA4B;GACnD,GAAGA,IAAAA,EAAE,QAAQ,CAAC,SAAS,4BAA4B;GACnD,QAAQA,IAAAA,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,SAAS,2BAA2B;GAC7E,QAAQA,IAAAA,EAAE,QAAQ,CAAC,SAAS,0DAA0D;GACvF;EACF,EACD,OAAO,EAAE,GAAG,GAAG,QAAQ,aAAa;AAClC,MAAI,CAAC,IAAI,UAAU,eACjB,QAAOC,cAAAA,YACL,oCACA,sJACD;AAEH,QAAM,IAAI,UAAU,eAAe;GACjC,MAAM;GACN;GACA;GACA,QAAQ,UAAU;GAClB;GACD,CAAC;AACF,SAAOC,cAAAA,WAAW,EAAE,IAAI,MAAM,CAAC;GAElC;AAED,QAAO,aACL,cACA;EACE,aACE;EACF,aAAa,EACX,MAAMF,IAAAA,EAAE,QAAQ,CAAC,SAAS,6BAA6B,EACxD;EACF,EACD,OAAO,EAAE,WAAW;AAClB,MAAI,CAAC,IAAI,UAAU,kBACjB,QAAOC,cAAAA,YACL,kCACA,sJACD;AAGH,SAAOC,cAAAA,WADQ,MAAM,IAAI,UAAU,kBAAkB,KAAK,CACjC;GAE5B"}

package/dist/tools/ui-interaction.js

@@ -0,0 +1,117 @@
+import { errorResult, textResult } from "./types.js";
+import { z } from "zod";
+//#region src/tools/ui-interaction.ts
+function registerUIInteractionTools(server, ctx) {
+	server.registerTool("click", {
+		description: "Click at coordinates (x, y) in the application window. Use capture_screenshot to find element positions.",
+		inputSchema: {
+			x: z.number().describe("X coordinate"),
+			y: z.number().describe("Y coordinate"),
+			doubleClick: z.boolean().optional().describe("Double click")
+		}
+	}, async ({ x, y, doubleClick }) => {
+		if (!ctx.callbacks.sendInputEvent) return errorResult("UI interaction is not available.", "Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log");
+		const clickCount = doubleClick ? 2 : 1;
+		await ctx.callbacks.sendInputEvent({
+			type: "mouseDown",
+			x,
+			y,
+			button: "left",
+			clickCount
+		});
+		await ctx.callbacks.sendInputEvent({
+			type: "mouseUp",
+			x,
+			y,
+			button: "left",
+			clickCount
+		});
+		return textResult({ ok: true });
+	});
+	server.registerTool("type_text", {
+		description: "Type text into the currently focused element",
+		inputSchema: { text: z.string().describe("Text to type") }
+	}, async ({ text }) => {
+		if (!ctx.callbacks.sendInputEvent) return errorResult("UI interaction is not available.", "Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log");
+		for (const char of text) {
+			await ctx.callbacks.sendInputEvent({
+				type: "keyDown",
+				keyCode: char
+			});
+			await ctx.callbacks.sendInputEvent({
+				type: "char",
+				keyCode: char
+			});
+			await ctx.callbacks.sendInputEvent({
+				type: "keyUp",
+				keyCode: char
+			});
+		}
+		return textResult({ ok: true });
+	});
+	server.registerTool("press_key", {
+		description: "Press a keyboard key (Enter, Tab, Escape, Backspace, ArrowDown, ArrowUp, etc.)",
+		inputSchema: {
+			key: z.string().describe("Key name (e.g. 'Enter', 'Tab', 'Escape', 'Backspace', 'ArrowDown')"),
+			modifiers: z.array(z.enum([
+				"shift",
+				"control",
+				"alt",
+				"meta"
+			])).optional().describe("Modifier keys to hold")
+		}
+	}, async ({ key, modifiers }) => {
+		if (!ctx.callbacks.sendInputEvent) return errorResult("UI interaction is not available.", "Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log");
+		await ctx.callbacks.sendInputEvent({
+			type: "keyDown",
+			keyCode: key,
+			...modifiers && {
+				shift: modifiers.includes("shift"),
+				control: modifiers.includes("control"),
+				alt: modifiers.includes("alt"),
+				meta: modifiers.includes("meta")
+			}
+		});
+		await ctx.callbacks.sendInputEvent({
+			type: "keyUp",
+			keyCode: key,
+			...modifiers && {
+				shift: modifiers.includes("shift"),
+				control: modifiers.includes("control"),
+				alt: modifiers.includes("alt"),
+				meta: modifiers.includes("meta")
+			}
+		});
+		return textResult({ ok: true });
+	});
+	server.registerTool("scroll", {
+		description: "Scroll the page at a given position",
+		inputSchema: {
+			x: z.number().describe("X coordinate to scroll at"),
+			y: z.number().describe("Y coordinate to scroll at"),
+			deltaX: z.number().optional().default(0).describe("Horizontal scroll amount"),
+			deltaY: z.number().describe("Vertical scroll amount (negative = up, positive = down)")
+		}
+	}, async ({ x, y, deltaX, deltaY }) => {
+		if (!ctx.callbacks.sendInputEvent) return errorResult("UI interaction is not available.", "Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log");
+		await ctx.callbacks.sendInputEvent({
+			type: "mouseWheel",
+			x,
+			y,
+			deltaX: deltaX ?? 0,
+			deltaY
+		});
+		return textResult({ ok: true });
+	});
+	server.registerTool("execute_js", {
+		description: "Execute JavaScript in the renderer process and return the result. Useful for querying DOM, reading text, or complex interactions.",
+		inputSchema: { code: z.string().describe("JavaScript code to execute") }
+	}, async ({ code }) => {
+		if (!ctx.callbacks.executeJavaScript) return errorResult("JS execution is not available.", "Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log");
+		return textResult(await ctx.callbacks.executeJavaScript(code));
+	});
+}
+//#endregion
+export { registerUIInteractionTools };
+
+//# sourceMappingURL=ui-interaction.js.map

package/dist/tools/ui-interaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-interaction.js","names":[],"sources":["../../src/tools/ui-interaction.ts"],"sourcesContent":["import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport type { ToolContext } from \"./types\";\nimport { errorResult, textResult } from \"./types\";\n\nexport function registerUIInteractionTools(server: McpServer, ctx: ToolContext): void {\n  server.registerTool(\n    \"click\",\n    {\n      description:\n        \"Click at coordinates (x, y) in the application window. Use capture_screenshot to find element positions.\",\n      inputSchema: {\n        x: z.number().describe(\"X coordinate\"),\n        y: z.number().describe(\"Y coordinate\"),\n        doubleClick: z.boolean().optional().describe(\"Double click\"),\n      },\n    },\n    async ({ x, y, doubleClick }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      const clickCount = doubleClick ? 2 : 1;\n      await ctx.callbacks.sendInputEvent({\n        type: \"mouseDown\",\n        x,\n        y,\n        button: \"left\",\n        clickCount,\n      });\n      await ctx.callbacks.sendInputEvent({ type: \"mouseUp\", x, y, button: \"left\", clickCount });\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"type_text\",\n    {\n      description: \"Type text into the currently focused element\",\n      inputSchema: {\n        text: z.string().describe(\"Text to type\"),\n      },\n    },\n    async ({ text }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      for (const char of text) {\n        await ctx.callbacks.sendInputEvent({ type: \"keyDown\", keyCode: char });\n        await ctx.callbacks.sendInputEvent({ type: \"char\", keyCode: char });\n        await ctx.callbacks.sendInputEvent({ type: \"keyUp\", keyCode: char });\n      }\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"press_key\",\n    {\n      description: \"Press a keyboard key (Enter, Tab, Escape, Backspace, ArrowDown, ArrowUp, etc.)\",\n      inputSchema: {\n        key: z\n          .string()\n          .describe(\"Key name (e.g. 'Enter', 'Tab', 'Escape', 'Backspace', 'ArrowDown')\"),\n        modifiers: z\n          .array(z.enum([\"shift\", \"control\", \"alt\", \"meta\"]))\n          .optional()\n          .describe(\"Modifier keys to hold\"),\n      },\n    },\n    async ({ key, modifiers }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      await ctx.callbacks.sendInputEvent({\n        type: \"keyDown\",\n        keyCode: key,\n        ...(modifiers && {\n          shift: modifiers.includes(\"shift\"),\n          control: modifiers.includes(\"control\"),\n          alt: modifiers.includes(\"alt\"),\n          meta: modifiers.includes(\"meta\"),\n        }),\n      });\n      await ctx.callbacks.sendInputEvent({\n        type: \"keyUp\",\n        keyCode: key,\n        ...(modifiers && {\n          shift: modifiers.includes(\"shift\"),\n          control: modifiers.includes(\"control\"),\n          alt: modifiers.includes(\"alt\"),\n          meta: modifiers.includes(\"meta\"),\n        }),\n      });\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"scroll\",\n    {\n      description: \"Scroll the page at a given position\",\n      inputSchema: {\n        x: z.number().describe(\"X coordinate to scroll at\"),\n        y: z.number().describe(\"Y coordinate to scroll at\"),\n        deltaX: z.number().optional().default(0).describe(\"Horizontal scroll amount\"),\n        deltaY: z.number().describe(\"Vertical scroll amount (negative = up, positive = down)\"),\n      },\n    },\n    async ({ x, y, deltaX, deltaY }) => {\n      if (!ctx.callbacks.sendInputEvent) {\n        return errorResult(\n          \"UI interaction is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      await ctx.callbacks.sendInputEvent({\n        type: \"mouseWheel\",\n        x,\n        y,\n        deltaX: deltaX ?? 0,\n        deltaY,\n      });\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"execute_js\",\n    {\n      description:\n        \"Execute JavaScript in the renderer process and return the result. Useful for querying DOM, reading text, or complex interactions.\",\n      inputSchema: {\n        code: z.string().describe(\"JavaScript code to execute\"),\n      },\n    },\n    async ({ code }) => {\n      if (!ctx.callbacks.executeJavaScript) {\n        return errorResult(\n          \"JS execution is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      const result = await ctx.callbacks.executeJavaScript(code);\n      return textResult(result);\n    },\n  );\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@milaboratories/pl-mcp-server",
+  "version": "0.2.0",
+  "description": "MCP server for Platforma Desktop",
+  "keywords": [],
+  "license": "UNLICENSED",
+  "files": [
+    "dist/**/*",
+    "src/**/*"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "quickjs-emscripten": "0.31.0",
+    "zod": "~3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "~24.5.2",
+    "@vitest/coverage-istanbul": "^4.1.3",
+    "typescript": "~5.9.3",
+    "vitest": "^4.1.3",
+    "@milaboratories/build-configs": "2.0.0",
+    "@milaboratories/pl-middle-layer": "1.55.5",
+    "@milaboratories/pl-model-common": "1.31.1",
+    "@milaboratories/ts-configs": "1.2.3",
+    "@platforma-sdk/model": "1.63.1",
+    "@milaboratories/ts-builder": "1.3.1"
+  },
+  "peerDependencies": {
+    "@milaboratories/pl-middle-layer": ">=1.48.0",
+    "@platforma-sdk/model": ">=1.60.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "ts-builder build --target node",
+    "watch": "ts-builder build --target node --watch",
+    "check": "ts-builder check --target node",
+    "formatter:check": "ts-builder formatter --check",
+    "linter:check": "ts-builder linter --check",
+    "types:check": "ts-builder type-check --target node",
+    "test": "vitest run",
+    "do-pack": "rm -f *.tgz && pnpm pack && mv *.tgz package.tgz",
+    "fmt": "ts-builder format"
+  }
+}

package/src/index.ts

@@ -0,0 +1,7 @@
+export { PlMcpServer } from "./server";
+export type {
+  PlMcpServerOptions,
+  PlMcpServerCallbacks,
+  ServerConnection,
+  McpSecret,
+} from "./server";

package/src/server.ts

@@ -0,0 +1,271 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { createServer, type IncomingMessage, type Server, type ServerResponse } from "node:http";
+import { randomUUID } from "node:crypto";
+import { type MiddleLayer, resourceIdToString } from "@milaboratories/pl-middle-layer";
+import type { Branded } from "@milaboratories/pl-model-common";
+import type { ToolContext } from "./tools/types";
+import { registerPingTool } from "./tools/ping";
+import { registerConnectionTools } from "./tools/connection";
+import { registerProjectTools } from "./tools/projects";
+import { registerBlockTools } from "./tools/blocks";
+import { registerBlockStateTools } from "./tools/block-state";
+import { registerAwaitTools } from "./tools/await";
+import { registerLogTools } from "./tools/logs";
+import { registerDataQueryTools } from "./tools/data-query";
+import { registerScreenshotTool } from "./tools/screenshot";
+import { registerUIInteractionTools } from "./tools/ui-interaction";
+
+export interface PlMcpServerCallbacks {
+  onProjectCreated?: (projectId: string) => void | Promise<void>;
+  onProjectOpened?: (projectId: string) => void | Promise<void>;
+  onProjectClosed?: (projectId: string) => void | Promise<void>;
+  onProjectDeleted?: (projectId: string) => void | Promise<void>;
+  /** Capture the current application window as a PNG screenshot. Returns base64-encoded PNG. */
+  captureScreenshot?: () => Promise<string>;
+  /** Send an input event to the application window. */
+  sendInputEvent?: (event: unknown) => Promise<void>;
+  /** Execute JavaScript in the renderer and return the result. */
+  executeJavaScript?: (code: string) => Promise<unknown>;
+  /** List available blocks from all configured registries. */
+  listAvailableBlocks?: (query?: string) => Promise<unknown[]>;
+  /** Navigate the desktop UI to show a specific block. */
+  selectBlock?: (projectId: string, blockId: string) => Promise<void>;
+  /** Read recent lines from the application log. */
+  readAppLog?: (lines: number, search?: string) => Promise<string>;
+  /** List saved server connections. */
+  listConnections?: () => Promise<ServerConnection[]>;
+  /** Connect to a server. */
+  connectToServer?: (
+    addr: string,
+    login: string,
+    password?: string,
+  ) => Promise<{ status: string; message: string }>;
+  /** Get current connection status. */
+  getConnectionStatus?: () => Promise<{
+    connected: boolean;
+    type?: string;
+    addr?: string;
+    login?: string;
+  }>;
+  /** Disconnect from current server. */
+  disconnect?: () => Promise<void>;
+  /** Get detailed info about a specific block package. */
+  getBlockInfo?: (
+    registryUrl: string,
+    organization: string,
+    name: string,
+    version: string,
+  ) => Promise<unknown>;
+}
+
+export interface ServerConnection {
+  addr: string;
+  login: string;
+  coreVersion?: string;
+  lastConnected?: string;
+}
+
+/** Branded type for the MCP server URL secret path segment. */
+export type McpSecret = Branded<string, "McpSecret">;
+
+export interface PlMcpServerOptions {
+  /** MiddleLayer instance providing access to projects, blocks, etc. Optional — server can start without it. */
+  middleLayer?: MiddleLayer;
+  /** Port to listen on. */
+  port: number;
+  /** Secret path segment for URL security. */
+  secret: McpSecret;
+  /** Optional callbacks for project lifecycle events (e.g. to sync UI state). */
+  callbacks?: PlMcpServerCallbacks;
+}
+
+export class PlMcpServer {
+  private ml: MiddleLayer | null;
+  private port: number;
+  private readonly secret: McpSecret;
+  private readonly callbacks: PlMcpServerCallbacks;
+  private httpServer: Server | undefined;
+  private readonly transports = new Map<string, StreamableHTTPServerTransport>();
+
+  constructor(options: PlMcpServerOptions) {
+    this.ml = options.middleLayer ?? null;
+    this.port = options.port;
+    this.secret = options.secret;
+    this.callbacks = options.callbacks ?? {};
+  }
+
+  /** Set or update the MiddleLayer instance (e.g. after connecting to a server). */
+  setMiddleLayer(ml: MiddleLayer | null | undefined) {
+    this.ml = ml ?? null;
+  }
+
+  get url(): string {
+    return `http://127.0.0.1:${this.port}/${this.secret}/mcp`;
+  }
+
+  async start(): Promise<void> {
+    if (this.httpServer) {
+      throw new Error("MCP server is already running");
+    }
+
+    const expectedPath = `/${this.secret}/mcp`;
+
+    this.httpServer = createServer(async (req: IncomingMessage, res: ServerResponse) => {
+      try {
+        // Origin validation — only allow localhost
+        if (req.headers.origin !== undefined) {
+          try {
+            const origin = new URL(req.headers.origin);
+            if (origin.hostname !== "localhost" && origin.hostname !== "127.0.0.1") {
+              res.writeHead(403, { "Content-Type": "application/json" });
+              res.end(JSON.stringify({ error: "Forbidden" }));
+              return;
+            }
+          } catch {
+            res.writeHead(403, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ error: "Forbidden" }));
+            return;
+          }
+        }
+
+        // Secret path check
+        if (req.url !== expectedPath) {
+          res.writeHead(404, { "Content-Type": "application/json" });
+          res.end(JSON.stringify({ error: "Not Found" }));
+          return;
+        }
+
+        // Route to existing session transport
+        const sessionId = req.headers["mcp-session-id"] as string | undefined;
+        if (sessionId && this.transports.has(sessionId)) {
+          await this.transports.get(sessionId)!.handleRequest(req, res);
+          return;
+        }
+
+        // New session — create transport and connect MCP server
+        const transport = new StreamableHTTPServerTransport({
+          sessionIdGenerator: () => randomUUID(),
+        });
+        transport.onclose = () => {
+          const sid = transport.sessionId;
+          if (sid) this.transports.delete(sid);
+        };
+
+        const server = this.createMcpServer();
+        await server.connect(transport);
+        await transport.handleRequest(req, res);
+
+        const sid = transport.sessionId;
+        if (sid) this.transports.set(sid, transport);
+      } catch {
+        if (!res.headersSent) {
+          res.writeHead(500, { "Content-Type": "application/json" });
+          res.end(JSON.stringify({ error: "Internal Server Error" }));
+        }
+      }
+    });
+
+    const maxRetries = 10;
+    const requestHandler = this.httpServer.listeners("request")[0] as (
+      req: IncomingMessage,
+      res: ServerResponse,
+    ) => void;
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+      const server = this.httpServer;
+      try {
+        await new Promise<void>((resolve, reject) => {
+          server.listen(this.port, "127.0.0.1", () => resolve());
+          server.once("error", reject);
+        });
+        // Read back the actual port (important when port is 0)
+        const addr = server.address();
+        if (addr && typeof addr === "object") {
+          this.port = addr.port;
+        }
+        return;
+      } catch (err: unknown) {
+        if (
+          err instanceof Error &&
+          "code" in err &&
+          err.code === "EADDRINUSE" &&
+          attempt < maxRetries - 1
+        ) {
+          server.removeAllListeners();
+          this.httpServer = createServer(requestHandler);
+          this.port++;
+          continue;
+        }
+        throw err;
+      }
+    }
+  }
+
+  async stop(): Promise<void> {
+    for (const transport of this.transports.values()) {
+      await transport.close();
+    }
+    this.transports.clear();
+
+    const server = this.httpServer;
+    if (server) {
+      await new Promise<void>((resolve, reject) => {
+        server.close((err) => (err ? reject(err) : resolve()));
+      });
+      this.httpServer = undefined;
+    }
+  }
+
+  private createMcpServer(): McpServer {
+    const sessionId = randomUUID().slice(0, 8);
+    const server = new McpServer({ name: "pl", version: "0.1.0" }, { capabilities: { tools: {} } });
+    this.registerTools(server, sessionId);
+    return server;
+  }
+
+  private registerTools(server: McpServer, sessionId: string): void {
+    const authorId = `mcp-${sessionId}`;
+    let localVersion = 0;
+    const ctx: ToolContext = {
+      getMl: () => this.ml,
+      requireMl: () => this.requireMl(),
+      resolveProject: (id) => this.resolveProject(id),
+      getOpenedProject: (id) => this.getOpenedProject(id),
+      callbacks: this.callbacks,
+      getAuthorMarker: () => ({ authorId, localVersion: ++localVersion }),
+    };
+    registerPingTool(server, ctx);
+    registerConnectionTools(server, ctx);
+    registerProjectTools(server, ctx);
+    registerBlockTools(server, ctx);
+    registerBlockStateTools(server, ctx);
+    registerAwaitTools(server, ctx);
+    registerLogTools(server, ctx);
+    registerDataQueryTools(server, ctx);
+    registerScreenshotTool(server, ctx);
+    registerUIInteractionTools(server, ctx);
+  }
+
+  /** Throws if MiddleLayer is not available (not connected to a server). */
+  private requireMl(): MiddleLayer {
+    if (!this.ml) throw new Error("Not connected to a server. Use connect_to_server first.");
+    return this.ml;
+  }
+
+  /** Resolves a project from the list by its projectId (resourceIdToString format). */
+  private async resolveProject(projectId: string) {
+    const ml = this.requireMl();
+    await ml.projectList.refreshState();
+    const projects = await ml.projectList.awaitStableValue();
+    const entry = projects.find((p) => resourceIdToString(p.rid) === projectId);
+    if (!entry) throw new Error(`Project ${projectId} not found`);
+    return entry;
+  }
+
+  /** Gets an opened project by projectId. Resolves via project list → rid → getOpenedProject. */
+  private async getOpenedProject(projectId: string) {
+    const ml = this.requireMl();
+    const entry = await this.resolveProject(projectId);
+    return ml.getOpenedProject(entry.rid);
+  }
+}