firefox-css-theme-mcp 0.1.2 → 0.1.4

package/README.md

@@ -15,13 +15,13 @@ Model Context Protocol (MCP) server for inspecting, querying, and live-debugging
 #### Claude Code
 
 ```bash
-claude mcp add firefox-css-theme -- npx -y firefox-css-theme-mcp
+claude mcp add firefox-css-theme -- npx -y firefox-css-theme-mcp --nova-ui
 ```
 
 #### Codex
 
 ```bash
-codex mcp add firefox-css-theme -- npx -y firefox-css-theme-mcp
+codex mcp add firefox-css-theme -- npx -y firefox-css-theme-mcp --nova-ui
 ```
 
 ### Option B — IDE Configuration
@@ -33,7 +33,7 @@ Add the server configuration to your MCP settings file:
 	"mcpServers": {
 		"firefox-css-theme": {
 			"command": "npx",
-			"args": ["-y", "firefox-css-theme-mcp"]
+			"args": ["-y", "firefox-css-theme-mcp", "--nova-ui"]
 		}
 	}
 }
@@ -57,12 +57,21 @@ npm run build
 	"mcpServers": {
 		"firefox-css-theme": {
 			"command": "node",
-			"args": ["/path/to/Firefox-CSS-Theme-MCP/dist/index.js"]
+			"args": [
+				"/path/to/Firefox-CSS-Theme-MCP/dist/index.js",
+				"--nova-ui"
+			]
 		}
 	}
 }
 ```
 
+## Command-line Flags
+
+| Flag        | Type      | Description                                                                                                                      |
+| :---------- | :-------- | :------------------------------------------------------------------------------------------------------------------------------- |
+| `--nova-ui` | `boolean` | Enables the Firefox Nova UI redesign preferences (`browser.nova.enabled` and `browser.newtabpage.activity-stream.nova.enabled`). |
+
 ## Available MCP Tools
 
 - `launch_browser`: Launches Firefox with chrome debugging capabilities enabled.

package/dist/firefox.js

@@ -5,20 +5,40 @@ export class FirefoxBrowserManager {
     async initialiseBrowser(binaryPath, profileDirectory) {
         if (this.driverInstance)
             return;
+        const isNovaUiEnabled = process.argv.includes("--nova-ui");
         const firefoxOptions = new firefox.Options();
-        firefoxOptions.addArguments("-remote-allow-system-access");
+        firefoxOptions.addArguments("-no-remote", "-new-instance");
         firefoxOptions.setPreference("devtools.chrome.enabled", true);
         firefoxOptions.setPreference("devtools.debugger.remote-enabled", true);
+        firefoxOptions.setPreference("devtools.debugger.prompt-connection", false);
         firefoxOptions.setPreference("toolkit.legacyUserProfileCustomizations.stylesheets", true);
+        firefoxOptions.setPreference("marionette.allow-system-access", true);
+        firefoxOptions.setPreference("remote.allow-system-access", true);
+        firefoxOptions.setPreference("browser.nova.enabled", isNovaUiEnabled);
+        firefoxOptions.setPreference("browser.newtabpage.activity-stream.nova.enabled", isNovaUiEnabled);
         if (binaryPath)
             firefoxOptions.setBinary(binaryPath);
         if (profileDirectory)
             firefoxOptions.setProfile(profileDirectory);
-        this.driverInstance = await new Builder()
-            .forBrowser("firefox")
-            .setFirefoxOptions(firefoxOptions)
-            .build();
-        await this.ensureChromeContext();
+        const firefoxService = new firefox.ServiceBuilder()
+            .enableVerboseLogging(true)
+            .addArguments("--allow-system-access");
+        try {
+            this.driverInstance = await new Builder()
+                .forBrowser("firefox")
+                .setFirefoxOptions(firefoxOptions)
+                .setFirefoxService(firefoxService)
+                .build();
+            await this.ensureChromeContext();
+            await this.openBrowserToolbox().catch(() => { });
+        }
+        catch (error) {
+            if (this.driverInstance) {
+                await this.driverInstance.quit().catch(() => { });
+                this.driverInstance = null;
+            }
+            throw error;
+        }
     }
     async terminateBrowser() {
         if (!this.driverInstance)
@@ -151,5 +171,18 @@ export class FirefoxBrowserManager {
         const fullWindowScreenshotBase64 = await this.driverInstance.takeScreenshot();
         return { base64Image: fullWindowScreenshotBase64, format: "png" };
     }
+    async openBrowserToolbox() {
+        await this.ensureChromeContext();
+        return await this.executeChromeScript(() => {
+            try {
+                const { BrowserToolboxLauncher } = ChromeUtils.importESModule("resource://devtools/client/framework/browser-toolbox/Launcher.sys.mjs");
+                BrowserToolboxLauncher.init();
+                return { success: true };
+            }
+            catch {
+                return { success: false };
+            }
+        });
+    }
 }
 export const globalFirefoxManager = new FirefoxBrowserManager();

package/dist/index.js

@@ -5,7 +5,7 @@ import { z } from "zod";
 import { globalFirefoxManager } from "./firefox.js";
 const serverInstance = new McpServer({
     name: "firefox-css-theme-mcp",
-    version: "0.1.0",
+    version: "0.1.4",
 });
 serverInstance.registerTool("launch_browser", {
     description: "Launch a Firefox instance with chrome debugging capabilities enabled.",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "firefox-css-theme-mcp",
-	"version": "0.1.2",
+	"version": "0.1.4",
 	"description": "Model Context Protocol server for inspecting and live-debugging Firefox UI DOM and CSS themes.",
 	"homepage": "https://github.com/easonwong-de/Firefox-CSS-Theme-MCP#readme",
 	"bugs": {