browser-devtools-mcp 0.0.1

package/dist/logger.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enable = enable;
+exports.disable = disable;
+exports.isDebugEnabled = isDebugEnabled;
+exports.setDebugEnabled = setDebugEnabled;
+exports.debug = debug;
+exports.info = info;
+exports.warn = warn;
+exports.error = error;
+exports.toJson = toJson;
+const BANNER_TEXT = '[BROWSER-DEVTOOLS]';
+let enabled = true;
+let debugEnabled = process.env.DEBUG_ENABLE === 'true';
+function _timeAsString() {
+    const date = new Date();
+    return `${date.toLocaleTimeString(undefined, {
+        hour: 'numeric',
+        minute: 'numeric',
+        second: 'numeric',
+        hour12: false,
+        timeZoneName: 'short',
+    })}`;
+}
+function _normalizeArgs(...args) {
+    if (isDebugEnabled()) {
+        return args;
+    }
+    else {
+        return (args || []).map((arg) => {
+            if (!arg) {
+                return '';
+            }
+            if (arg instanceof Error ||
+                (arg.name && arg.message && arg.stack)) {
+                return `${arg.name}: ${arg.message}`;
+            }
+            else {
+                return arg;
+            }
+        });
+    }
+}
+function enable() {
+    enabled = true;
+}
+function disable() {
+    enabled = false;
+}
+function isDebugEnabled() {
+    return debugEnabled;
+}
+function setDebugEnabled(enabled) {
+    debugEnabled = enabled;
+}
+function debug(...args) {
+    if (!enabled) {
+        return;
+    }
+    if (isDebugEnabled()) {
+        console.debug(BANNER_TEXT, _timeAsString(), '|', 'DEBUG', '-', ..._normalizeArgs(...args));
+    }
+}
+function info(...args) {
+    if (!enabled) {
+        return;
+    }
+    console.info(BANNER_TEXT, _timeAsString(), '|', 'INFO ', '-', ..._normalizeArgs(...args));
+}
+function warn(...args) {
+    if (!enabled) {
+        return;
+    }
+    console.warn(BANNER_TEXT, _timeAsString(), '|', 'WARN ', '-', ..._normalizeArgs(...args));
+}
+function error(...args) {
+    if (!enabled) {
+        return;
+    }
+    console.error(BANNER_TEXT, _timeAsString(), '|', 'ERROR', '-', ..._normalizeArgs(...args));
+}
+function _getCircularReplacer() {
+    const seen = new WeakSet();
+    return (key, value) => {
+        if (typeof value === 'object' && value !== null) {
+            if (seen.has(value)) {
+                return;
+            }
+            seen.add(value);
+        }
+        return value;
+    };
+}
+function toJson(obj) {
+    return JSON.stringify(obj, _getCircularReplacer());
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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"}

package/dist/server-info.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SERVER_VERSION = exports.SERVER_NAME = void 0;
+exports.getServerInstructions = getServerInstructions;
+exports.SERVER_NAME = 'browser-devtools-mcp';
+exports.SERVER_VERSION = require('../package.json').version;
+const SERVER_INSTRUCTIONS = `
+This MCP server exposes a Playwright-powered browser runtime to AI agents, enabling deep, bidirectional debugging and interaction with live web pages.
+
+It supports both visual understanding and code-level inspection of browser state, similar to existing Playwright and Chrome DevTools–based MCP servers, with a focus on AI-driven exploration, diagnosis, and action.
+
+Core capabilities include:
+
+- Visual inspection of pages, layout, geometry, visibility, and styles
+- DOM and code-level debugging, including attributes, computed styles, and accessibility data
+- Correlation between rendered visuals and underlying DOM structure
+- JavaScript evaluation in page context
+- Browser control and automation (navigation, input, scrolling, viewport control)
+- Long-lived, session-based debugging backed by real Playwright browser instances
+- Streamable responses and server-initiated notifications for interactive analysis
+- Clean lifecycle management and teardown on connection close
+
+This server is designed for AI coding assistants, visual debugging agents, and automated analysis tools that need to reason about what a page looks like, how it is structured, and how it behaves — all through a single MCP interface.
+
+It treats the browser as a queryable, inspectable, and controllable execution environment rather than a static screenshot source.
+`;
+function getServerInstructions() {
+    const parts = [];
+    parts.push(SERVER_INSTRUCTIONS);
+    const result = parts.join('\n\n');
+    return result.trim();
+}
+//# sourceMappingURL=server-info.js.map

package/dist/server-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-info.js","sourceRoot":"","sources":["../src/server-info.ts"],"names":[],"mappings":";;;AAwBA,sDAOC;AA/BY,QAAA,WAAW,GAAG,sBAAsB,CAAC;AAC1B,sBAAc,GAAK,OAAO,CAAC,iBAAiB,CAAC,SAAC;AAEtE,MAAM,mBAAmB,GAAW;;;;;;;;;;;;;;;;;;;CAmBnC,CAAC;AAEF,SAAgB,qBAAqB;IACjC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAEhC,MAAM,MAAM,GAAW,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC"}

package/dist/server.js

@@ -0,0 +1,131 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createServer = createServer;
+exports.createSession = createSession;
+const browser_1 = require("./browser");
+const context_1 = require("./context");
+const logger = __importStar(require("./logger"));
+const server_info_1 = require("./server-info");
+const tools_1 = require("./tools");
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+async function _createSessionContext(sessionIdProvider) {
+    const browser = await (0, browser_1.getBrowser)();
+    const browserContext = await (0, browser_1.newBrowserContext)(browser);
+    const page = await (0, browser_1.newPage)(browserContext);
+    return new context_1.McpSessionContext(sessionIdProvider, browser, browserContext, page);
+}
+async function createServer(opts) {
+    const server = new mcp_js_1.McpServer({
+        name: server_info_1.SERVER_NAME,
+        version: server_info_1.SERVER_VERSION,
+    }, {
+        capabilities: {
+            resources: {},
+            tools: {},
+        },
+        instructions: (0, server_info_1.getServerInstructions)(),
+    });
+    const messages = [];
+    // TODO Add policies as prompts here
+    /*
+    messages.push({
+        role: 'user',
+        content: {
+            type: 'text',
+            text: <POLICY>,
+        },
+    });
+    */
+    server.registerPrompt('default_system', {
+        title: 'Default System Prompt',
+        description: 'General behavior for the AI assistant',
+    }, async () => ({
+        description: "Defines the assistant's general reasoning and tool usage rules.",
+        messages,
+    }));
+    const toolExecutor = new tools_1.ToolExecutor(opts.context);
+    const createToolCallback = (tool) => {
+        return async (args) => {
+            try {
+                const response = await toolExecutor.executeTool(tool, args);
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify(response, null, 2),
+                        },
+                    ],
+                    structuredContent: response,
+                    isError: false,
+                };
+            }
+            catch (error) {
+                return {
+                    content: [
+                        { type: 'text', text: `Error: ${error.message}` },
+                    ],
+                    isError: true,
+                };
+            }
+        };
+    };
+    tools_1.tools.forEach((t) => {
+        logger.debug(`Registering tool ${t.name()} ...`);
+        server.registerTool(t.name(), {
+            description: t.description(),
+            inputSchema: t.inputSchema(),
+            outputSchema: t.outputSchema(),
+        }, createToolCallback(t));
+    });
+    return server;
+}
+async function createSession(config, transport) {
+    const sessionContext = await _createSessionContext(() => transport.sessionId);
+    const server = await createServer({
+        config,
+        context: sessionContext,
+    });
+    await server.connect(transport);
+    return {
+        transport,
+        server,
+        context: sessionContext,
+        initialized: false,
+        closed: false,
+        lastActiveAt: Date.now(),
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools/content/get-as-html.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetAsHtml = void 0;
+const zod_1 = require("zod");
+const DEFAULT_MAX_HTML_LENGTH = 50_000;
+class GetAsHtml {
+    name() {
+        return 'content_get-as-html';
+    }
+    description() {
+        return `
+Gets the HTML content of the current page. 
+By default, all <script> tags are removed from the output unless "removeScripts" is explicitly set to "false".
+        `;
+    }
+    inputSchema() {
+        return {
+            selector: zod_1.z
+                .string()
+                .describe('CSS selector to limit the HTML content to a specific container.')
+                .optional(),
+            removeScripts: zod_1.z
+                .boolean()
+                .describe('Remove all script tags from the HTML (default: "true").')
+                .optional()
+                .default(true),
+            removeComments: zod_1.z
+                .boolean()
+                .describe('Remove all HTML comments (default: "false").')
+                .optional()
+                .default(false),
+            removeStyles: zod_1.z
+                .boolean()
+                .describe('Remove all style tags from the HTML (default: "false").')
+                .optional()
+                .default(false),
+            removeMeta: zod_1.z
+                .boolean()
+                .describe('Remove all meta tags from the HTML (default: "false").')
+                .optional()
+                .default(false),
+            cleanHtml: zod_1.z
+                .boolean()
+                .describe('Perform comprehensive HTML cleaning (default: "false").')
+                .optional()
+                .default(false),
+            minify: zod_1.z
+                .boolean()
+                .describe('Minify the HTML output (default: "false").')
+                .optional()
+                .default(false),
+            maxLength: zod_1.z
+                .number()
+                .int()
+                .positive()
+                .describe(`Maximum number of characters to return (default: "${DEFAULT_MAX_HTML_LENGTH}").`)
+                .optional()
+                .default(DEFAULT_MAX_HTML_LENGTH),
+        };
+    }
+    outputSchema() {
+        return {
+            output: zod_1.z
+                .string()
+                .describe('The requested HTML content of the page.'),
+        };
+    }
+    async handle(context, args) {
+        const { selector, removeScripts, removeComments, removeStyles, removeMeta, minify, cleanHtml, maxLength, } = args;
+        // Get the HTML content
+        let htmlContent;
+        if (selector) {
+            // If a selector is provided, get only the HTML for that element
+            const element = await context.page.$(selector);
+            if (!element) {
+                throw new Error(`Element with selector "${selector}" not found`);
+            }
+            htmlContent = await element.evaluate((el) => el.outerHTML);
+        }
+        else {
+            // Otherwise get the full page HTML
+            htmlContent = await context.page.content();
+        }
+        // Determine if we need to apply filters
+        const shouldRemoveScripts = removeScripts || cleanHtml;
+        const shouldRemoveComments = removeComments || cleanHtml;
+        const shouldRemoveStyles = removeStyles || cleanHtml;
+        const shouldRemoveMeta = removeMeta || cleanHtml;
+        // Apply filters in the browser context
+        if (shouldRemoveScripts ||
+            shouldRemoveComments ||
+            shouldRemoveStyles ||
+            shouldRemoveMeta ||
+            minify) {
+            htmlContent = await context.page.evaluate(({ html, removeScripts, removeComments, removeStyles, removeMeta, minify, }) => {
+                // Parse as a fragment (no <html>/<body> wrapper will be added)
+                const template = document.createElement('template');
+                template.innerHTML = html;
+                // Work on the fragment
+                const root = template.content;
+                // Remove script tags if requested
+                if (removeScripts) {
+                    const scripts = root.querySelectorAll('script');
+                    scripts.forEach((script) => script.remove());
+                }
+                // Remove style tags if requested
+                if (removeStyles) {
+                    const styles = root.querySelectorAll('style');
+                    styles.forEach((style) => style.remove());
+                }
+                // Remove meta tags if requested
+                if (removeMeta) {
+                    const metaTags = root.querySelectorAll('meta');
+                    metaTags.forEach((meta) => meta.remove());
+                }
+                // Remove HTML comments if requested
+                if (removeComments) {
+                    const removeComments = (node) => {
+                        const childNodes = node.childNodes;
+                        for (let i = childNodes.length - 1; i >= 0; i--) {
+                            const child = childNodes[i];
+                            if (child.nodeType === 8) {
+                                // 8 is for comment nodes
+                                node.removeChild(child);
+                            }
+                            else if (child.nodeType === 1) {
+                                // 1 is for element nodes
+                                removeComments(child);
+                            }
+                        }
+                    };
+                    removeComments(root);
+                }
+                // Get the processed HTML (fragment output, no <html>/<body>)
+                let result = template.innerHTML;
+                // Minify if requested
+                if (minify) {
+                    // Simple minification: remove extra whitespace
+                    result = result.replace(/>\s+</g, '><').trim();
+                }
+                return result;
+            }, {
+                html: htmlContent,
+                removeScripts: shouldRemoveScripts,
+                removeComments: shouldRemoveComments,
+                removeStyles: shouldRemoveStyles,
+                removeMeta: shouldRemoveMeta,
+                minify,
+            });
+        }
+        // Truncate logic
+        let output = htmlContent;
+        if (output.length > maxLength) {
+            output =
+                output.slice(0, maxLength) +
+                    '\n<!-- Output truncated due to size limits -->';
+        }
+        return {
+            output,
+        };
+    }
+}
+exports.GetAsHtml = GetAsHtml;
+//# sourceMappingURL=get-as-html.js.map

package/dist/tools/content/get-as-html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-as-html.js","sourceRoot":"","sources":["../../../src/tools/content/get-as-html.ts"],"names":[],"mappings":"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"}

package/dist/tools/content/get-as-text.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetAsText = void 0;
+const zod_1 = require("zod");
+const DEFAULT_MAX_TEXT_LENGTH = 50_000;
+class GetAsText {
+    name() {
+        return 'content_get-as-text';
+    }
+    description() {
+        return 'Gets the visible text content of the current page.';
+    }
+    inputSchema() {
+        return {
+            selector: zod_1.z
+                .string()
+                .describe('CSS selector to limit the text content to a specific container.')
+                .optional(),
+            maxLength: zod_1.z
+                .number()
+                .int()
+                .positive()
+                .describe(`Maximum number of characters to return (default: "${DEFAULT_MAX_TEXT_LENGTH}").`)
+                .optional()
+                .default(DEFAULT_MAX_TEXT_LENGTH),
+        };
+    }
+    outputSchema() {
+        return {
+            output: zod_1.z
+                .string()
+                .describe('The requested text content of the page.'),
+        };
+    }
+    async handle(context, args) {
+        const { selector, maxLength } = args;
+        const visibleText = await context.page.evaluate(({ selector }) => {
+            const root = selector
+                ? document.querySelector(selector)
+                : document.body;
+            if (!root) {
+                throw new Error(`Element with selector "${selector}" not found`);
+            }
+            const walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT, {
+                acceptNode: (node) => {
+                    const style = window.getComputedStyle(node.parentElement);
+                    return style.display !== 'none' &&
+                        style.visibility !== 'hidden'
+                        ? NodeFilter.FILTER_ACCEPT
+                        : NodeFilter.FILTER_REJECT;
+                },
+            });
+            let text = '';
+            let node;
+            while ((node = walker.nextNode())) {
+                const trimmedText = node.textContent?.trim();
+                if (trimmedText) {
+                    text += trimmedText + '\n';
+                }
+            }
+            return text.trim();
+        }, { selector });
+        // Truncate logic
+        let output = visibleText;
+        if (output.length > maxLength) {
+            output =
+                output.slice(0, maxLength) +
+                    '\n[Output truncated due to size limits]';
+        }
+        return {
+            output,
+        };
+    }
+}
+exports.GetAsText = GetAsText;
+//# sourceMappingURL=get-as-text.js.map

package/dist/tools/content/get-as-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-as-text.js","sourceRoot":"","sources":["../../../src/tools/content/get-as-text.ts"],"names":[],"mappings":";;;AASA,6BAAwB;AAExB,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAWvC,MAAa,SAAS;IAClB,IAAI;QACA,OAAO,qBAAqB,CAAC;IACjC,CAAC;IAED,WAAW;QACP,OAAO,oDAAoD,CAAC;IAChE,CAAC;IAED,WAAW;QACP,OAAO;YACH,QAAQ,EAAE,OAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,CACL,iEAAiE,CACpE;iBACA,QAAQ,EAAE;YACf,SAAS,EAAE,OAAC;iBACP,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,CACL,qDAAqD,uBAAuB,KAAK,CACpF;iBACA,QAAQ,EAAE;iBACV,OAAO,CAAC,uBAAuB,CAAC;SACxC,CAAC;IACN,CAAC;IAED,YAAY;QACR,OAAO;YACH,MAAM,EAAE,OAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,CAAC,yCAAyC,CAAC;SAC3D,CAAC;IACN,CAAC;IAED,KAAK,CAAC,MAAM,CACR,OAA0B,EAC1B,IAAoB;QAEpB,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAErC,MAAM,WAAW,GAAW,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,CACnD,CAAC,EAAE,QAAQ,EAAE,EAAU,EAAE;YACrB,MAAM,IAAI,GAAmB,QAAQ;gBACjC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC;gBAClC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YAEpB,IAAI,CAAC,IAAI,EAAE,CAAC;gBACR,MAAM,IAAI,KAAK,CACX,0BAA0B,QAAQ,aAAa,CAClD,CAAC;YACN,CAAC;YAED,MAAM,MAAM,GAAe,QAAQ,CAAC,gBAAgB,CAChD,IAAI,EACJ,UAAU,CAAC,SAAS,EACpB;gBACI,UAAU,EAAE,CAAC,IAAU,EAAE,EAAE;oBACvB,MAAM,KAAK,GACP,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,aAAc,CAAC,CAAC;oBACjD,OAAO,KAAK,CAAC,OAAO,KAAK,MAAM;wBAC3B,KAAK,CAAC,UAAU,KAAK,QAAQ;wBAC7B,CAAC,CAAC,UAAU,CAAC,aAAa;wBAC1B,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC;gBACnC,CAAC;aACJ,CACJ,CAAC;YACF,IAAI,IAAI,GAAW,EAAE,CAAC;YACtB,IAAI,IAAI,CAAC;YACT,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC;gBAChC,MAAM,WAAW,GACb,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;gBAC7B,IAAI,WAAW,EAAE,CAAC;oBACd,IAAI,IAAI,WAAW,GAAG,IAAI,CAAC;gBAC/B,CAAC;YACL,CAAC;YACD,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC,EACD,EAAE,QAAQ,EAAE,CACf,CAAC;QAEF,iBAAiB;QACjB,IAAI,MAAM,GAAW,WAAW,CAAC;QACjC,IAAI,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;YAC5B,MAAM;gBACF,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;oBAC1B,yCAAyC,CAAC;QAClD,CAAC;QACD,OAAO;YACH,MAAM;SACT,CAAC;IACN,CAAC;CACJ;AA9FD,8BA8FC"}

package/dist/tools/content/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tools = void 0;
+const get_as_html_1 = require("./get-as-html");
+const get_as_text_1 = require("./get-as-text");
+const save_as_pdf_1 = require("./save-as-pdf");
+const take_screenshot_1 = require("./take-screenshot");
+const take_aria_snapshot_1 = require("./take-aria-snapshot");
+exports.tools = [
+    new get_as_html_1.GetAsHtml(),
+    new get_as_text_1.GetAsText(),
+    new save_as_pdf_1.SaveAsPdf(),
+    new take_screenshot_1.TakeScreenshot(),
+    new take_aria_snapshot_1.TakeAriaSnapshot(),
+];
+//# sourceMappingURL=index.js.map

package/dist/tools/content/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/content/index.ts"],"names":[],"mappings":";;;AACA,+CAA0C;AAC1C,+CAA0C;AAC1C,+CAA0C;AAC1C,uDAAmD;AACnD,6DAAwD;AAE3C,QAAA,KAAK,GAAW;IACzB,IAAI,uBAAS,EAAE;IACf,IAAI,uBAAS,EAAE;IACf,IAAI,uBAAS,EAAE;IACf,IAAI,gCAAc,EAAE;IACpB,IAAI,qCAAgB,EAAE;CACzB,CAAC"}