@mozilla/firefox-devtools-mcp 0.9.9 → 0.9.12

package/dist/index.js

@@ -39,8 +39,19 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/cli.ts
+import { createHash } from "crypto";
+import { homedir } from "os";
+import { join } from "path";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
+function defaultProfileDir(firefoxPath) {
+  const base = join(homedir(), ".firefox-devtools-mcp");
+  if (!firefoxPath) {
+    return join(base, "profile");
+  }
+  const hash2 = createHash("sha1").update(firefoxPath).digest("hex").slice(0, 8);
+  return join(base, `profile-${hash2}`);
+}
 function parsePrefs(prefs) {
   const result = {};
   if (!prefs || prefs.length === 0) {
@@ -122,6 +133,11 @@ var init_cli = __esm({
         type: "string",
         description: "Path to Firefox profile directory (optional, for persistent profile)"
       },
+      autoProfile: {
+        type: "boolean",
+        description: "Automatically use a persistent profile stored in ~/.firefox-devtools-mcp/. When --firefox-path is set, the profile is scoped to that binary so different Firefox builds stay isolated.",
+        default: (process.env.AUTO_PROFILE ?? "false") === "true"
+      },
       firefoxArg: {
         type: "array",
         description: "Additional arguments for Firefox. Only applies when Firefox is launched by firefox-devtools-mcp."
@@ -28076,8 +28092,8 @@ var SERVER_NAME, SERVER_VERSION;
 var init_constants = __esm({
   "src/config/constants.ts"() {
     "use strict";
-    SERVER_NAME = "firefox-devtools";
-    SERVER_VERSION = "0.7.1";
+    SERVER_NAME = true ? "@mozilla/firefox-devtools-mcp" : "firefox-devtools";
+    SERVER_VERSION = true ? "0.9.12" : "dev";
   }
 });
 
@@ -28157,12 +28173,12 @@ var init_logger = __esm({
 
 // src/firefox/profile.ts
 import { existsSync, mkdirSync, copyFileSync } from "fs";
-import { join } from "path";
+import { join as join2 } from "path";
 function isFirefoxProfile(dir) {
-  return FIREFOX_PROFILE_INDICATORS.some((file2) => existsSync(join(dir, file2)));
+  return FIREFOX_PROFILE_INDICATORS.some((file2) => existsSync(join2(dir, file2)));
 }
 function resolveProfilePath(parentPath) {
-  const mcpProfilePath = join(parentPath, MCP_PROFILE_DIR_NAME);
+  const mcpProfilePath = join2(parentPath, MCP_PROFILE_DIR_NAME);
   let warning = null;
   if (isFirefoxProfile(parentPath)) {
     warning = `Warning: The path "${parentPath}" looks like an existing Firefox profile.
@@ -28177,9 +28193,9 @@ function resolveProfilePath(parentPath) {
   if (isNew) {
     mkdirSync(mcpProfilePath, { recursive: true });
     log(`Created MCP profile directory: ${mcpProfilePath}`);
-    const parentPrefs = join(parentPath, "prefs.js");
+    const parentPrefs = join2(parentPath, "prefs.js");
     if (existsSync(parentPrefs)) {
-      copyFileSync(parentPrefs, join(mcpProfilePath, "prefs.js"));
+      copyFileSync(parentPrefs, join2(mcpProfilePath, "prefs.js"));
       log(`   Copied prefs.js from parent profile for initial preferences.`);
     }
   }
@@ -28199,14 +28215,14 @@ var init_profile = __esm({
 import { Builder, Browser, Capabilities } from "selenium-webdriver";
 import firefox from "selenium-webdriver/firefox.js";
 import { mkdirSync as mkdirSync2, openSync, closeSync, existsSync as existsSync2, readdirSync, statSync } from "fs";
-import { homedir } from "os";
-import { join as join2, delimiter } from "path";
+import { homedir as homedir2 } from "os";
+import { join as join3, delimiter } from "path";
 function findGeckodriverInPath(binaryName) {
   for (const dir of (process.env.PATH ?? "").split(delimiter)) {
     if (!dir) {
       continue;
     }
-    const candidate = join2(dir, binaryName);
+    const candidate = join3(dir, binaryName);
     if (existsSync2(candidate)) {
       return candidate;
     }
@@ -28214,18 +28230,18 @@ function findGeckodriverInPath(binaryName) {
   return null;
 }
 function findGeckodriverInSeleniumCache(binaryName) {
-  const cacheBase = join2(homedir(), ".cache/selenium/geckodriver");
+  const cacheBase = join3(homedir2(), ".cache/selenium/geckodriver");
   try {
     if (!existsSync2(cacheBase)) {
       return null;
     }
     for (const platformDir of readdirSync(cacheBase)) {
-      const platformPath = join2(cacheBase, platformDir);
+      const platformPath = join3(cacheBase, platformDir);
       if (!statSync(platformPath).isDirectory()) {
         continue;
       }
       for (const versionDir of readdirSync(platformPath).sort().reverse()) {
-        const candidate = join2(platformPath, versionDir, binaryName);
+        const candidate = join3(platformPath, versionDir, binaryName);
         if (existsSync2(candidate)) {
           return candidate;
         }
@@ -28315,10 +28331,10 @@ var init_core3 = __esm({
           if (this.options.logFile) {
             this.logFilePath = this.options.logFile;
           } else if (this.options.env && Object.keys(this.options.env).length > 0) {
-            const outputDir = join2(homedir(), ".firefox-devtools-mcp", "output");
+            const outputDir = join3(homedir2(), ".firefox-devtools-mcp", "output");
             mkdirSync2(outputDir, { recursive: true });
             const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-            this.logFilePath = join2(outputDir, `firefox-${timestamp}.log`);
+            this.logFilePath = join3(outputDir, `firefox-${timestamp}.log`);
           }
           if (this.options.env) {
             for (const [key, value] of Object.entries(this.options.env)) {
@@ -33419,7 +33435,7 @@ async function getFirefox() {
     options = {
       firefoxPath: args.firefoxPath ?? void 0,
       headless: args.headless,
-      profilePath: args.profilePath ?? void 0,
+      profilePath: args.profilePath ?? (args.autoProfile ? defaultProfileDir(args.firefoxPath) : void 0),
       viewport: args.viewport ?? void 0,
       args: args.firefoxArg ?? void 0,
       startUrl: args.startUrl ?? void 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mozilla/firefox-devtools-mcp",
-  "version": "0.9.9",
+  "version": "0.9.12",
   "description": "Model Context Protocol (MCP) server for Firefox DevTools automation",
   "author": "Mozilla",
   "license": "MIT OR Apache-2.0",
@@ -15,6 +15,7 @@
     "build": "tsup",
     "build:moz": "node scripts/generate-moz-package.mjs && tsup --config tsup.config.moz.ts",
     "build:all": "npm run build && npm run build:moz",
+    "build:mcpb": "node scripts/build-mcpb.mjs",
     "publish:moz": "node scripts/publish-moz-package.mjs",
     "start": "node dist/index.js",
     "setup": "node scripts/setup-mcp-config.js",
@@ -75,6 +76,7 @@
     "yargs": "17.7.2"
   },
   "devDependencies": {
+    "@anthropic-ai/mcpb": "2.1.2",
     "@types/jsdom": "28.0.0",
     "@types/node": "24.1.0",
     "@types/selenium-webdriver": "4.35.1",

package/scripts/build-mcpb.mjs

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+/**
+ * Builds the firefox-devtools-mcp .mcpb bundle (Claude Desktop extension).
+ * Assembles a staging directory with dist/, production node_modules and
+ * manifest.json, then runs `mcpb pack` on it.
+ */
+
+import { readFileSync, writeFileSync, existsSync, cpSync, mkdtempSync, rmSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { tmpdir } from 'node:os';
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const pkg = JSON.parse(readFileSync(resolve(root, 'package.json'), 'utf8'));
+const manifest = JSON.parse(readFileSync(resolve(root, 'manifest.json'), 'utf8'));
+
+console.log('Building server...');
+execSync('npm run build', { cwd: root, stdio: 'inherit' });
+
+const stagingDir = mkdtempSync(resolve(tmpdir(), 'firefox-devtools-mcpb-'));
+
+try {
+  cpSync(resolve(root, 'dist'), resolve(stagingDir, 'dist'), { recursive: true });
+  for (const file of ['README.md', 'LICENSE-MIT', 'LICENSE-APACHE', 'package.json', 'package-lock.json']) {
+    cpSync(resolve(root, file), resolve(stagingDir, file));
+  }
+
+  console.log('Installing production dependencies...');
+  execSync('npm ci --omit=dev', { cwd: stagingDir, stdio: 'inherit' });
+
+  writeFileSync(
+    resolve(stagingDir, 'manifest.json'),
+    JSON.stringify({ ...manifest, version: pkg.version }, null, 2) + '\n'
+  );
+
+  const outDir = resolve(root, 'dist-mcpb');
+  if (!existsSync(outDir)) {
+    execSync(`mkdir -p ${outDir}`);
+  }
+  const outFile = resolve(outDir, `firefox-devtools-mcp-${pkg.version}.mcpb`);
+
+  console.log('Packing .mcpb bundle...');
+  execSync(`npx mcpb pack "${stagingDir}" "${outFile}"`, {
+    cwd: root,
+    stdio: 'inherit',
+  });
+
+  console.log(`Written ${outFile}`);
+} finally {
+  rmSync(stagingDir, { recursive: true, force: true });
+}