firefox-devtools-mcp 0.6.1 → 0.7.0

package/README.md

@@ -99,9 +99,21 @@ You can pass flags or environment variables (names on the right):
 - Input: click/hover/fill/drag/upload/form fill
 - Network: list/get (ID‑first, filters, always‑on capture)
 - Console: list/clear
-- Screenshot: page/by uid
+- Screenshot: page/by uid (with optional `saveTo` for CLI environments)
 - Utilities: accept/dismiss dialog, history back/forward, set viewport
 
+### Screenshot optimization for Claude Code
+
+When using screenshots in Claude Code CLI, the base64 image data can consume significant context.
+Use the `saveTo` parameter to save screenshots to disk instead:
+
+```
+screenshot_page({ saveTo: "/tmp/page.png" })
+screenshot_by_uid({ uid: "abc123", saveTo: "/tmp/element.png" })
+```
+
+The file can then be viewed with Claude Code's `Read` tool without impacting context size.
+
 ## Local development
 
 ```bash

package/dist/index.js

@@ -14072,7 +14072,7 @@ var init_protocol = __esm({
               return;
             }
             const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-            await new Promise((resolve3) => setTimeout(resolve3, pollInterval));
+            await new Promise((resolve4) => setTimeout(resolve4, pollInterval));
             options?.signal?.throwIfAborted();
           }
         } catch (error2) {
@@ -14089,7 +14089,7 @@ var init_protocol = __esm({
        */
       request(request, resultSchema, options) {
         const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-        return new Promise((resolve3, reject) => {
+        return new Promise((resolve4, reject) => {
           const earlyReject = (error2) => {
             reject(error2);
           };
@@ -14167,7 +14167,7 @@ var init_protocol = __esm({
               if (!parseResult.success) {
                 reject(parseResult.error);
               } else {
-                resolve3(parseResult.data);
+                resolve4(parseResult.data);
               }
             } catch (error2) {
               reject(error2);
@@ -14428,12 +14428,12 @@ var init_protocol = __esm({
           }
         } catch {
         }
-        return new Promise((resolve3, reject) => {
+        return new Promise((resolve4, reject) => {
           if (signal.aborted) {
             reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
             return;
           }
-          const timeoutId = setTimeout(resolve3, interval);
+          const timeoutId = setTimeout(resolve4, interval);
           signal.addEventListener("abort", () => {
             clearTimeout(timeoutId);
             reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -17460,7 +17460,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve3.call(this, root, ref);
+      let _sch = resolve4.call(this, root, ref);
       if (_sch === void 0) {
         const schema = (_a2 = root.localRefs) === null || _a2 === void 0 ? void 0 : _a2[ref];
         const { schemaId } = this.opts;
@@ -17487,7 +17487,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve3(root, ref) {
+    function resolve4(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -18062,7 +18062,7 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve3(baseURI, relativeURI, options) {
+    function resolve4(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
       const resolved = resolveComponent(parse3(baseURI, schemelessOptions), parse3(relativeURI, schemelessOptions), schemelessOptions, true);
       schemelessOptions.skipEscape = true;
@@ -18289,7 +18289,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize,
-      resolve: resolve3,
+      resolve: resolve4,
       resolveComponent,
       equal,
       serialize,
@@ -21944,12 +21944,12 @@ var init_stdio2 = __esm({
         this.onclose?.();
       }
       send(message) {
-        return new Promise((resolve3) => {
+        return new Promise((resolve4) => {
           const json2 = serializeMessage(message);
           if (this._stdout.write(json2)) {
-            resolve3();
+            resolve4();
           } else {
-            this._stdout.once("drain", resolve3);
+            this._stdout.once("drain", resolve4);
           }
         });
       }
@@ -21963,7 +21963,7 @@ var init_constants = __esm({
   "src/config/constants.ts"() {
     "use strict";
     SERVER_NAME = "firefox-devtools";
-    SERVER_VERSION = "0.2.5";
+    SERVER_VERSION = "0.7.0";
   }
 });
 
@@ -22791,7 +22791,7 @@ var init_dom = __esm({
        */
       async waitForEventsAfterAction() {
         await this.driver.executeScript("return new Promise(r => requestAnimationFrame(() => r()))");
-        await new Promise((resolve3) => setTimeout(resolve3, 50));
+        await new Promise((resolve4) => setTimeout(resolve4, 50));
       }
       // ============================================================================
       // Screenshot
@@ -22820,7 +22820,7 @@ var init_dom = __esm({
           'arguments[0].scrollIntoView({block: "center", inline: "center"});',
           el
         );
-        await new Promise((resolve3) => setTimeout(resolve3, 100));
+        await new Promise((resolve4) => setTimeout(resolve4, 100));
         return await el.takeScreenshot();
       }
     };
@@ -24933,33 +24933,48 @@ var init_input = __esm({
 });
 
 // src/tools/screenshot.ts
-function buildScreenshotResponse(base64Png, label) {
-  const sizeKB = Math.round(base64Png.length / 1024);
-  if (base64Png.length > TOKEN_LIMITS.MAX_SCREENSHOT_CHARS) {
-    const truncatedData = base64Png.slice(0, TOKEN_LIMITS.MAX_SCREENSHOT_CHARS);
-    return successResponse(`\u{1F4F8} ${label} (${sizeKB}KB) [truncated]
-${truncatedData}`);
-  }
-  const warn = base64Png.length > TOKEN_LIMITS.WARNING_THRESHOLD_CHARS ? " [large]" : "";
-  return successResponse(`\u{1F4F8} ${label} (${sizeKB}KB)${warn}
-${base64Png}`);
-}
-async function handleScreenshotPage(_args) {
+import { writeFile, mkdir } from "fs/promises";
+import { resolve as resolve2, dirname as dirname2 } from "path";
+async function saveScreenshot(base64Png, saveTo) {
+  const buffer = Buffer.from(base64Png, "base64");
+  const resolvedPath = resolve2(saveTo);
+  await mkdir(dirname2(resolvedPath), { recursive: true });
+  await writeFile(resolvedPath, buffer);
+  return successResponse(
+    `Screenshot saved to: ${resolvedPath} (${(buffer.length / 1024).toFixed(1)}KB)`
+  );
+}
+function imageResponse(base64Png) {
+  return {
+    content: [
+      {
+        type: "image",
+        data: base64Png,
+        mimeType: "image/png"
+      }
+    ]
+  };
+}
+async function handleScreenshotPage(args2) {
   try {
+    const { saveTo } = args2 ?? {};
     const { getFirefox: getFirefox2 } = await init_index().then(() => index_exports);
     const firefox3 = await getFirefox2();
     const base64Png = await firefox3.takeScreenshotPage();
     if (!base64Png || typeof base64Png !== "string") {
       throw new Error("Invalid screenshot data");
     }
-    return buildScreenshotResponse(base64Png, "page");
+    if (saveTo) {
+      return await saveScreenshot(base64Png, saveTo);
+    }
+    return imageResponse(base64Png);
   } catch (error2) {
     return errorResponse(error2);
   }
 }
 async function handleScreenshotByUid(args2) {
   try {
-    const { uid } = args2;
+    const { uid, saveTo } = args2;
     if (!uid || typeof uid !== "string") {
       throw new Error("uid required");
     }
@@ -24970,7 +24985,10 @@ async function handleScreenshotByUid(args2) {
       if (!base64Png || typeof base64Png !== "string") {
         throw new Error("Invalid screenshot data");
       }
-      return buildScreenshotResponse(base64Png, uid);
+      if (saveTo) {
+        return await saveScreenshot(base64Png, saveTo);
+      }
+      return imageResponse(base64Png);
     } catch (error2) {
       throw handleUidError(error2, uid);
     }
@@ -24978,18 +24996,24 @@ async function handleScreenshotByUid(args2) {
     return errorResponse(error2);
   }
 }
-var screenshotPageTool, screenshotByUidTool;
+var SAVE_TO_SCHEMA, screenshotPageTool, screenshotByUidTool;
 var init_screenshot = __esm({
   "src/tools/screenshot.ts"() {
     "use strict";
     init_response_helpers();
     init_uid_helpers();
+    SAVE_TO_SCHEMA = {
+      type: "string",
+      description: "Optional absolute file path to save the screenshot to instead of returning it as image data in the response. Use this in CLI environments (e.g. Claude Code) to avoid filling up the context window with large base64 image data. Example: '/tmp/screenshot.png'"
+    };
     screenshotPageTool = {
       name: "screenshot_page",
       description: "Capture page screenshot as base64 PNG.",
       inputSchema: {
         type: "object",
-        properties: {}
+        properties: {
+          saveTo: SAVE_TO_SCHEMA
+        }
       }
     };
     screenshotByUidTool = {
@@ -25001,7 +25025,8 @@ var init_screenshot = __esm({
           uid: {
             type: "string",
             description: "Element UID from snapshot"
-          }
+          },
+          saveTo: SAVE_TO_SCHEMA
         },
         required: ["uid"]
       }
@@ -25595,7 +25620,7 @@ __export(index_exports, {
 });
 import { version as version2 } from "process";
 import { fileURLToPath as fileURLToPath2 } from "url";
-import { resolve as resolve2 } from "path";
+import { resolve as resolve3 } from "path";
 import { realpathSync } from "fs";
 function resetFirefox() {
   if (firefox2) {
@@ -25776,7 +25801,7 @@ var init_index = __esm({
       setViewportSizeTool
     ];
     modulePath = fileURLToPath2(import.meta.url);
-    scriptPath = process.argv[1] ? resolve2(process.argv[1]) : "";
+    scriptPath = process.argv[1] ? resolve3(process.argv[1]) : "";
     isMainModule = false;
     try {
       const realModulePath = realpathSync(modulePath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firefox-devtools-mcp",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "Model Context Protocol (MCP) server for Firefox DevTools automation",
   "author": "freema",
   "license": "MIT",