@n8n/mcp-browser 0.1.0-rc1

package/dist/connection.js

@@ -0,0 +1,137 @@
+"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.BrowserConnection = void 0;
+const browser_discovery_1 = require("./browser-discovery");
+const errors_1 = require("./errors");
+const types_1 = require("./types");
+class BrowserConnection {
+    constructor(userConfig) {
+        this.state = null;
+        const parsed = types_1.configSchema.parse(userConfig ?? {});
+        const discovery = (0, browser_discovery_1.getDefaultDiscovery)().discover();
+        const browsers = new Map();
+        for (const [name, info] of Object.entries(discovery)) {
+            if (info && typeof info === 'object' && 'executablePath' in info) {
+                const browserInfo = info;
+                browsers.set(name, { ...browserInfo, available: true });
+            }
+        }
+        for (const [name, override] of Object.entries(parsed.browsers)) {
+            const existing = browsers.get(name);
+            if (existing) {
+                if (override.executablePath)
+                    existing.executablePath = override.executablePath;
+                if (override.profilePath)
+                    existing.profilePath = override.profilePath;
+            }
+            else if (override.executablePath) {
+                browsers.set(name, {
+                    executablePath: override.executablePath,
+                    profilePath: override.profilePath,
+                    available: true,
+                });
+            }
+        }
+        this.config = {
+            defaultBrowser: parsed.defaultBrowser,
+            browsers,
+        };
+    }
+    async connect(overrideBrowser) {
+        if (this.state) {
+            throw new errors_1.AlreadyConnectedError();
+        }
+        const browser = overrideBrowser ?? this.config.defaultBrowser;
+        this.requireBrowserAvailable(browser);
+        const connectConfig = {
+            browser,
+        };
+        const adapter = await this.createAdapter();
+        await adapter.launch(connectConfig);
+        const pages = await adapter.listTabs();
+        const pageMap = new Map(pages.map((p) => [p.id, p]));
+        this.state = {
+            adapter,
+            pages: pageMap,
+            activePageId: pages[0]?.id ?? '',
+        };
+        return { browser, pages };
+    }
+    async disconnect() {
+        if (!this.state)
+            return;
+        const { adapter } = this.state;
+        this.state = null;
+        try {
+            await adapter.close();
+        }
+        catch {
+        }
+    }
+    getConnection() {
+        if (!this.state)
+            throw new errors_1.NotConnectedError();
+        return this.state;
+    }
+    get isConnected() {
+        return this.state !== null;
+    }
+    async shutdown() {
+        await this.disconnect();
+    }
+    getResolvedConfig() {
+        return this.config;
+    }
+    getAvailableBrowsers() {
+        return [...this.config.browsers.entries()]
+            .filter(([_, v]) => v.available)
+            .map(([name]) => name);
+    }
+    requireBrowserAvailable(browser) {
+        const info = this.config.browsers.get(browser);
+        if (!info?.available) {
+            const available = this.getAvailableBrowsers();
+            const instructions = (0, browser_discovery_1.getInstallInstructions)(browser);
+            throw new errors_1.BrowserNotAvailableError(browser, available, instructions);
+        }
+    }
+    async createAdapter() {
+        const { PlaywrightAdapter } = await Promise.resolve().then(() => __importStar(require('./adapters/playwright')));
+        return new PlaywrightAdapter(this.config);
+    }
+}
+exports.BrowserConnection = BrowserConnection;
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,40 @@
+export declare class McpBrowserError extends Error {
+    readonly hint?: string | undefined;
+    constructor(message: string, hint?: string | undefined);
+}
+export declare class NotConnectedError extends McpBrowserError {
+    constructor();
+}
+export declare class AlreadyConnectedError extends McpBrowserError {
+    constructor();
+}
+export declare class PageNotFoundError extends McpBrowserError {
+    readonly pageId: string;
+    constructor(pageId: string);
+}
+export declare class StaleRefError extends McpBrowserError {
+    readonly ref: string;
+    constructor(ref: string);
+}
+export declare class UnsupportedOperationError extends McpBrowserError {
+    readonly operation: string;
+    readonly adapterName: string;
+    constructor(operation: string, adapterName: string);
+}
+export declare class BrowserNotAvailableError extends McpBrowserError {
+    readonly browser: string;
+    readonly availableBrowsers: string[];
+    readonly installInstructions?: string | undefined;
+    constructor(browser: string, availableBrowsers?: string[], installInstructions?: string | undefined);
+}
+export declare class BrowserExecutableNotFoundError extends McpBrowserError {
+    readonly browser: string;
+    constructor(browser: string);
+}
+export type ExtensionNotConnectedPhase = 'browser_not_launched' | 'extension_missing' | 'unknown';
+export declare class ExtensionNotConnectedError extends McpBrowserError {
+    readonly timeoutMs: number;
+    readonly phase: ExtensionNotConnectedPhase;
+    readonly extensionInstructions?: string | undefined;
+    constructor(timeoutMs: number, phase?: ExtensionNotConnectedPhase, extensionInstructions?: string | undefined);
+}

