opera-devtools-mcp 0.6.1 → 0.7.0

package/build/src/config/browser-options.js

@@ -0,0 +1,126 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Modified by Opera Software AS.
+ */
+import { CACHE_DIR_NAME, MCP_BIN_NAME, REPO_URL } from '../opera/branding.js';
+export const browserOptions = {
+    autoConnect: {
+        type: 'boolean',
+        description: 'If specified, automatically connects to a browser (Chrome 144+) running locally from the user data directory identified by the channel param (default channel is stable). Requires the remote debugging server to be started in the Chrome instance via chrome://inspect/#remote-debugging.',
+        conflicts: ['isolated', 'executablePath'],
+        default: false,
+        coerce: (value) => {
+            if (!value) {
+                return;
+            }
+            return value;
+        },
+    },
+    browserUrl: {
+        type: 'string',
+        description: `Connect to a running, debuggable Chrome instance (e.g. \`http://127.0.0.1:9222\`). For more details see: ${REPO_URL}#connecting-to-a-running-chrome-instance.`,
+        alias: 'u',
+        conflicts: ['wsEndpoint'],
+        coerce: (url) => {
+            if (!url) {
+                return;
+            }
+            try {
+                new URL(url);
+            }
+            catch {
+                throw new Error(`Provided browserUrl ${url} is not valid URL.`);
+            }
+            return url;
+        },
+    },
+    wsEndpoint: {
+        type: 'string',
+        description: 'WebSocket endpoint to connect to a running Chrome instance (e.g., ws://127.0.0.1:9222/devtools/browser/<id>). Alternative to --browserUrl.',
+        alias: 'w',
+        conflicts: ['browserUrl'],
+        coerce: (url) => {
+            if (!url) {
+                return;
+            }
+            try {
+                const parsed = new URL(url);
+                if (parsed.protocol !== 'ws:' && parsed.protocol !== 'wss:') {
+                    throw new Error(`Provided wsEndpoint ${url} must use ws:// or wss:// protocol.`);
+                }
+                return url;
+            }
+            catch (error) {
+                if (error.message.includes('ws://')) {
+                    throw error;
+                }
+                throw new Error(`Provided wsEndpoint ${url} is not valid URL.`);
+            }
+        },
+    },
+    wsHeaders: {
+        type: 'string',
+        description: 'Custom headers for WebSocket connection in JSON format (e.g., \'{"Authorization":"Bearer token"}\'). Only works with --wsEndpoint.',
+        implies: 'wsEndpoint',
+        coerce: (val) => {
+            if (!val) {
+                return;
+            }
+            try {
+                const parsed = JSON.parse(val);
+                if (typeof parsed !== 'object' || Array.isArray(parsed)) {
+                    throw new Error('Headers must be a JSON object');
+                }
+                return parsed;
+            }
+            catch (error) {
+                throw new Error(`Invalid JSON for wsHeaders: ${error.message}`);
+            }
+        },
+    },
+    headless: {
+        type: 'boolean',
+        description: 'Whether to run in headless (no UI) mode.',
+        default: false,
+    },
+    executablePath: {
+        type: 'string',
+        description: 'Path to custom Chrome executable.',
+        conflicts: ['browserUrl', 'wsEndpoint'],
+        alias: 'e',
+    },
+    isolated: {
+        type: 'boolean',
+        description: 'If specified, creates a temporary user-data-dir that is automatically cleaned up after the browser is closed. Defaults to false.',
+    },
+    userDataDir: {
+        type: 'string',
+        description: `Path to the user data directory for Chrome. Default is $HOME/.cache/${CACHE_DIR_NAME}/chrome-profile$CHANNEL_SUFFIX_IF_NON_STABLE`,
+        conflicts: ['browserUrl', 'wsEndpoint', 'isolated'],
+    },
+    channel: {
+        type: 'string',
+        description: 'Specify a different Chrome channel that should be used. The default is the stable channel version.',
+        choices: ['canary', 'dev', 'beta', 'stable'],
+        conflicts: ['browserUrl', 'wsEndpoint', 'executablePath'],
+    },
+    proxyServer: {
+        type: 'string',
+        description: `Proxy server configuration for Chrome passed as --proxy-server when launching the browser. See https://www.chromium.org/developers/design-documents/network-settings/ for details.`,
+    },
+    chromeArg: {
+        type: 'array',
+        describe: `Additional arguments for Chrome. Only applies when Chrome is launched by ${MCP_BIN_NAME}.`,
+    },
+    ignoreDefaultChromeArg: {
+        type: 'array',
+        describe: `Explicitly disable default arguments for Chrome. Only applies when Chrome is launched by ${MCP_BIN_NAME}.`,
+    },
+};
+export function getBrowserOptions() {
+    return browserOptions;
+}
+//# sourceMappingURL=browser-options.js.map

