@wordbricks/playwright-mcp 0.1.9 → 0.1.11

package/config.d.ts

@@ -68,6 +68,11 @@ export type Config = {
      * Path to a JavaScript file to inject into all pages using addInitScript.
      */
     initScript?: string;
+
+    /**
+     * URL to launch in Chrome app mode.
+     */
+    app?: string;
   },
 
   server?: {

package/lib/browserServerBackend.js

@@ -51,6 +51,8 @@ export class BrowserServerBackend {
             sessionLog: this._sessionLog,
             clientInfo: { ...server.getClientVersion(), rootPath },
         });
+        if (this._config.browser.app)
+            await this._context.ensureTab();
     }
     async listTools() {
         return this._tools.map(tool => toMcpTool(tool.schema));

package/lib/config.js

@@ -82,6 +82,42 @@ export function configFromCLIOptions(cliOptions) {
     // --no-sandbox was passed, disable the sandbox
     if (cliOptions.sandbox === false)
         launchOptions.chromiumSandbox = false;
+    // Add default Chrome args to avoid automation detection
+    if (browserName === 'chromium') {
+        launchOptions.args = launchOptions.args || [];
+        launchOptions.args.push('--disable-blink-features=AutomationControlled');
+    }
+    // --app was passed, add app mode argument
+    if (cliOptions.app) {
+        launchOptions.args = launchOptions.args || [];
+        launchOptions.args.push(`--app=${cliOptions.app}`);
+    }
+    // --window-position was passed, add window position argument
+    if (cliOptions.windowPosition) {
+        try {
+            const [x, y] = cliOptions.windowPosition.split(',').map(n => +n);
+            if (isNaN(x) || isNaN(y))
+                throw new Error('bad values');
+            launchOptions.args = launchOptions.args || [];
+            launchOptions.args.push(`--window-position=${x},${y}`);
+        }
+        catch (e) {
+            throw new Error('Invalid window position format: use "x,y", for example --window-position="100,200"');
+        }
+    }
+    // --window-size was passed, add window size argument
+    if (cliOptions.windowSize) {
+        try {
+            const [width, height] = cliOptions.windowSize.split(',').map(n => +n);
+            if (isNaN(width) || isNaN(height))
+                throw new Error('bad values');
+            launchOptions.args = launchOptions.args || [];
+            launchOptions.args.push(`--window-size=${width},${height}`);
+        }
+        catch (e) {
+            throw new Error('Invalid window size format: use "width,height", for example --window-size="1280,720"');
+        }
+    }
     if (cliOptions.proxyServer) {
         launchOptions.proxy = {
             server: cliOptions.proxyServer
@@ -121,6 +157,7 @@ export function configFromCLIOptions(cliOptions) {
             contextOptions,
             cdpEndpoint: cliOptions.cdpEndpoint,
             initScript: cliOptions.initScript,
+            app: cliOptions.app,
         },
         server: {
             port: cliOptions.port,
@@ -141,6 +178,7 @@ export function configFromCLIOptions(cliOptions) {
 function configFromEnv() {
     const options = {};
     options.allowedOrigins = semicolonSeparatedList(process.env.PLAYWRIGHT_MCP_ALLOWED_ORIGINS);
+    options.app = envToString(process.env.PLAYWRIGHT_MCP_APP);
     options.blockedOrigins = semicolonSeparatedList(process.env.PLAYWRIGHT_MCP_BLOCKED_ORIGINS);
     options.blockServiceWorkers = envToBoolean(process.env.PLAYWRIGHT_MCP_BLOCK_SERVICE_WORKERS);
     options.browser = envToString(process.env.PLAYWRIGHT_MCP_BROWSER);
@@ -166,6 +204,8 @@ function configFromEnv() {
     options.userAgent = envToString(process.env.PLAYWRIGHT_MCP_USER_AGENT);
     options.userDataDir = envToString(process.env.PLAYWRIGHT_MCP_USER_DATA_DIR);
     options.viewportSize = envToString(process.env.PLAYWRIGHT_MCP_VIEWPORT_SIZE);
+    options.windowPosition = envToString(process.env.PLAYWRIGHT_MCP_WINDOW_POSITION);
+    options.windowSize = envToString(process.env.PLAYWRIGHT_MCP_WINDOW_SIZE);
     return configFromCLIOptions(options);
 }
 async function loadConfig(configFile) {

package/lib/program.js

@@ -53,6 +53,9 @@ program
     .option('--user-agent <ua string>', 'specify user agent string')
     .option('--user-data-dir <path>', 'path to the user data directory. If not specified, a temporary directory will be created.')
     .option('--viewport-size <size>', 'specify browser viewport size in pixels, for example "1280, 720"')
+    .option('--window-position <x,y>', 'specify Chrome window position in pixels, for example "100,200"')
+    .option('--window-size <width,height>', 'specify Chrome window size in pixels, for example "1280,720"')
+    .option('--app <url>', 'launch browser in app mode with the specified URL')
     .addOption(new Option('--extension', 'Connect to a running browser instance (Edge/Chrome only). Requires the "Playwright MCP Bridge" browser extension to be installed.').hideHelp())
     .addOption(new Option('--connect-tool', 'Allow to switch between different browser connection methods.').hideHelp())
     .addOption(new Option('--loop-tools', 'Run loop tools').hideHelp())

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wordbricks/playwright-mcp",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "Playwright Tools for MCP",
   "type": "module",
   "repository": {