package/dist/errors.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExtensionNotConnectedError = exports.BrowserExecutableNotFoundError = exports.BrowserNotAvailableError = exports.UnsupportedOperationError = exports.StaleRefError = exports.PageNotFoundError = exports.AlreadyConnectedError = exports.NotConnectedError = exports.McpBrowserError = void 0;
+class McpBrowserError extends Error {
+    constructor(message, hint) {
+        super(message);
+        this.hint = hint;
+        this.name = this.constructor.name;
+    }
+}
+exports.McpBrowserError = McpBrowserError;
+class NotConnectedError extends McpBrowserError {
+    constructor() {
+        super('Not connected to a browser', 'Call browser_connect first to connect to the browser.');
+    }
+}
+exports.NotConnectedError = NotConnectedError;
+class AlreadyConnectedError extends McpBrowserError {
+    constructor() {
+        super('Already connected to a browser', 'Disconnect first with browser_disconnect before connecting again.');
+    }
+}
+exports.AlreadyConnectedError = AlreadyConnectedError;
+class PageNotFoundError extends McpBrowserError {
+    constructor(pageId) {
+        super(`Page not found: ${pageId}`, 'The page may have been closed. List open pages with browser_tab_list.');
+        this.pageId = pageId;
+    }
+}
+exports.PageNotFoundError = PageNotFoundError;
+class StaleRefError extends McpBrowserError {
+    constructor(ref) {
+        super(`Stale element ref: ${ref}`, 'The ref is from a previous snapshot. Take a fresh snapshot with browser_snapshot and use the new refs.');
+        this.ref = ref;
+    }
+}
+exports.StaleRefError = StaleRefError;
+class UnsupportedOperationError extends McpBrowserError {
+    constructor(operation, adapterName) {
+        super(`Operation not supported: ${operation}`, `This operation is not available for ${adapterName} sessions.`);
+        this.operation = operation;
+        this.adapterName = adapterName;
+    }
+}
+exports.UnsupportedOperationError = UnsupportedOperationError;
+class BrowserNotAvailableError extends McpBrowserError {
+    constructor(browser, availableBrowsers = [], installInstructions) {
+        const alternatives = availableBrowsers.length > 0
+            ? `Compatible Chromium-based browsers found: ${availableBrowsers.join(', ')}. ` +
+                `Call browser_connect with { "browser": "${availableBrowsers[0]}" } to use it instead.`
+            : 'No compatible Chromium-based browsers (Chrome, Brave, Edge, Chromium) were found on this system.';
+        const install = installInstructions ? `\n${installInstructions}` : '';
+        super(`Browser not available: ${browser}`, `${alternatives}${install}`);
+        this.browser = browser;
+        this.availableBrowsers = availableBrowsers;
+        this.installInstructions = installInstructions;
+    }
+}
+exports.BrowserNotAvailableError = BrowserNotAvailableError;
+class BrowserExecutableNotFoundError extends McpBrowserError {
+    constructor(browser) {
+        super(`No executable path for ${browser}`, `The browser "${browser}" was detected but has no executable path configured. ` +
+            'Verify the browser is properly installed or provide an explicit executablePath in the config.');
+        this.browser = browser;
+    }
+}
+exports.BrowserExecutableNotFoundError = BrowserExecutableNotFoundError;
+class ExtensionNotConnectedError extends McpBrowserError {
+    constructor(timeoutMs, phase = 'unknown', extensionInstructions) {
+        const phaseHint = phase === 'browser_not_launched'
+            ? 'The browser process may not have started.'
+            : phase === 'extension_missing'
+                ? 'The browser opened but the n8n AI Browser Bridge extension did not connect.'
+                : 'The extension did not connect within the timeout period.';
+        const install = extensionInstructions ? `\n${extensionInstructions}` : '';
+        super(`Extension connection timed out after ${timeoutMs}ms`, `${phaseHint}${install}\nThen retry browser_connect.`);
+        this.timeoutMs = timeoutMs;
+        this.phase = phase;
+        this.extensionInstructions = extensionInstructions;
+    }
+}
+exports.ExtensionNotConnectedError = ExtensionNotConnectedError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { BrowserConnection } from './connection';
+export { createBrowserTools } from './tools/index';
+export { configureLogger } from './logger';
+export type { LogLevel } from './logger';
+export { parseServerOptions } from './server-config';
+export type { ServerOptions } from './server-config';
+export type { BrowserName, BrowserToolkit, Config, ConnectConfig, ConnectResult, ConnectionState, Cookie, ElementTarget, PageInfo, ResolvedConfig, ToolContext, ToolDefinition, CallToolResult, } from './types';

