rae-playwright-mcp 0.0.7 → 0.0.8

package/README.md

@@ -320,7 +320,8 @@ Playwright MCP server supports following arguments. They can be provided in the
 
 This fork includes additional features beyond the original Playwright MCP:
 
-- **`--run-id <id>`**: Specify a custom UUID for HAR file organization. HAR files are saved to `~/.reverse-api/runs/har/{run-id}/network.har`. If not provided, a UUID is automatically generated.
+- **`--run-id <id>`**: Specify a custom UUID for HAR file organization. HAR files are saved to `{save-har-path}/{run-id}/recording.har` (or `~/.reverse-api/runs/har/{run-id}/recording.har` by default). If not provided, a UUID is automatically generated.
+- **`--save-har-path <path>`**: Specify a custom directory path where HAR files should be saved. HAR files will be saved to `{path}/{run-id}/recording.har`. If not provided, defaults to `~/.reverse-api/runs/har`.
 - **Automatic HAR Recording**: All browser sessions automatically record network traffic in HAR format. The HAR file path is logged when the server starts.
 - **Default Tracing**: Tracing capabilities are enabled by default with source code capture (`sources: true`)
 - **Self-contained Package**: All MCP code is bundled in the package, no dependency on the Playwright monorepo
@@ -331,6 +332,7 @@ This is a fork of the official [Playwright MCP](https://github.com/microsoft/pla
 
 - HAR recording enabled by default for all browser contexts
 - Custom `--run-id` CLI option for organizing HAR files
+- Custom `--save-har-path` CLI option for specifying HAR file directory
 - Tracing enabled by default with source code capture
 - Self-contained package (all code bundled, no monorepo dependency)
 
@@ -448,6 +450,9 @@ Options:
   --run-id <id>                         External UUID to use for HAR directory.
                                         If not provided, a UUID will be
                                         generated.
+  --save-har-path <path>                path to the directory where HAR files
+                                        should be saved. HAR files will be saved
+                                        to {path}/{run-id}/recording.har
 ```
 
 <!--- End of options generated section -->
@@ -718,6 +723,12 @@ npx rae-playwright-mcp@latest --config path/to/config.json
    * External UUID to use for HAR directory. If not provided, a UUID will be generated.
    */
   runId?: string;
+
+  /**
+   * Path to the directory where HAR files should be saved. HAR files will be saved to {saveHarPath}/{runId}/recording.har.
+   * If not provided, defaults to ~/.reverse-api/runs/har/{runId}/recording.har.
+   */
+  saveHarPath?: string;
 }
 ```
 

package/config.d.ts

@@ -194,4 +194,10 @@ export type Config = {
    * External UUID to use for HAR directory. If not provided, a UUID will be generated.
    */
   runId?: string;
+
+  /**
+   * Path to the directory where HAR files should be saved. HAR files will be saved to {saveHarPath}/{runId}/recording.har.
+   * If not provided, defaults to ~/.reverse-api/runs/har/{runId}/recording.har.
+   */
+  saveHarPath?: string;
 };

package/lib/mcp/browser/browserContextFactory.js

@@ -91,7 +91,7 @@ class BaseContextFactory {
   async createContext(clientInfo) {
     (0, import_log.testDebug)(`create browser context (${this._logName})`);
     const browser = await this._obtainBrowser(clientInfo);
-    const harDir = await computeHarDir(clientInfo, this.config.runId);
+    const harDir = await computeHarDir(this.config, clientInfo, this.config.runId);
     const browserContext = await this._doCreateContext(browser, harDir);
     await addInitScript(browserContext, this.config.browser.initScript);
     return {
@@ -182,7 +182,7 @@ class PersistentContextFactory {
     const tracesDir = await computeTracesDir(this.config, clientInfo);
     if (tracesDir && this.config.saveTrace)
       await startTraceServer(this.config, tracesDir);
-    const harDir = await computeHarDir(clientInfo, this.config.runId);
+    const harDir = await computeHarDir(this.config, clientInfo, this.config.runId);
     this._userDataDirs.add(userDataDir);
     (0, import_log.testDebug)("lock user data dir", userDataDir);
     const browserType = playwright[this.config.browser.browserName];
@@ -309,11 +309,12 @@ async function computeTracesDir(config, clientInfo) {
     return;
   return await (0, import_config.outputFile)(config, clientInfo, `traces`, { origin: "code", reason: "Collecting trace" });
 }
-async function computeHarDir(clientInfo, runId) {
+async function computeHarDir(config, clientInfo, runId) {
   const finalRunId = runId || import_crypto.default.randomUUID();
-  const harDir = import_path.default.join(import_os.default.homedir(), ".reverse-api", "runs", "har", finalRunId);
+  const baseDir = config.saveHarPath || import_path.default.join(import_os.default.homedir(), ".reverse-api", "runs", "har");
+  const harDir = import_path.default.join(baseDir, finalRunId);
   await import_fs.default.promises.mkdir(harDir, { recursive: true });
-  const harPath = import_path.default.join(harDir, "network.har");
+  const harPath = import_path.default.join(harDir, "recording.har");
   console.error(`HAR recording enabled. HAR file will be saved to: ${harPath}`);
   return harDir;
 }
@@ -327,7 +328,7 @@ function browserContextOptionsFromConfig(config, harDir) {
   }
   if (harDir) {
     result.recordHar = {
-      path: import_path.default.join(harDir, "network.har"),
+      path: import_path.default.join(harDir, "recording.har"),
       content: "attach",
       mode: "full"
     };

package/lib/mcp/browser/config.js

@@ -200,7 +200,8 @@ function configFromCLIOptions(cliOptions) {
       action: cliOptions.timeoutAction,
       navigation: cliOptions.timeoutNavigation
     },
-    runId: cliOptions.runId
+    runId: cliOptions.runId,
+    saveHarPath: cliOptions.saveHarPath
   };
   return result;
 }
@@ -248,6 +249,7 @@ function configFromEnv() {
   options.userDataDir = envToString(process.env.PLAYWRIGHT_MCP_USER_DATA_DIR);
   options.viewportSize = resolutionParser("--viewport-size", process.env.PLAYWRIGHT_MCP_VIEWPORT_SIZE);
   options.runId = envToString(process.env.PLAYWRIGHT_MCP_RUN_ID);
+  options.saveHarPath = envToString(process.env.PLAYWRIGHT_MCP_SAVE_HAR_PATH);
   return configFromCLIOptions(options);
 }
 async function loadConfig(configFile) {

package/lib/mcp/browser/context.js

@@ -206,8 +206,10 @@ class Context {
     } else {
       const runId = this.config.runId;
       const finalRunId = runId || import_crypto.default.randomUUID();
-      const harDir = import_path.default.join(import_os.default.homedir(), ".reverse-api", "runs", "har", finalRunId);
-      this._harPath = import_path.default.join(harDir, "network.har");
+      const baseDir = this.config.saveHarPath || import_path.default.join(import_os.default.homedir(), ".reverse-api", "runs", "har");
+      const harDir = import_path.default.join(baseDir, finalRunId);
+      await import_fs.default.promises.mkdir(harDir, { recursive: true });
+      this._harPath = import_path.default.join(harDir, "recording.har");
     }
     await this._setupRequestInterception(browserContext);
     if (this.sessionLog)

package/lib/mcp/program.js

@@ -41,7 +41,7 @@ var import_browserContextFactory = require("./browser/browserContextFactory");
 var import_browserServerBackend = require("./browser/browserServerBackend");
 var import_extensionContextFactory = require("./extension/extensionContextFactory");
 function decorateCommand(command, version) {
-  command.option("--allowed-hosts <hosts...>", "comma-separated list of hosts this server is allowed to serve from. Defaults to the host the server is bound to. Pass '*' to disable the host check.", import_config.commaSeparatedList).option("--allowed-origins <origins>", "semicolon-separated list of TRUSTED origins to allow the browser to request. Default is to allow all.\nImportant: *does not* serve as a security boundary and *does not* affect redirects. ", import_config.semicolonSeparatedList).option("--blocked-origins <origins>", "semicolon-separated list of origins to block the browser from requesting. Blocklist is evaluated before allowlist. If used without the allowlist, requests not matching the blocklist are still allowed.\nImportant: *does not* serve as a security boundary and *does not* affect redirects.", import_config.semicolonSeparatedList).option("--block-service-workers", "block service workers").option("--browser <browser>", "browser or chrome channel to use, possible values: chrome, firefox, webkit, msedge.").option("--caps <caps>", "comma-separated list of additional capabilities to enable, possible values: vision, pdf.", import_config.commaSeparatedList).option("--cdp-endpoint <endpoint>", "CDP endpoint to connect to.").option("--cdp-header <headers...>", "CDP headers to send with the connect request, multiple can be specified.", import_config.headerParser).option("--config <path>", "path to the configuration file.").option("--console-level <level>", 'level of console messages to return: "error", "warning", "info", "debug". Each level includes the messages of more severe levels.', import_config.enumParser.bind(null, "--console-level", ["error", "warning", "info", "debug"])).option("--device <device>", 'device to emulate, for example: "iPhone 15"').option("--executable-path <path>", "path to the browser executable.").option("--extension", 'Connect to a running browser instance (Edge/Chrome only). Requires the "Playwright MCP Bridge" browser extension to be installed.').option("--grant-permissions <permissions...>", 'List of permissions to grant to the browser context, for example "geolocation", "clipboard-read", "clipboard-write".', import_config.commaSeparatedList).option("--headless", "run browser in headless mode, headed by default").option("--host <host>", "host to bind server to. Default is localhost. Use 0.0.0.0 to bind to all interfaces.").option("--ignore-https-errors", "ignore https errors").option("--init-page <path...>", "path to TypeScript file to evaluate on Playwright page object").option("--init-script <path...>", "path to JavaScript file to add as an initialization script. The script will be evaluated in every page before any of the page's scripts. Can be specified multiple times.").option("--isolated", "keep the browser profile in memory, do not save it to disk.").option("--image-responses <mode>", 'whether to send image responses to the client. Can be "allow" or "omit", Defaults to "allow".', import_config.enumParser.bind(null, "--image-responses", ["allow", "omit"])).option("--no-sandbox", "disable the sandbox for all process types that are normally sandboxed.").option("--output-dir <path>", "path to the directory for output files.").option("--port <port>", "port to listen on for SSE transport.").option("--proxy-bypass <bypass>", 'comma-separated domains to bypass proxy, for example ".com,chromium.org,.domain.com"').option("--proxy-server <proxy>", 'specify proxy server, for example "http://myproxy:3128" or "socks5://myproxy:8080"').option("--save-session", "Whether to save the Playwright MCP session into the output directory.").option("--save-trace", "Whether to save the Playwright Trace of the session into the output directory.").option("--save-video <size>", 'Whether to save the video of the session into the output directory. For example "--save-video=800x600"', import_config.resolutionParser.bind(null, "--save-video")).option("--secrets <path>", "path to a file containing secrets in the dotenv format", import_config.dotenvFileLoader).option("--shared-browser-context", "reuse the same browser context between all connected HTTP clients.").option("--snapshot-mode <mode>", 'when taking snapshots for responses, specifies the mode to use. Can be "incremental", "full", or "none". Default is incremental.').option("--storage-state <path>", "path to the storage state file for isolated sessions.").option("--test-id-attribute <attribute>", 'specify the attribute to use for test ids, defaults to "data-testid"').option("--timeout-action <timeout>", "specify action timeout in milliseconds, defaults to 5000ms", import_config.numberParser).option("--timeout-navigation <timeout>", "specify navigation timeout in milliseconds, defaults to 60000ms", import_config.numberParser).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 "1280x720"', import_config.resolutionParser.bind(null, "--viewport-size")).option("--run-id <id>", "External UUID to use for HAR directory. If not provided, a UUID will be generated.").addOption(new import_utilsBundle.ProgramOption("--vision", "Legacy option, use --caps=vision instead").hideHelp()).action(async (options) => {
+  command.option("--allowed-hosts <hosts...>", "comma-separated list of hosts this server is allowed to serve from. Defaults to the host the server is bound to. Pass '*' to disable the host check.", import_config.commaSeparatedList).option("--allowed-origins <origins>", "semicolon-separated list of TRUSTED origins to allow the browser to request. Default is to allow all.\nImportant: *does not* serve as a security boundary and *does not* affect redirects. ", import_config.semicolonSeparatedList).option("--blocked-origins <origins>", "semicolon-separated list of origins to block the browser from requesting. Blocklist is evaluated before allowlist. If used without the allowlist, requests not matching the blocklist are still allowed.\nImportant: *does not* serve as a security boundary and *does not* affect redirects.", import_config.semicolonSeparatedList).option("--block-service-workers", "block service workers").option("--browser <browser>", "browser or chrome channel to use, possible values: chrome, firefox, webkit, msedge.").option("--caps <caps>", "comma-separated list of additional capabilities to enable, possible values: vision, pdf.", import_config.commaSeparatedList).option("--cdp-endpoint <endpoint>", "CDP endpoint to connect to.").option("--cdp-header <headers...>", "CDP headers to send with the connect request, multiple can be specified.", import_config.headerParser).option("--config <path>", "path to the configuration file.").option("--console-level <level>", 'level of console messages to return: "error", "warning", "info", "debug". Each level includes the messages of more severe levels.', import_config.enumParser.bind(null, "--console-level", ["error", "warning", "info", "debug"])).option("--device <device>", 'device to emulate, for example: "iPhone 15"').option("--executable-path <path>", "path to the browser executable.").option("--extension", 'Connect to a running browser instance (Edge/Chrome only). Requires the "Playwright MCP Bridge" browser extension to be installed.').option("--grant-permissions <permissions...>", 'List of permissions to grant to the browser context, for example "geolocation", "clipboard-read", "clipboard-write".', import_config.commaSeparatedList).option("--headless", "run browser in headless mode, headed by default").option("--host <host>", "host to bind server to. Default is localhost. Use 0.0.0.0 to bind to all interfaces.").option("--ignore-https-errors", "ignore https errors").option("--init-page <path...>", "path to TypeScript file to evaluate on Playwright page object").option("--init-script <path...>", "path to JavaScript file to add as an initialization script. The script will be evaluated in every page before any of the page's scripts. Can be specified multiple times.").option("--isolated", "keep the browser profile in memory, do not save it to disk.").option("--image-responses <mode>", 'whether to send image responses to the client. Can be "allow" or "omit", Defaults to "allow".', import_config.enumParser.bind(null, "--image-responses", ["allow", "omit"])).option("--no-sandbox", "disable the sandbox for all process types that are normally sandboxed.").option("--output-dir <path>", "path to the directory for output files.").option("--port <port>", "port to listen on for SSE transport.").option("--proxy-bypass <bypass>", 'comma-separated domains to bypass proxy, for example ".com,chromium.org,.domain.com"').option("--proxy-server <proxy>", 'specify proxy server, for example "http://myproxy:3128" or "socks5://myproxy:8080"').option("--save-session", "Whether to save the Playwright MCP session into the output directory.").option("--save-trace", "Whether to save the Playwright Trace of the session into the output directory.").option("--save-video <size>", 'Whether to save the video of the session into the output directory. For example "--save-video=800x600"', import_config.resolutionParser.bind(null, "--save-video")).option("--secrets <path>", "path to a file containing secrets in the dotenv format", import_config.dotenvFileLoader).option("--shared-browser-context", "reuse the same browser context between all connected HTTP clients.").option("--snapshot-mode <mode>", 'when taking snapshots for responses, specifies the mode to use. Can be "incremental", "full", or "none". Default is incremental.').option("--storage-state <path>", "path to the storage state file for isolated sessions.").option("--test-id-attribute <attribute>", 'specify the attribute to use for test ids, defaults to "data-testid"').option("--timeout-action <timeout>", "specify action timeout in milliseconds, defaults to 5000ms", import_config.numberParser).option("--timeout-navigation <timeout>", "specify navigation timeout in milliseconds, defaults to 60000ms", import_config.numberParser).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 "1280x720"', import_config.resolutionParser.bind(null, "--viewport-size")).option("--run-id <id>", "External UUID to use for HAR directory. If not provided, a UUID will be generated.").option("--save-har-path <path>", "path to the directory where HAR files should be saved. HAR files will be saved to {path}/{run-id}/recording.har").addOption(new import_utilsBundle.ProgramOption("--vision", "Legacy option, use --caps=vision instead").hideHelp()).action(async (options) => {
     (0, import_watchdog.setupExitWatchdog)();
     if (options.vision) {
       console.error("The --vision option is deprecated, use --caps=vision instead");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rae-playwright-mcp",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "Rae Playwright MCP - Enhanced Playwright Tools for MCP",
   "mcpName": "com.microsoft/playwright-mcp",
   "repository": {
@@ -51,4 +51,4 @@
     "@playwright/test": "1.58.0-alpha-2025-12-29",
     "@types/node": "^24.3.0"
   }
-}
+}