package/build/src/config/category-options.js

@@ -0,0 +1,81 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ToolCategory } from '../tools/categories.js';
+const categoryOverrides = {
+    [ToolCategory.INPUT]: {},
+    [ToolCategory.NAVIGATION]: {},
+    [ToolCategory.EMULATION]: {
+        hidden: false,
+    },
+    [ToolCategory.PERFORMANCE]: {
+        hidden: false,
+    },
+    [ToolCategory.NETWORK]: {
+        hidden: false,
+    },
+    [ToolCategory.DEBUGGING]: {},
+    [ToolCategory.MEMORY]: {},
+    [ToolCategory.WEBMCP]: {
+        describe: 'Set to true to enable debugging WebMCP tools. Requires Chrome 150+ with the following flag: `--enable-features=WebMCP`',
+        offByDefault: true,
+    },
+    [ToolCategory.EXTENSIONS]: {
+        describe: 'Set to true to include tools related to extensions. Note: This feature is currently only supported with a pipe connection. autoConnect, browserUrl, and wsEndpoint are not supported with this feature until 149 will be released.',
+        hidden: false,
+        offByDefault: true,
+    },
+    [ToolCategory.THIRD_PARTY]: {
+        describe: 'Set to true to enable third-party developer tools exposed by the inspected page itself',
+        hidden: false,
+        offByDefault: true,
+    },
+    [ToolCategory.PWA]: {
+        describe: 'Set to true to include tools for automating Progressive Web Apps (install, launch, uninstall, and OS state). This feature is only supported with a pipe connection; autoConnect, browserUrl, and wsEndpoint are not supported.',
+        conflicts: ['autoConnect', 'browserUrl', 'wsEndpoint'],
+        hidden: false,
+        offByDefault: true,
+    },
+    [ToolCategory.OPERA]: {},
+};
+function createOption(category) {
+    const overrides = categoryOverrides[category];
+    const describe = overrides.offByDefault
+        ? `Set to true to include tools related to ${category}.`
+        : `Set to false to exclude tools related to ${category}.`;
+    return {
+        type: 'boolean',
+        describe,
+        hidden: true,
+        ...overrides,
+        ...(overrides.offByDefault ? {} : { default: true }),
+    };
+}
+export function categoryToFlagName(category) {
+    return `category${category.charAt(0).toUpperCase()}${category.slice(1)}`;
+}
+export function getCategoryOptions() {
+    const options = {};
+    for (const category of Object.values(ToolCategory)) {
+        const flagName = categoryToFlagName(category);
+        options[flagName] = createOption(category);
+    }
+    return options;
+}
+export function isCategoryOffByDefault(category) {
+    const flagName = categoryToFlagName(category);
+    const option = getCategoryOptions()[flagName];
+    return !('default' in option) || option.default !== true;
+}
+export function getOffByDefaultCategories() {
+    const result = [];
+    for (const category of Object.values(ToolCategory)) {
+        if (isCategoryOffByDefault(category)) {
+            result.push(category);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=category-options.js.map