@mario.andreschak/mcp-browser 3.39.0

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+export * from './tools.js';
+export * from './resources.js';
+export * from './runtime.js';

package/dist/index.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListResourceTemplatesRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { browserCallTool, browserToolDefinitions } from './tools.js';
+import { browserListResources, browserReadResource } from './resources.js';
+import { shutdownBrowserRuntime } from './runtime.js';
+export * from './tools.js';
+export * from './resources.js';
+export * from './runtime.js';
+const server = new Server({ name: '@mario.andreschak/mcp-browser', version: '3.38.0' }, { capabilities: { tools: {}, resources: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: browserToolDefinitions() }));
+server.setRequestHandler(CallToolRequestSchema, async (request, extra) => browserCallTool(request.params.name, request.params.arguments ?? {}, extra.signal));
+server.setRequestHandler(ListResourcesRequestSchema, async () => browserListResources());
+server.setRequestHandler(ListResourceTemplatesRequestSchema, async () => ({ resourceTemplates: [] }));
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => browserReadResource(request.params.uri));
+const transport = new StdioServerTransport();
+let closing = false;
+async function shutdown() {
+    if (closing)
+        return;
+    closing = true;
+    await shutdownBrowserRuntime();
+    await server.close().catch(() => undefined);
+}
+process.once('SIGINT', () => void shutdown());
+process.once('SIGTERM', () => void shutdown());
+process.once('SIGHUP', () => void shutdown());
+process.once('beforeExit', () => void shutdownBrowserRuntime());
+server.connect(transport).catch((error) => {
+    process.stderr.write(`@mario.andreschak/mcp-browser failed: ${error instanceof Error ? error.name : 'unknown error'}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,kCAAkC,EAClC,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAE7B,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,+BAA+B,EAAE,OAAO,EAAE,QAAQ,EAAE,EAC5D,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,CAC/C,CAAC;AAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAC,CAAC;AACpG,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CACvE,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CACnF,CAAC;AACF,MAAM,CAAC,iBAAiB,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE,CAAC,oBAAoB,EAAE,CAAC,CAAC;AACzF,MAAM,CAAC,iBAAiB,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,iBAAiB,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;AACtG,MAAM,CAAC,iBAAiB,CAAC,yBAAyB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,mBAAmB,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAEhH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,IAAI,OAAO,GAAG,KAAK,CAAC;AACpB,KAAK,UAAU,QAAQ;IACrB,IAAI,OAAO;QAAE,OAAO;IACpB,OAAO,GAAG,IAAI,CAAC;IACf,MAAM,sBAAsB,EAAE,CAAC;IAC/B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AAC9C,CAAC;AACD,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;AAC9C,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;AAC/C,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;AAC9C,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK,sBAAsB,EAAE,CAAC,CAAC;AAEhE,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC;IACzH,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/resources.d.ts

@@ -0,0 +1,6 @@
+import type { Resource, ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const BROWSER_APP_URI = "ui://browser/view";
+export declare function browserListResources(): {
+    resources: Resource[];
+};
+export declare function browserReadResource(uri: string): ReadResourceResult;

package/dist/resources.js

@@ -0,0 +1,78 @@
+const MCP_APPS_PROTOCOL_VERSION = '2026-01-26';
+const APP_MIME_TYPE = 'text/html;profile=mcp-app';
+export const BROWSER_APP_URI = 'ui://browser/view';
+export function browserListResources() {
+    return {
+        resources: [{
+                uri: BROWSER_APP_URI,
+                name: 'browser_view',
+                mimeType: APP_MIME_TYPE,
+                description: 'Interactive view of the isolated server-side Patchright browser session.',
+            }],
+    };
+}
+export function browserReadResource(uri) {
+    if (uri !== BROWSER_APP_URI)
+        throw new Error(`Unknown browser resource: ${uri}`);
+    return {
+        contents: [{
+                uri,
+                mimeType: APP_MIME_TYPE,
+                text: BROWSER_APP_HTML,
+                _meta: {
+                    ui: {
+                        csp: { connectDomains: [], resourceDomains: [] },
+                        permissions: {},
+                    },
+                },
+            }],
+    };
+}
+const BROWSER_APP_HTML = `<!doctype html>
+<html>
+<head>
+<meta charset="utf-8" />
+<style>
+:root{--bg:#fff;--fg:#171717;--muted:#666;--border:#ddd;--accent:#1565c0;--panel:#f6f7f8;--danger:#b42318}
+[data-theme="dark"]{--bg:#171717;--fg:#eee;--muted:#aaa;--border:#444;--accent:#64b5f6;--panel:#242424;--danger:#ff8a80}
+*{box-sizing:border-box}html,body{margin:0;min-height:100%}body{font:13px/1.45 system-ui,sans-serif;background:var(--bg);color:var(--fg)}
+#wrap{padding:10px}.row{display:flex;gap:6px;align-items:center;margin-bottom:7px;flex-wrap:wrap}input,button{font:inherit;border:1px solid var(--border);border-radius:5px;background:var(--bg);color:var(--fg);padding:5px 8px}button{cursor:pointer}button:hover{border-color:var(--accent)}#url{flex:1;min-width:220px}.selector{flex:1;min-width:150px}.status{color:var(--muted);min-height:19px}.error{color:var(--danger)}.viewport{border:1px solid var(--border);border-radius:7px;background:var(--panel);min-height:160px;display:grid;place-items:center;overflow:auto}.viewport img{display:block;max-width:100%;height:auto}.empty{color:var(--muted);padding:25px}.meta{font-size:12px;color:var(--muted);overflow:hidden;text-overflow:ellipsis;white-space:nowrap;margin:5px 0}details{margin-top:7px}pre{white-space:pre-wrap;word-break:break-word;max-height:180px;overflow:auto;background:var(--panel);padding:7px;border-radius:5px}
+</style>
+</head>
+<body>
+<div id="wrap">
+  <div class="row"><input id="url" type="url" placeholder="https://example.com" /><button id="go">Go</button><button id="refresh">Refresh view</button><button id="close">Close</button></div>
+  <div class="row"><input id="selector" class="selector" placeholder="CSS selector" /><button id="click">Click</button><input id="text" class="selector" placeholder="Text to fill" /><button id="fill">Fill</button></div>
+  <div id="status" class="status">Initializing isolated browser…</div>
+  <div id="meta" class="meta"></div>
+  <div id="viewport" class="viewport"><div class="empty">No screenshot yet.</div></div>
+  <details><summary>Visible page text</summary><pre id="snapshot"></pre></details>
+</div>
+<script>
+(function(){
+  var parentWin=window.parent,idc=1,pending={},sessionId="",started=false;
+  var statusEl=document.getElementById("status"),metaEl=document.getElementById("meta"),viewEl=document.getElementById("viewport"),snapEl=document.getElementById("snapshot");
+  function post(m){parentWin.postMessage(m,"*")}
+  function rpc(method,params){return new Promise(function(resolve,reject){var id=idc++;pending[id]={resolve:resolve,reject:reject};post({jsonrpc:"2.0",id:id,method:method,params:params||{}})})}
+  function notify(method,params){post({jsonrpc:"2.0",method:method,params:params||{}})}
+  function setStatus(text,error){statusEl.textContent=text;statusEl.className="status"+(error?" error":"")}
+  function payload(result){if(result&&result.structuredContent)return result.structuredContent;try{var t=result&&result.content&&result.content[0]&&result.content[0].text;return t?JSON.parse(t):{}}catch(e){return{}}}
+  function failMessage(result){var p=payload(result);return p&&p.error&&p.error.message?p.error.message:"Browser operation failed"}
+  function apply(data){if(!data)return;if(data.sessionId)sessionId=data.sessionId;if(data.url){document.getElementById("url").value=data.url;metaEl.textContent=(data.title?data.title+" — ":"")+data.url}if(typeof data.text==="string")snapEl.textContent=data.text}
+  function imageOf(result){var items=result&&result.content||[];for(var i=0;i<items.length;i++){if(items[i].type==="image"&&items[i].data)return "data:"+(items[i].mimeType||"image/png")+";base64,"+items[i].data}return""}
+  async function call(name,args){setStatus("Working…");var result=await rpc("tools/call",{name:name,arguments:args||{}});if(result&&result.isError)throw new Error(failMessage(result));apply(payload(result));return result}
+  async function refresh(){if(!sessionId)return;try{var result=await call("browser_screenshot",{sessionId:sessionId});var image=imageOf(result);viewEl.innerHTML="";if(image){var img=document.createElement("img");img.src=image;img.alt="Current server-side browser viewport";viewEl.appendChild(img)}else{viewEl.textContent="Screenshot was not available."}var snap=await call("browser_snapshot",{sessionId:sessionId});apply(payload(snap));setStatus("Ready");size()}catch(e){setStatus(e&&e.message?e.message:String(e),true)}}
+  async function open(initialUrl,requestedId){if(started)return;started=true;try{var args={};if(initialUrl)args.url=initialUrl;if(requestedId)args.sessionId=requestedId;var result=await call("browser_open",args);apply(payload(result));await refresh()}catch(e){setStatus(e&&e.message?e.message:String(e),true)}}
+  async function navigate(){var url=document.getElementById("url").value.trim();if(!url)return setStatus("Enter an HTTP(S) URL.",true);try{if(!sessionId){started=false;await open(url,"")}else{await call("browser_navigate",{sessionId:sessionId,url:url});await refresh()}}catch(e){setStatus(e&&e.message?e.message:String(e),true)}}
+  async function click(){var selector=document.getElementById("selector").value.trim();if(!selector)return setStatus("Enter a selector.",true);try{await call("browser_click",{sessionId:sessionId,selector:selector});await refresh()}catch(e){setStatus(e&&e.message?e.message:String(e),true)}}
+  async function fill(){var selector=document.getElementById("selector").value.trim();if(!selector)return setStatus("Enter a selector.",true);try{await call("browser_type",{sessionId:sessionId,selector:selector,text:document.getElementById("text").value});await refresh()}catch(e){setStatus(e&&e.message?e.message:String(e),true)}}
+  function size(){try{notify("ui/notifications/size-changed",{width:0,height:Math.ceil(document.documentElement.getBoundingClientRect().height)})}catch(e){}}
+  document.getElementById("go").onclick=navigate;document.getElementById("refresh").onclick=refresh;document.getElementById("click").onclick=click;document.getElementById("fill").onclick=fill;
+  document.getElementById("close").onclick=async function(){if(!sessionId)return;try{await call("browser_close",{sessionId:sessionId});sessionId="";viewEl.innerHTML='<div class="empty">Browser session closed.</div>';setStatus("Closed");size()}catch(e){setStatus(e&&e.message?e.message:String(e),true)}};
+  window.addEventListener("message",function(event){var m=event.data;if(!m||m.jsonrpc!=="2.0")return;if(m.id!==undefined&&(m.result!==undefined||m.error!==undefined)){var p=pending[m.id];if(!p)return;delete pending[m.id];if(m.error)p.reject(new Error(m.error.message||"RPC error"));else p.resolve(m.result);return}if(m.method==="ui/notifications/host-context-changed"){var theme=m.params&&m.params.theme;document.documentElement.setAttribute("data-theme",theme==="dark"?"dark":"light");return}if(m.method==="ui/notifications/tool-input"){var a=m.params&&m.params.arguments||{};if(!started)open(typeof a.url==="string"?a.url:"",typeof a.sessionId==="string"?a.sessionId:"");return}if(m.method==="ui/notifications/tool-result"){apply(payload(m.params));return}if(m.method==="ping"&&m.id!==undefined){post({jsonrpc:"2.0",id:m.id,result:{}});return}if(m.method==="ui/resource-teardown"&&m.id!==undefined){post({jsonrpc:"2.0",id:m.id,result:{}});return}});
+  rpc("ui/initialize",{appInfo:{name:"flujo-browser-view",version:"1.0.0"},appCapabilities:{availableDisplayModes:["inline","fullscreen","pip"]},protocolVersion:"${MCP_APPS_PROTOCOL_VERSION}"}).then(function(result){var theme=result&&result.hostContext&&result.hostContext.theme;document.documentElement.setAttribute("data-theme",theme==="dark"?"dark":"light");notify("ui/notifications/initialized",{});setTimeout(function(){if(!started)open("","")},400)}).catch(function(e){setStatus("App initialization failed: "+(e&&e.message?e.message:e),true)});
+})();
+</script>
+</body>
+</html>`;
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAEA,MAAM,yBAAyB,GAAG,YAAY,CAAC;AAC/C,MAAM,aAAa,GAAG,2BAA2B,CAAC;AAClD,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAEnD,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,SAAS,EAAE,CAAC;gBACV,GAAG,EAAE,eAAe;gBACpB,IAAI,EAAE,cAAc;gBACpB,QAAQ,EAAE,aAAa;gBACvB,WAAW,EAAE,0EAA0E;aACxF,CAAC;KACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,IAAI,GAAG,KAAK,eAAe;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,EAAE,CAAC,CAAC;IACjF,OAAO;QACL,QAAQ,EAAE,CAAC;gBACT,GAAG;gBACH,QAAQ,EAAE,aAAa;gBACvB,IAAI,EAAE,gBAAgB;gBACtB,KAAK,EAAE;oBACL,EAAE,EAAE;wBACF,GAAG,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE;wBAChD,WAAW,EAAE,EAAE;qBAChB;iBACF;aACwC,CAAC;KAC7C,CAAC;AACJ,CAAC;AAED,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oKA0C2I,yBAAyB;;;;QAIrL,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,26 @@
+import { type BrowserContext, type Page } from 'patchright';
+export type BrowserErrorCode = 'BROWSER_UNAVAILABLE' | 'CANCELLED' | 'INVALID_ARGUMENT' | 'NAVIGATION_BLOCKED' | 'NOT_FOUND' | 'SESSION_LIMIT' | 'TIMEOUT' | 'UNEXPECTED';
+export declare class BrowserMcpError extends Error {
+    readonly code: BrowserErrorCode;
+    constructor(code: BrowserErrorCode, message: string);
+}
+export type BrowserSession = {
+    id: string;
+    context: BrowserContext;
+    page: Page;
+    touchedAt: number;
+    documentRequests: number;
+    navigationBlocked: boolean;
+};
+export declare function timeoutMs(value: unknown): number;
+export declare function assertNavigationAllowed(input: string): Promise<URL>;
+export declare function openSession(requestedId: unknown, signal: AbortSignal): Promise<BrowserSession>;
+export declare function getSession(value: unknown): BrowserSession;
+export declare function closeSession(value: unknown): Promise<boolean>;
+export declare function runCancellable<T>(session: BrowserSession, signal: AbortSignal, operation: () => Promise<T>): Promise<T>;
+export declare function resetNavigationCounter(session: BrowserSession): void;
+export declare function publicPageState(session: BrowserSession): {
+    sessionId: string;
+    url: string;
+};
+export declare function shutdownBrowserRuntime(): Promise<void>;

package/dist/runtime.js

@@ -0,0 +1,343 @@
+import { promises as fs } from 'node:fs';
+import { isIP } from 'node:net';
+import { lookup } from 'node:dns/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { chromium } from 'patchright';
+const DEFAULT_TIMEOUT_MS = 30_000;
+const MAX_TIMEOUT_MS = 60_000;
+const DEFAULT_IDLE_MS = 10 * 60_000;
+const DEFAULT_MAX_SESSIONS = 4;
+const DEFAULT_MAX_REDIRECTS = 10;
+const SESSION_ID_PATTERN = /^[A-Za-z0-9_-]{1,64}$/;
+export class BrowserMcpError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'BrowserMcpError';
+    }
+}
+let browser;
+let browserPromise;
+let runtimeRoot;
+const sessions = new Map();
+function integerEnv(name, fallback, min, max) {
+    const raw = Number.parseInt(process.env[name] ?? '', 10);
+    return Number.isFinite(raw) ? Math.min(max, Math.max(min, raw)) : fallback;
+}
+function enabledEnv(name) {
+    return /^(1|true|yes|on)$/i.test(process.env[name]?.trim() ?? '');
+}
+export function timeoutMs(value) {
+    if (value === undefined)
+        return DEFAULT_TIMEOUT_MS;
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new BrowserMcpError('INVALID_ARGUMENT', 'timeoutMs must be a finite number.');
+    }
+    return Math.min(MAX_TIMEOUT_MS, Math.max(1_000, Math.trunc(value)));
+}
+function allowedOrigins() {
+    const origins = new Set();
+    for (const entry of (process.env.FLUJO_BROWSER_ALLOWED_ORIGINS ?? '').split(',')) {
+        const trimmed = entry.trim();
+        if (!trimmed)
+            continue;
+        try {
+            const url = new URL(trimmed);
+            if ((url.protocol === 'http:' || url.protocol === 'https:') && url.origin === trimmed.replace(/\/$/, '')) {
+                origins.add(url.origin);
+            }
+        }
+        catch {
+            // Invalid policy entries never widen access.
+        }
+    }
+    return origins;
+}
+function isPrivateAddress(address) {
+    const normalized = address.toLowerCase().replace(/^::ffff:/, '');
+    if (normalized === '::1' || normalized === '::' || normalized.startsWith('fe80:'))
+        return true;
+    if (normalized.startsWith('fc') || normalized.startsWith('fd'))
+        return true;
+    if (isIP(normalized) !== 4)
+        return false;
+    const parts = normalized.split('.').map(Number);
+    return parts[0] === 0
+        || parts[0] === 10
+        || parts[0] === 127
+        || (parts[0] === 169 && parts[1] === 254)
+        || (parts[0] === 172 && parts[1] >= 16 && parts[1] <= 31)
+        || (parts[0] === 192 && parts[1] === 168)
+        || (parts[0] === 100 && parts[1] >= 64 && parts[1] <= 127)
+        || parts[0] >= 224;
+}
+export async function assertNavigationAllowed(input) {
+    let url;
+    try {
+        url = new URL(input);
+    }
+    catch {
+        throw new BrowserMcpError('NAVIGATION_BLOCKED', 'The URL is malformed.');
+    }
+    if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+        throw new BrowserMcpError('NAVIGATION_BLOCKED', 'Only HTTP and HTTPS URLs are allowed.');
+    }
+    if (url.username || url.password) {
+        throw new BrowserMcpError('NAVIGATION_BLOCKED', 'URLs containing credentials are not allowed.');
+    }
+    const configuredOrigins = allowedOrigins();
+    if (configuredOrigins.size > 0 && !configuredOrigins.has(url.origin)) {
+        throw new BrowserMcpError('NAVIGATION_BLOCKED', 'The URL origin is not allowed by browser policy.');
+    }
+    if (!enabledEnv('FLUJO_BROWSER_ALLOW_PRIVATE_HOSTS')) {
+        const hostname = url.hostname.toLowerCase().replace(/^\[|\]$/g, '');
+        if (hostname === 'localhost' || hostname.endsWith('.localhost') || hostname.endsWith('.local')) {
+            throw new BrowserMcpError('NAVIGATION_BLOCKED', 'Private and local network destinations are blocked.');
+        }
+        try {
+            const addresses = isIP(hostname)
+                ? [{ address: hostname }]
+                : await lookup(hostname, { all: true, verbatim: true });
+            if (addresses.length === 0 || addresses.some(({ address }) => isPrivateAddress(address))) {
+                throw new BrowserMcpError('NAVIGATION_BLOCKED', 'Private and local network destinations are blocked.');
+            }
+        }
+        catch (error) {
+            if (error instanceof BrowserMcpError)
+                throw error;
+            throw new BrowserMcpError('NAVIGATION_BLOCKED', 'The destination hostname could not be resolved safely.');
+        }
+    }
+    return url;
+}
+async function ensureRuntimeRoot() {
+    if (!runtimeRoot)
+        runtimeRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'flujo-browser-'));
+    return runtimeRoot;
+}
+async function acquireBrowser() {
+    if (browser?.isConnected())
+        return browser;
+    if (browserPromise)
+        return browserPromise;
+    browserPromise = (async () => {
+        const downloadsPath = await ensureRuntimeRoot();
+        try {
+            const launched = await chromium.launch({
+                headless: true,
+                downloadsPath,
+                ...(process.env.FLUJO_BROWSER_EXECUTABLE_PATH
+                    ? { executablePath: process.env.FLUJO_BROWSER_EXECUTABLE_PATH }
+                    : {}),
+            });
+            browser = launched;
+            launched.once('disconnected', () => {
+                if (browser === launched)
+                    browser = undefined;
+                sessions.clear();
+            });
+            return launched;
+        }
+        catch {
+            throw new BrowserMcpError('BROWSER_UNAVAILABLE', 'Patchright could not start Chromium. Install the managed browser binary and check the server platform prerequisites.');
+        }
+        finally {
+            browserPromise = undefined;
+        }
+    })();
+    return browserPromise;
+}
+function validateSessionId(value) {
+    if (value === undefined || value === '')
+        return randomUUID();
+    if (typeof value !== 'string' || !SESSION_ID_PATTERN.test(value)) {
+        throw new BrowserMcpError('INVALID_ARGUMENT', 'sessionId must contain 1-64 letters, digits, underscores, or hyphens.');
+    }
+    return value;
+}
+async function closeSessionInternal(id) {
+    const session = sessions.get(id);
+    if (!session)
+        return false;
+    sessions.delete(id);
+    await session.context.close().catch(() => undefined);
+    return true;
+}
+export async function openSession(requestedId, signal) {
+    if (signal.aborted)
+        throw new BrowserMcpError('CANCELLED', 'The browser request was cancelled.');
+    const id = validateSessionId(requestedId);
+    const existing = sessions.get(id);
+    if (existing) {
+        existing.touchedAt = Date.now();
+        return existing;
+    }
+    const maxSessions = integerEnv('FLUJO_BROWSER_MAX_SESSIONS', DEFAULT_MAX_SESSIONS, 1, 32);
+    if (sessions.size >= maxSessions) {
+        throw new BrowserMcpError('SESSION_LIMIT', `The browser session limit (${maxSessions}) has been reached.`);
+    }
+    const activeBrowser = await acquireBrowser();
+    if (signal.aborted)
+        throw new BrowserMcpError('CANCELLED', 'The browser request was cancelled.');
+    let context;
+    let contextClosePromise;
+    let cancelled = false;
+    const closeContext = () => {
+        if (!context)
+            return Promise.resolve();
+        contextClosePromise ??= context.close().catch(() => undefined);
+        return contextClosePromise;
+    };
+    const onAbort = () => {
+        cancelled = true;
+        void closeContext();
+    };
+    signal.addEventListener('abort', onAbort, { once: true });
+    try {
+        context = await activeBrowser.newContext({
+            acceptDownloads: false,
+            serviceWorkers: 'block',
+            viewport: { width: 1280, height: 720 },
+        });
+        if (cancelled || signal.aborted) {
+            throw new BrowserMcpError('CANCELLED', 'The browser request was cancelled.');
+        }
+        const session = {
+            id,
+            context,
+            page: await context.newPage(),
+            touchedAt: Date.now(),
+            documentRequests: 0,
+            navigationBlocked: false,
+        };
+        if (cancelled || signal.aborted) {
+            throw new BrowserMcpError('CANCELLED', 'The browser request was cancelled.');
+        }
+        const maxRedirects = integerEnv('FLUJO_BROWSER_MAX_REDIRECTS', DEFAULT_MAX_REDIRECTS, 0, 50);
+        await context.route('**/*', async (route) => {
+            const request = route.request();
+            try {
+                if (request.resourceType() === 'document') {
+                    session.documentRequests += 1;
+                    if (session.documentRequests > maxRedirects + 1) {
+                        throw new BrowserMcpError('NAVIGATION_BLOCKED', 'The navigation exceeded the redirect limit.');
+                    }
+                }
+                await assertNavigationAllowed(request.url());
+                await route.continue();
+            }
+            catch {
+                session.navigationBlocked = true;
+                await route.abort('blockedbyclient').catch(() => undefined);
+            }
+        });
+        if (cancelled || signal.aborted) {
+            throw new BrowserMcpError('CANCELLED', 'The browser request was cancelled.');
+        }
+        session.page.on('download', (download) => void download.cancel().catch(() => undefined));
+        session.page.on('close', () => sessions.delete(id));
+        sessions.set(id, session);
+        return session;
+    }
+    catch (error) {
+        await closeContext();
+        if (cancelled || signal.aborted) {
+            throw new BrowserMcpError('CANCELLED', 'The browser request was cancelled.');
+        }
+        throw error;
+    }
+    finally {
+        signal.removeEventListener('abort', onAbort);
+    }
+}
+export function getSession(value) {
+    if (typeof value !== 'string' || !SESSION_ID_PATTERN.test(value)) {
+        throw new BrowserMcpError('INVALID_ARGUMENT', 'A valid sessionId is required.');
+    }
+    const session = sessions.get(value);
+    if (!session || session.page.isClosed()) {
+        sessions.delete(value);
+        throw new BrowserMcpError('NOT_FOUND', 'The browser session does not exist or has expired.');
+    }
+    session.touchedAt = Date.now();
+    return session;
+}
+export async function closeSession(value) {
+    if (typeof value !== 'string' || !SESSION_ID_PATTERN.test(value)) {
+        throw new BrowserMcpError('INVALID_ARGUMENT', 'A valid sessionId is required.');
+    }
+    return closeSessionInternal(value);
+}
+export async function runCancellable(session, signal, operation) {
+    if (signal.aborted) {
+        await closeSessionInternal(session.id);
+        throw new BrowserMcpError('CANCELLED', 'The browser request was cancelled.');
+    }
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const onAbort = () => {
+            if (settled)
+                return;
+            settled = true;
+            void closeSessionInternal(session.id).finally(() => {
+                reject(new BrowserMcpError('CANCELLED', 'The browser request was cancelled.'));
+            });
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+        operation().then((value) => {
+            if (settled)
+                return;
+            settled = true;
+            signal.removeEventListener('abort', onAbort);
+            resolve(value);
+        }, (error) => {
+            if (settled)
+                return;
+            settled = true;
+            signal.removeEventListener('abort', onAbort);
+            reject(error);
+        });
+    });
+}
+export function resetNavigationCounter(session) {
+    session.documentRequests = 0;
+    session.navigationBlocked = false;
+}
+export function publicPageState(session) {
+    let url = session.page.url();
+    try {
+        const parsed = new URL(url);
+        parsed.search = '';
+        parsed.hash = '';
+        url = parsed.href;
+    }
+    catch {
+        url = url === 'about:blank' ? url : '';
+    }
+    return { sessionId: session.id, url };
+}
+export async function shutdownBrowserRuntime() {
+    const ids = [...sessions.keys()];
+    await Promise.all(ids.map((id) => closeSessionInternal(id)));
+    const active = browser;
+    browser = undefined;
+    await active?.close().catch(() => undefined);
+    if (runtimeRoot) {
+        const root = runtimeRoot;
+        runtimeRoot = undefined;
+        await fs.rm(root, { recursive: true, force: true }).catch(() => undefined);
+    }
+}
+const idleTimer = setInterval(() => {
+    const idleMs = integerEnv('FLUJO_BROWSER_IDLE_TIMEOUT_MS', DEFAULT_IDLE_MS, 10_000, 24 * 60 * 60_000);
+    const cutoff = Date.now() - idleMs;
+    for (const session of sessions.values()) {
+        if (session.touchedAt < cutoff)
+            void closeSessionInternal(session.id);
+    }
+}, 30_000);
+idleTimer.unref();
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,3 @@
+import type { CallToolResult, Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare function browserToolDefinitions(): Tool[];
+export declare function browserCallTool(name: string, rawArgs: unknown, signal: AbortSignal): Promise<CallToolResult>;

package/dist/tools.js

@@ -0,0 +1,283 @@
+import { BrowserMcpError, assertNavigationAllowed, closeSession, getSession, openSession, publicPageState, resetNavigationCounter, runCancellable, timeoutMs, } from './runtime.js';
+import { BROWSER_APP_URI } from './resources.js';
+const MAX_TEXT_CHARS = 50_000;
+const MAX_SELECTOR_CHARS = 2_000;
+const MAX_SCREENSHOT_BYTES = 5_000_000;
+const READ_ANNOTATIONS = {
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true,
+};
+const INTERACTION_ANNOTATIONS = {
+    readOnlyHint: false,
+    destructiveHint: false,
+    openWorldHint: true,
+};
+const APP_META = {
+    ui: {
+        resourceUri: BROWSER_APP_URI,
+        visibility: ['model', 'app'],
+    },
+};
+const SESSION_PROPERTY = {
+    type: 'string',
+    pattern: '^[A-Za-z0-9_-]{1,64}$',
+    description: 'Opaque browser session identifier returned by browser_open.',
+};
+const TIMEOUT_PROPERTY = {
+    type: 'number',
+    minimum: 1000,
+    maximum: 60000,
+    description: 'Operation timeout in milliseconds (default 30000).',
+};
+export function browserToolDefinitions() {
+    return [
+        {
+            name: 'browser_open',
+            description: 'Open an isolated incognito browser session, optionally navigating to an allowed HTTP(S) URL.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sessionId: { ...SESSION_PROPERTY, description: 'Optional stable id for bounded session reuse.' },
+                    url: { type: 'string', description: 'Optional initial HTTP(S) URL.' },
+                    timeoutMs: TIMEOUT_PROPERTY,
+                },
+                additionalProperties: false,
+            },
+            annotations: INTERACTION_ANNOTATIONS,
+            _meta: APP_META,
+        },
+        {
+            name: 'browser_navigate',
+            description: 'Navigate an existing isolated browser session to an allowed HTTP(S) URL.',
+            inputSchema: {
+                type: 'object',
+                properties: { sessionId: SESSION_PROPERTY, url: { type: 'string' }, timeoutMs: TIMEOUT_PROPERTY },
+                required: ['sessionId', 'url'],
+                additionalProperties: false,
+            },
+            annotations: INTERACTION_ANNOTATIONS,
+            _meta: APP_META,
+        },
+        {
+            name: 'browser_snapshot',
+            description: 'Read the current page title, URL, and bounded visible body text without exposing cookies or storage.',
+            inputSchema: {
+                type: 'object',
+                properties: { sessionId: SESSION_PROPERTY, timeoutMs: TIMEOUT_PROPERTY },
+                required: ['sessionId'],
+                additionalProperties: false,
+            },
+            annotations: READ_ANNOTATIONS,
+            _meta: APP_META,
+        },
+        {
+            name: 'browser_click',
+            description: 'Click the first element matching an explicit selector in an existing browser session.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sessionId: SESSION_PROPERTY,
+                    selector: { type: 'string', minLength: 1, maxLength: MAX_SELECTOR_CHARS },
+                    timeoutMs: TIMEOUT_PROPERTY,
+                },
+                required: ['sessionId', 'selector'],
+                additionalProperties: false,
+            },
+            annotations: INTERACTION_ANNOTATIONS,
+            _meta: APP_META,
+        },
+        {
+            name: 'browser_type',
+            description: 'Fill the first element matching an explicit selector; optionally press Enter afterward.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sessionId: SESSION_PROPERTY,
+                    selector: { type: 'string', minLength: 1, maxLength: MAX_SELECTOR_CHARS },
+                    text: { type: 'string', maxLength: 100000 },
+                    submit: { type: 'boolean', default: false },
+                    timeoutMs: TIMEOUT_PROPERTY,
+                },
+                required: ['sessionId', 'selector', 'text'],
+                additionalProperties: false,
+            },
+            annotations: INTERACTION_ANNOTATIONS,
+            _meta: APP_META,
+        },
+        {
+            name: 'browser_screenshot',
+            description: 'Capture a PNG screenshot of the current page in memory; no host filesystem path is exposed.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    sessionId: SESSION_PROPERTY,
+                    fullPage: { type: 'boolean', default: false },
+                    timeoutMs: TIMEOUT_PROPERTY,
+                },
+                required: ['sessionId'],
+                additionalProperties: false,
+            },
+            annotations: READ_ANNOTATIONS,
+            _meta: APP_META,
+        },
+        {
+            name: 'browser_close',
+            description: 'Close an isolated browser session and discard its cookies, storage, and temporary state.',
+            inputSchema: {
+                type: 'object',
+                properties: { sessionId: SESSION_PROPERTY },
+                required: ['sessionId'],
+                additionalProperties: false,
+            },
+            annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
+            _meta: APP_META,
+        },
+    ];
+}
+function success(data, extraContent = []) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(data) }, ...extraContent],
+        structuredContent: data,
+    };
+}
+function failure(code, message) {
+    const data = { success: false, error: { code, message } };
+    return {
+        isError: true,
+        content: [{ type: 'text', text: JSON.stringify(data) }],
+        structuredContent: data,
+    };
+}
+function normalizedError(error) {
+    if (error instanceof BrowserMcpError)
+        return error;
+    const name = error instanceof Error ? error.name : '';
+    const message = error instanceof Error ? error.message : '';
+    if (name === 'TimeoutError' || /timeout/i.test(name)) {
+        return new BrowserMcpError('TIMEOUT', 'The browser operation timed out.');
+    }
+    if (/ERR_BLOCKED_BY_CLIENT|blockedbyclient/i.test(message)) {
+        return new BrowserMcpError('NAVIGATION_BLOCKED', 'The navigation was blocked by browser policy.');
+    }
+    if (/Target page, context or browser has been closed|browser has disconnected/i.test(message)) {
+        return new BrowserMcpError('BROWSER_UNAVAILABLE', 'The browser process became unavailable; open a new session.');
+    }
+    return new BrowserMcpError('UNEXPECTED', 'The browser operation failed.');
+}
+function objectArgs(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new BrowserMcpError('INVALID_ARGUMENT', 'Tool arguments must be an object.');
+    }
+    return value;
+}
+function stringArg(args, key, maxLength = 100_000) {
+    const value = args[key];
+    if (typeof value !== 'string' || value.length === 0 || value.length > maxLength) {
+        throw new BrowserMcpError('INVALID_ARGUMENT', `${key} must be a non-empty string no longer than ${maxLength} characters.`);
+    }
+    return value;
+}
+async function pageState(session, timeout) {
+    const [title, bodyText] = await Promise.all([
+        session.page.title(),
+        session.page.locator('body').innerText({ timeout }).catch(() => ''),
+    ]);
+    const text = bodyText.length > MAX_TEXT_CHARS
+        ? `${bodyText.slice(0, MAX_TEXT_CHARS)}\n…[truncated]`
+        : bodyText;
+    return { success: true, ...publicPageState(session), title, text };
+}
+async function navigate(session, rawUrl, timeout, signal) {
+    const url = await assertNavigationAllowed(rawUrl);
+    resetNavigationCounter(session);
+    return runCancellable(session, signal, async () => {
+        try {
+            await session.page.goto(url.href, { waitUntil: 'domcontentloaded', timeout });
+        }
+        catch (error) {
+            if (session.navigationBlocked) {
+                throw new BrowserMcpError('NAVIGATION_BLOCKED', 'The navigation or one of its redirects was blocked by browser policy.');
+            }
+            throw error;
+        }
+        return pageState(session, timeout);
+    });
+}
+export async function browserCallTool(name, rawArgs, signal) {
+    try {
+        const args = objectArgs(rawArgs);
+        if (name === 'browser_open') {
+            const session = await openSession(args.sessionId, signal);
+            const timeout = timeoutMs(args.timeoutMs);
+            const data = typeof args.url === 'string' && args.url.length > 0
+                ? await navigate(session, args.url, timeout, signal)
+                : { success: true, ...publicPageState(session) };
+            return success(data);
+        }
+        if (name === 'browser_close') {
+            const sessionId = stringArg(args, 'sessionId', 64);
+            const closed = await closeSession(sessionId);
+            return success({ success: true, sessionId, closed });
+        }
+        const session = getSession(args.sessionId);
+        const timeout = timeoutMs(args.timeoutMs);
+        if (name === 'browser_navigate') {
+            return success(await navigate(session, stringArg(args, 'url', 8_192), timeout, signal));
+        }
+        if (name === 'browser_snapshot') {
+            return success(await runCancellable(session, signal, () => pageState(session, timeout)));
+        }
+        if (name === 'browser_click') {
+            const selector = stringArg(args, 'selector', MAX_SELECTOR_CHARS);
+            resetNavigationCounter(session);
+            const data = await runCancellable(session, signal, async () => {
+                await session.page.locator(selector).first().click({ timeout });
+                await session.page.waitForLoadState('domcontentloaded', { timeout }).catch(() => undefined);
+                if (session.navigationBlocked) {
+                    throw new BrowserMcpError('NAVIGATION_BLOCKED', 'The interaction attempted a navigation blocked by browser policy.');
+                }
+                return pageState(session, timeout);
+            });
+            return success(data);
+        }
+        if (name === 'browser_type') {
+            const selector = stringArg(args, 'selector', MAX_SELECTOR_CHARS);
+            const text = args.text;
+            if (typeof text !== 'string' || text.length > 100_000) {
+                throw new BrowserMcpError('INVALID_ARGUMENT', 'text must be a string no longer than 100000 characters.');
+            }
+            resetNavigationCounter(session);
+            const data = await runCancellable(session, signal, async () => {
+                const locator = session.page.locator(selector).first();
+                await locator.fill(text, { timeout });
+                if (args.submit === true)
+                    await locator.press('Enter', { timeout });
+                if (session.navigationBlocked) {
+                    throw new BrowserMcpError('NAVIGATION_BLOCKED', 'The interaction attempted a navigation blocked by browser policy.');
+                }
+                return pageState(session, timeout);
+            });
+            return success(data);
+        }
+        if (name === 'browser_screenshot') {
+            const png = await runCancellable(session, signal, () => session.page.screenshot({
+                type: 'png',
+                fullPage: args.fullPage === true,
+                timeout,
+            }));
+            if (png.length > MAX_SCREENSHOT_BYTES) {
+                throw new BrowserMcpError('INVALID_ARGUMENT', 'The screenshot exceeded the 5 MB artifact limit.');
+            }
+            const data = { success: true, ...publicPageState(session), mimeType: 'image/png', bytes: png.length };
+            return success(data, [{ type: 'image', data: png.toString('base64'), mimeType: 'image/png' }]);
+        }
+        return failure('NOT_FOUND', `Unknown browser tool: ${name}`);
+    }
+    catch (error) {
+        const normalized = normalizedError(error);
+        return failure(normalized.code, normalized.message);
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@mario.andreschak/mcp-browser",
+  "version": "3.39.0",
+  "description": "FLUJO's isolated Patchright browser MCP server",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "flujo-mcp-browser": "dist/index.js"
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "scripts": {
+    "install": "patchright install chromium",
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "patchright": "1.61.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.30",
+    "typescript": "^5.9.3"
+  }
+}