package/dist/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseServerOptions = exports.configureLogger = exports.createBrowserTools = exports.BrowserConnection = void 0;
+var connection_1 = require("./connection");
+Object.defineProperty(exports, "BrowserConnection", { enumerable: true, get: function () { return connection_1.BrowserConnection; } });
+var index_1 = require("./tools/index");
+Object.defineProperty(exports, "createBrowserTools", { enumerable: true, get: function () { return index_1.createBrowserTools; } });
+var logger_1 = require("./logger");
+Object.defineProperty(exports, "configureLogger", { enumerable: true, get: function () { return logger_1.configureLogger; } });
+var server_config_1 = require("./server-config");
+Object.defineProperty(exports, "parseServerOptions", { enumerable: true, get: function () { return server_config_1.parseServerOptions; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,2CAAiD;AAAxC,+GAAA,iBAAiB,OAAA;AAC1B,uCAAmD;AAA1C,2GAAA,kBAAkB,OAAA;AAC3B,mCAA2C;AAAlC,yGAAA,eAAe,OAAA;AAExB,iDAAqD;AAA5C,mHAAA,kBAAkB,OAAA"}

package/dist/logger.d.ts

@@ -0,0 +1,10 @@
+export type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'debug';
+export declare function configureLogger(options: {
+    level?: LogLevel;
+}): void;
+export declare function createLogger(tag: string): {
+    error: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    debug: (...args: unknown[]) => void;
+};

package/dist/logger.js

@@ -0,0 +1,88 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureLogger = configureLogger;
+exports.createLogger = createLogger;
+const picocolors_1 = __importDefault(require("picocolors"));
+const LEVEL_RANK = {
+    silent: 0,
+    error: 1,
+    warn: 2,
+    info: 3,
+    debug: 4,
+};
+let currentLevel = 'info';
+function configureLogger(options) {
+    currentLevel = options.level ?? 'info';
+}
+function isEnabled(level) {
+    return LEVEL_RANK[level] <= LEVEL_RANK[currentLevel];
+}
+function devTimestamp() {
+    const now = new Date();
+    const pad = (num, digits = 2) => num.toString().padStart(digits, '0');
+    return `${pad(now.getHours())}:${pad(now.getMinutes())}:${pad(now.getSeconds())}.${pad(now.getMilliseconds(), 3)}`;
+}
+function toPrintable(metadata) {
+    if (Object.keys(metadata).length === 0)
+        return '';
+    return JSON.stringify(metadata)
+        .replace(/{"/g, '{ "')
+        .replace(/,"/g, ', "')
+        .replace(/:/g, ': ')
+        .replace(/}/g, ' }');
+}
+const LEVEL_COLORS = {
+    error: picocolors_1.default.red,
+    warn: picocolors_1.default.yellow,
+    info: picocolors_1.default.green,
+    debug: picocolors_1.default.blue,
+};
+function colorFor(level) {
+    return LEVEL_COLORS[level] ?? ((s) => s);
+}
+function devDebugLine(level, message, meta) {
+    const separator = '   ';
+    const ts = devTimestamp();
+    const color = colorFor(level);
+    const lvl = color(level).padEnd(15);
+    const metaStr = toPrintable(meta);
+    const suffix = metaStr ? ' ' + picocolors_1.default.dim(metaStr) : '';
+    return [ts, lvl, color(message) + suffix].join(separator);
+}
+function parseArgs(args, tag) {
+    const meta = { scope: tag };
+    const messageParts = [];
+    for (const arg of args) {
+        if (typeof arg === 'object' && arg !== null && !Array.isArray(arg) && !(arg instanceof Error)) {
+            Object.assign(meta, arg);
+        }
+        else {
+            messageParts.push(String(arg));
+        }
+    }
+    return { message: messageParts.join(' '), meta };
+}
+function createLogger(tag) {
+    const prefix = `[mcp-browser:${tag}]`;
+    function log(level, consoleFn, args) {
+        if (!isEnabled(level))
+            return;
+        if (currentLevel === 'debug') {
+            const { message, meta } = parseArgs(args, tag);
+            consoleFn(devDebugLine(level, message, meta));
+        }
+        else {
+            consoleFn(prefix, ...args);
+        }
+    }
+    return {
+        error: (...args) => log('error', console.error, args),
+        warn: (...args) => log('warn', console.warn, args),
+        info: (...args) => log('info', console.log, args),
+        debug: (...args) => log('debug', console.log, args),
+    };
+}
+//# 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-config.d.ts

@@ -0,0 +1,7 @@
+import type { Config } from './types';
+export interface ServerOptions {
+    config: Partial<Config>;
+    transport: 'stdio' | 'http';
+    port: number;
+}
+export declare function parseServerOptions(argv?: string[]): ServerOptions;

package/dist/server-config.js

@@ -0,0 +1,45 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseServerOptions = parseServerOptions;
+const yargs_parser_1 = __importDefault(require("yargs-parser"));
+const ENV_PREFIX = 'N8N_MCP_BROWSER_';
+function envString(envKey) {
+    return process.env[`${ENV_PREFIX}${envKey}`];
+}
+function envNumber(envKey) {
+    const raw = envString(envKey);
+    if (raw === undefined)
+        return undefined;
+    const n = Number(raw);
+    return Number.isNaN(n) ? undefined : n;
+}
+function parseServerOptions(argv = process.argv.slice(2)) {
+    const args = (0, yargs_parser_1.default)(argv, {
+        string: ['browser', 'transport'],
+        number: ['port'],
+        alias: {
+            b: 'browser',
+            p: 'port',
+            t: 'transport',
+        },
+    });
+    const envConfig = {};
+    const envBrowser = envString('DEFAULT_BROWSER');
+    if (envBrowser)
+        envConfig.defaultBrowser = envBrowser;
+    const cliConfig = {};
+    if (args.browser)
+        cliConfig.defaultBrowser = args.browser;
+    const config = { ...envConfig, ...cliConfig };
+    const envTransport = envString('TRANSPORT');
+    const cliTransport = args.transport;
+    const transport = cliTransport ?? envTransport ?? 'http';
+    const envPort = envNumber('PORT');
+    const cliPort = args.port;
+    const port = cliPort ?? envPort ?? 3100;
+    return { config, transport, port };
+}
+//# sourceMappingURL=server-config.js.map

package/dist/server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../src/server-config.ts"],"names":[],"mappings":";;;;;AAgCA,gDAqCC;AArED,gEAAuC;AAIvC,MAAM,UAAU,GAAG,kBAAkB,CAAC;AAQtC,SAAS,SAAS,CAAC,MAAc;IAChC,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,GAAG,MAAM,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,SAAS,CAAC,MAAc;IAChC,MAAM,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC;AAWD,SAAgB,kBAAkB,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,IAAA,sBAAW,EAAC,IAAI,EAAE;QAE9B,MAAM,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC;QAEhC,MAAM,EAAE,CAAC,MAAM,CAAC;QAChB,KAAK,EAAE;YACN,CAAC,EAAE,SAAS;YACZ,CAAC,EAAE,MAAM;YACT,CAAC,EAAE,WAAW;SACd;KACD,CAAe,CAAC;IAGjB,MAAM,SAAS,GAAoB,EAAE,CAAC;IAEtC,MAAM,UAAU,GAAG,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAChD,IAAI,UAAU;QAAE,SAAS,CAAC,cAAc,GAAG,UAAsC,CAAC;IAGlF,MAAM,SAAS,GAAoB,EAAE,CAAC;IAEtC,IAAI,IAAI,CAAC,OAAO;QAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,OAAmC,CAAC;IAGtF,MAAM,MAAM,GAAoB,EAAE,GAAG,SAAS,EAAE,GAAG,SAAS,EAAE,CAAC;IAG/D,MAAM,YAAY,GAAG,SAAS,CAAC,WAAW,CAAiC,CAAC;IAC5E,MAAM,YAAY,GAAG,IAAI,CAAC,SAAyC,CAAC;IACpE,MAAM,SAAS,GAAG,YAAY,IAAI,YAAY,IAAI,MAAM,CAAC;IAEzD,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC;IAC1B,MAAM,IAAI,GAAG,OAAO,IAAI,OAAO,IAAI,IAAI,CAAC;IAExC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACpC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/server.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
+const node_crypto_1 = require("node:crypto");
+const node_http_1 = require("node:http");
+const server_config_1 = require("./server-config");
+const index_1 = require("./tools/index");
+function registerTools(server, tools) {
+    for (const tool of tools) {
+        server.registerTool(tool.name, {
+            description: tool.description,
+            inputSchema: tool.inputSchema,
+            outputSchema: tool.outputSchema,
+        }, async (args) => {
+            const result = await tool.execute(args, { dir: '' });
+            return { ...result };
+        });
+    }
+}
+async function main() {
+    const { config, transport: transportType, port } = (0, server_config_1.parseServerOptions)();
+    const { tools, connection } = (0, index_1.createBrowserTools)(config);
+    if (transportType === 'http') {
+        const sessions = new Map();
+        const corsHeaders = {
+            'Access-Control-Allow-Origin': '*',
+            'Access-Control-Allow-Methods': 'GET, POST, DELETE, OPTIONS',
+            'Access-Control-Allow-Headers': 'Content-Type, Accept, Mcp-Session-Id, Mcp-Protocol-Version',
+            'Access-Control-Expose-Headers': 'Mcp-Session-Id',
+        };
+        const httpServer = (0, node_http_1.createServer)((req, res) => {
+            if (req.method === 'OPTIONS') {
+                res.writeHead(204, corsHeaders);
+                res.end();
+                return;
+            }
+            for (const [key, value] of Object.entries(corsHeaders)) {
+                res.setHeader(key, value);
+            }
+            const sessionId = req.headers['mcp-session-id'];
+            const existingTransport = sessionId ? sessions.get(sessionId) : undefined;
+            if (existingTransport) {
+                void existingTransport.handleRequest(req, res);
+                return;
+            }
+            if (sessionId) {
+                res.writeHead(404, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({
+                    jsonrpc: '2.0',
+                    error: { code: -32000, message: 'Session not found' },
+                    id: null,
+                }));
+                return;
+            }
+            const transport = new streamableHttp_js_1.StreamableHTTPServerTransport({
+                sessionIdGenerator: () => (0, node_crypto_1.randomUUID)(),
+                onsessioninitialized: (id) => {
+                    sessions.set(id, transport);
+                },
+            });
+            transport.onclose = () => {
+                if (transport.sessionId) {
+                    sessions.delete(transport.sessionId);
+                }
+            };
+            const mcpServer = new mcp_js_1.McpServer({ name: 'n8n-browser', version: '1.0.0' });
+            registerTools(mcpServer, tools);
+            void mcpServer.connect(transport).then(() => {
+                void transport.handleRequest(req, res);
+            });
+        });
+        httpServer.listen(port, () => {
+            console.debug(`n8n-browser MCP server listening on http://localhost:${port}`);
+        });
+    }
+    else {
+        const server = new mcp_js_1.McpServer({ name: 'n8n-browser', version: '1.0.0' });
+        registerTools(server, tools);
+        const transport = new stdio_js_1.StdioServerTransport();
+        await server.connect(transport);
+    }
+    const shutdown = async () => {
+        await connection.shutdown();
+        process.exit(0);
+    };
+    process.on('SIGTERM', () => void shutdown());
+    process.on('SIGINT', () => void shutdown());
+}
+void main();
+//# 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/helpers.d.ts

@@ -0,0 +1,15 @@
+import type { z } from 'zod';
+import type { BrowserConnection } from '../connection';
+import type { CallToolResult, ConnectionState, ToolDefinition } from '../types';
+export { consoleSummarySchema, elementTargetSchema, modalStateSchema, pageIdField, withSnapshotEnvelope, } from './schemas';
+export type { ElementTargetInput } from './schemas';
+type ConnectedToolInput = {
+    pageId?: string;
+};
+export interface ConnectedToolOptions {
+    autoSnapshot?: boolean;
+    waitForCompletion?: boolean;
+    skipEnrichment?: boolean;
+}
+export declare function extractDomain(url: string): string;
+export declare function createConnectedTool<TSchema extends z.ZodType<ConnectedToolInput & Record<string, unknown>>>(connection: BrowserConnection, name: string, description: string, inputSchema: TSchema, fn: (state: ConnectionState, input: z.infer<TSchema>, pageId: string) => Promise<CallToolResult>, outputSchema?: z.ZodObject<z.ZodRawShape>, options?: ConnectedToolOptions, getResourceFromArgs?: (args: z.infer<TSchema>) => string): ToolDefinition<TSchema>;