cloakbrowser-mcp 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cloakbrowser-mcp contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,141 @@
+# cloakbrowser-mcp
+
+<p align="center">
+  <img src="docs/assets/brand/logo-wordmark.svg" alt="CloakBrowser MCP" width="640" />
+</p>
+
+[![CI](https://github.com/swimmwatch/cloakbrowser-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/swimmwatch/cloakbrowser-mcp/actions/workflows/ci.yml)
+[![Actionlint](https://github.com/swimmwatch/cloakbrowser-mcp/actions/workflows/actionlint.yml/badge.svg)](https://github.com/swimmwatch/cloakbrowser-mcp/actions/workflows/actionlint.yml)
+[![CodeQL](https://github.com/swimmwatch/cloakbrowser-mcp/actions/workflows/codeql.yml/badge.svg)](https://github.com/swimmwatch/cloakbrowser-mcp/actions/workflows/codeql.yml)
+[![Dependency Review](https://github.com/swimmwatch/cloakbrowser-mcp/actions/workflows/dependency-review.yml/badge.svg)](https://github.com/swimmwatch/cloakbrowser-mcp/actions/workflows/dependency-review.yml)
+[![OpenSSF Scorecard](https://github.com/swimmwatch/cloakbrowser-mcp/actions/workflows/scorecard.yml/badge.svg)](https://github.com/swimmwatch/cloakbrowser-mcp/actions/workflows/scorecard.yml)
+[![Zizmor](https://github.com/swimmwatch/cloakbrowser-mcp/actions/workflows/zizmor.yml/badge.svg)](https://github.com/swimmwatch/cloakbrowser-mcp/actions/workflows/zizmor.yml)
+[![NPM Release](https://github.com/swimmwatch/cloakbrowser-mcp/actions/workflows/npm-release.yml/badge.svg)](https://github.com/swimmwatch/cloakbrowser-mcp/actions/workflows/npm-release.yml)
+[![Docker Release](https://github.com/swimmwatch/cloakbrowser-mcp/actions/workflows/docker-release.yml/badge.svg)](https://github.com/swimmwatch/cloakbrowser-mcp/actions/workflows/docker-release.yml)
+[![Docs Release](https://github.com/swimmwatch/cloakbrowser-mcp/actions/workflows/docs-release.yml/badge.svg)](https://github.com/swimmwatch/cloakbrowser-mcp/actions/workflows/docs-release.yml)
+[![npm](https://img.shields.io/npm/v/cloakbrowser-mcp.svg?logo=npm)](https://www.npmjs.com/package/cloakbrowser-mcp)
+[![Node.js >=20](https://img.shields.io/badge/Node.js-%3E%3D20-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
+[![MCP Server](https://img.shields.io/badge/MCP-server-000000)](https://modelcontextprotocol.io/)
+[![Docker](https://img.shields.io/badge/Docker-ready-2496ED?logo=docker&logoColor=white)](docs/docker.md)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+`cloakbrowser-mcp` is a stdio [Model Context Protocol](https://modelcontextprotocol.io/) browser automation server that runs upstream [`@playwright/mcp`](https://github.com/microsoft/playwright-mcp) with the [CloakBrowser](https://github.com/CloakHQ/CloakBrowser) Chromium binary. It provides Playwright MCP-compatible tools through a thin CloakBrowser bridge for npm and Docker users.
+
+Documentation: [swimmwatch.github.io/cloakbrowser-mcp](https://swimmwatch.github.io/cloakbrowser-mcp/)
+
+The server is intentionally thin:
+
+- upstream Playwright MCP owns browser tool schemas, descriptions, and responses;
+- this package generates a Playwright MCP config that points `launchOptions.executablePath` to CloakBrowser;
+- the bridge exposes upstream tools unchanged;
+- the only local tools are `cloakbrowser_binary_info` and `cloakbrowser_bridge_info`.
+
+## Version compatibility
+
+| cloakbrowser-mcp | @playwright/mcp | Playwright MCP Docker base | CloakBrowser | Node.js | Transport | Platform | Parity |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| `1.0.1` | `^0.0.75` | `mcr.microsoft.com/playwright/mcp:v0.0.75` | `^0.3.30` | `>=20` | stdio | `linux/amd64` Docker, Node.js local | Upstream default tools compared in CI. |
+| `1.0.0` | `^0.0.75` | `mcr.microsoft.com/playwright/mcp:v0.0.75` | `^0.3.30` | `>=20` | stdio | `linux/amd64` Docker, Node.js local | Upstream default tools compared in CI. |
+
+See [Version Compatibility](docs/version-compatibility.md) for the maintained compatibility table.
+
+## Run from npm
+
+```bash
+npx -y cloakbrowser-mcp@latest --help
+npx -y cloakbrowser-mcp@latest
+```
+
+Requires Node.js 20 or newer. The first real browser action may download the CloakBrowser binary unless it is already cached.
+
+## Run from Docker
+
+```bash
+docker pull ghcr.io/swimmwatch/cloakbrowser-mcp:latest
+docker run --rm --init -i \
+  -v "$PWD/artifacts:/data" \
+  ghcr.io/swimmwatch/cloakbrowser-mcp:latest
+```
+
+The Docker image is based on the pinned official Playwright MCP image, installs the bridge under `/opt/cloakbrowser-mcp`, and writes artifacts to `/data` by default.
+
+## MCP client configuration
+
+### npm
+
+```json
+{
+  "mcpServers": {
+    "cloakbrowser": {
+      "command": "npx",
+      "args": ["-y", "cloakbrowser-mcp@latest"],
+      "env": {
+        "PLAYWRIGHT_MCP_OUTPUT_DIR": "/tmp/cloakbrowser-artifacts",
+        "PLAYWRIGHT_MCP_HEADLESS": "true"
+      }
+    }
+  }
+}
+```
+
+### Docker
+
+```json
+{
+  "mcpServers": {
+    "cloakbrowser": {
+      "command": "docker",
+      "args": [
+        "run",
+        "--rm",
+        "--init",
+        "-i",
+        "-v",
+        "/tmp/cloakbrowser-artifacts:/data",
+        "ghcr.io/swimmwatch/cloakbrowser-mcp:latest"
+      ]
+    }
+  }
+}
+```
+
+## Configuration
+
+Use upstream `PLAYWRIGHT_MCP_*` variables for browser, artifact, timeout, network, and tool capability settings. Cloak-specific bridge toggles use `CLOAK_PLAYWRIGHT_MCP_*`.
+
+Common variables:
+
+| Variable | Default | Description |
+| --- | --- | --- |
+| `PLAYWRIGHT_MCP_BROWSER_ENGINE` | `cloak` | `cloak` uses CloakBrowser. `playwright` uses the upstream Playwright MCP browser runtime. |
+| `PLAYWRIGHT_MCP_HEADLESS` | `true` | Runs Chromium headless. |
+| `PLAYWRIGHT_MCP_OUTPUT_DIR` | `.playwright-mcp` | Artifact directory for npm usage. Docker defaults to `/data`. |
+| `PLAYWRIGHT_MCP_OUTPUT_MODE` | `stdout` | Upstream output mode, either `stdout` or `file`. |
+| `CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK` | `true` | Enables the compatibility patch for console messages. |
+| `CLOAK_PLAYWRIGHT_MCP_STEALTH_ARGS` | `true` | Adds CloakBrowser default stealth launch arguments. |
+| `CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS` | unset | Comma-separated or JSON array of extra Chromium launch arguments. |
+
+The old `CLOAKBROWSER_MCP_*` variables are not supported.
+
+## Tools
+
+The upstream Playwright MCP tool list is authoritative. This project does not reimplement or re-document upstream browser schemas in source code.
+
+Local tools:
+
+- `cloakbrowser_binary_info` returns CloakBrowser package, platform, cache, and resolved binary data.
+- `cloakbrowser_bridge_info` returns bridge metadata, upstream package/version, and local tool names.
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+npm run docker:build
+npm run docker:smoke
+npm run server:validate
+npm run bridge:compare -- cloakbrowser-mcp:dev --report bridge-parity-report.json
+```
+
+Documentation starts at [docs/getting-started.md](docs/getting-started.md). Contributor material is grouped under [docs/contributor-guide.md](docs/contributor-guide.md).

package/dist/bridge/config.d.ts

@@ -0,0 +1,36 @@
+import { binaryInfo } from 'cloakbrowser';
+import { type EnvReader } from './env.js';
+export type BrowserEngine = 'cloak' | 'playwright';
+export interface BridgeRuntime {
+    browserEngine: BrowserEngine;
+    configPath: string;
+    tempDir: string;
+    childEnv: Record<string, string>;
+    outputDir: string;
+    cloakBinaryPath?: string;
+    config: PlaywrightMcpBridgeConfig;
+    dispose(): void;
+}
+export interface PrepareBridgeRuntimeOptions {
+    env?: EnvReader;
+    tempRoot?: string;
+    ensureCloakBinary?: () => Promise<string>;
+}
+export interface PlaywrightMcpBridgeConfig {
+    browser?: {
+        browserName?: 'chromium';
+        launchOptions?: {
+            executablePath?: string;
+            headless?: boolean;
+            args?: string[];
+            chromiumSandbox?: boolean;
+            ignoreDefaultArgs?: string[];
+        };
+        initScript?: string[];
+    };
+}
+export declare function prepareBridgeRuntime(options?: PrepareBridgeRuntimeOptions): Promise<BridgeRuntime>;
+export declare function createLaunchArgs(env: EnvReader): string[];
+export declare function createChildEnv(env: EnvReader, outputDir: string): Record<string, string>;
+export declare function getCurrentCloakBinaryInfo(): ReturnType<typeof binaryInfo>;
+//# sourceMappingURL=config.d.ts.map

package/dist/bridge/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/bridge/config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAuC,MAAM,cAAc,CAAC;AAC/E,OAAO,EAAyD,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAIjG,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,YAAY,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,aAAa,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,yBAAyB,CAAC;IAClC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,2BAA2B;IAC1C,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,UAAU,CAAC;QACzB,aAAa,CAAC,EAAE;YACd,cAAc,CAAC,EAAE,MAAM,CAAC;YACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;YACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;YAChB,eAAe,CAAC,EAAE,OAAO,CAAC;YAC1B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;SAC9B,CAAC;QACF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;CACH;AAID,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,aAAa,CAAC,CAuDxB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,EAAE,CAQzD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYxF;AAED,wBAAgB,yBAAyB,IAAI,UAAU,CAAC,OAAO,UAAU,CAAC,CAEzE"}

package/dist/bridge/config.js

@@ -0,0 +1,105 @@
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { binaryInfo, ensureBinary, getDefaultStealthArgs } from 'cloakbrowser';
+import { appendNodeOption, envBool, envInt, envList, envString } from './env.js';
+import { resolvePlaywrightCoreBundlePath } from './paths.js';
+import { consoleFallbackInitScript, consoleFallbackPreloadScript } from '../runtime/consoleFallback.js';
+const ignoredAutomationArgs = ['--enable-automation', '--enable-unsafe-swiftshader'];
+export async function prepareBridgeRuntime(options = {}) {
+    const env = options.env ?? process.env;
+    const tempDir = mkdtempSync(path.join(options.tempRoot ?? tmpdir(), 'cloakbrowser-mcp-'));
+    const outputDir = envString(env, 'PLAYWRIGHT_MCP_OUTPUT_DIR', path.resolve('.playwright-mcp'));
+    mkdirSync(outputDir, { recursive: true });
+    const browserEngine = parseBrowserEngine(envString(env, 'PLAYWRIGHT_MCP_BROWSER_ENGINE', 'cloak'));
+    const childEnv = createChildEnv(env, outputDir);
+    const useCloak = browserEngine === 'cloak';
+    const launchOptions = {
+        headless: envBool(env, 'PLAYWRIGHT_MCP_HEADLESS', true),
+        args: useCloak ? createLaunchArgs(env) : envList(env, 'CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS'),
+        chromiumSandbox: useCloak ? !envBool(env, 'CLOAK_PLAYWRIGHT_MCP_NO_SANDBOX', true) : undefined,
+        ignoreDefaultArgs: useCloak ? ignoredAutomationArgs : undefined,
+    };
+    const config = {
+        browser: {
+            browserName: 'chromium',
+            launchOptions,
+        },
+    };
+    let cloakBinaryPath;
+    if (useCloak) {
+        cloakBinaryPath = await suppressStdout(options.ensureCloakBinary ?? ensureBinary);
+        config.browser.launchOptions.executablePath = cloakBinaryPath;
+        childEnv.PLAYWRIGHT_MCP_EXECUTABLE_PATH = cloakBinaryPath;
+        childEnv.CLOAKBROWSER_AUTO_UPDATE = childEnv.CLOAKBROWSER_AUTO_UPDATE ?? 'false';
+    }
+    if (useCloak && envBool(env, 'CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK', true)) {
+        const initScriptPath = path.join(tempDir, 'console-fallback-init.js');
+        const preloadPath = path.join(tempDir, 'console-fallback.cjs');
+        writeFileSync(initScriptPath, consoleFallbackInitScript);
+        writeFileSync(preloadPath, consoleFallbackPreloadScript(resolvePlaywrightCoreBundlePath()));
+        config.browser.initScript = [...(config.browser.initScript ?? []), initScriptPath];
+        childEnv.NODE_OPTIONS = appendNodeOption(childEnv.NODE_OPTIONS, `--require=${preloadPath}`);
+    }
+    const configPath = path.join(tempDir, 'playwright-mcp.config.json');
+    writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`);
+    childEnv.PLAYWRIGHT_MCP_CONFIG = configPath;
+    return {
+        browserEngine,
+        configPath,
+        tempDir,
+        childEnv,
+        outputDir,
+        cloakBinaryPath,
+        config,
+        dispose() {
+            rmSync(tempDir, { recursive: true, force: true });
+        },
+    };
+}
+export function createLaunchArgs(env) {
+    const args = new Set();
+    if (envBool(env, 'CLOAK_PLAYWRIGHT_MCP_STEALTH_ARGS', true)) {
+        for (const arg of getDefaultStealthArgs())
+            args.add(arg);
+    }
+    if (envBool(env, 'CLOAK_PLAYWRIGHT_MCP_NO_SANDBOX', true))
+        args.add('--no-sandbox');
+    for (const arg of envList(env, 'CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS'))
+        args.add(arg);
+    return [...args];
+}
+export function createChildEnv(env, outputDir) {
+    const result = {};
+    for (const [key, value] of Object.entries(env)) {
+        if (typeof value === 'string')
+            result[key] = value;
+    }
+    result.PLAYWRIGHT_MCP_HEADLESS = envString(env, 'PLAYWRIGHT_MCP_HEADLESS', 'true');
+    result.PLAYWRIGHT_MCP_OUTPUT_DIR = outputDir;
+    result.PLAYWRIGHT_MCP_OUTPUT_MODE = envString(env, 'PLAYWRIGHT_MCP_OUTPUT_MODE', 'stdout');
+    result.PLAYWRIGHT_MCP_TIMEOUT_ACTION = String(envInt(env, 'PLAYWRIGHT_MCP_TIMEOUT_ACTION', 5000));
+    result.PLAYWRIGHT_MCP_TIMEOUT_NAVIGATION = String(envInt(env, 'PLAYWRIGHT_MCP_TIMEOUT_NAVIGATION', 60000));
+    result.CLOAKBROWSER_AUTO_UPDATE = envString(env, 'CLOAKBROWSER_AUTO_UPDATE', 'false');
+    return result;
+}
+export function getCurrentCloakBinaryInfo() {
+    return binaryInfo();
+}
+function parseBrowserEngine(value) {
+    if (value === 'cloak' || value === 'playwright')
+        return value;
+    throw new Error(`PLAYWRIGHT_MCP_BROWSER_ENGINE must be "cloak" or "playwright", got "${value}"`);
+}
+async function suppressStdout(fn) {
+    const stdout = process.stdout;
+    const write = stdout.write.bind(stdout);
+    process.stdout.write = (() => true);
+    try {
+        return await fn();
+    }
+    finally {
+        process.stdout.write = write;
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/bridge/config.js.map

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

package/dist/bridge/env.d.ts

@@ -0,0 +1,7 @@
+export type EnvReader = Readonly<Record<string, string | undefined>>;
+export declare function envString(env: EnvReader, name: string, fallback: string): string;
+export declare function envBool(env: EnvReader, name: string, fallback: boolean): boolean;
+export declare function envInt(env: EnvReader, name: string, fallback: number): number;
+export declare function envList(env: EnvReader, name: string, fallback?: string): string[];
+export declare function appendNodeOption(existing: string | undefined, option: string): string;
+//# sourceMappingURL=env.d.ts.map

package/dist/bridge/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/bridge/env.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAErE,wBAAgB,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhF;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAIhF;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM7E;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAK,GAAG,MAAM,EAAE,CAc7E;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAErF"}

package/dist/bridge/env.js

@@ -0,0 +1,38 @@
+export function envString(env, name, fallback) {
+    return env[name] ?? fallback;
+}
+export function envBool(env, name, fallback) {
+    const value = env[name];
+    if (value === undefined)
+        return fallback;
+    return ['1', 'true', 'yes', 'on'].includes(value.toLowerCase());
+}
+export function envInt(env, name, fallback) {
+    const value = env[name];
+    if (value === undefined || value === '')
+        return fallback;
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isInteger(parsed))
+        throw new Error(`${name} must be an integer, got "${value}"`);
+    return parsed;
+}
+export function envList(env, name, fallback = '') {
+    const raw = env[name] ?? fallback;
+    if (!raw.trim())
+        return [];
+    if (raw.trim().startsWith('[')) {
+        const parsed = JSON.parse(raw);
+        if (!Array.isArray(parsed) || parsed.some((item) => typeof item !== 'string')) {
+            throw new Error(`${name} must be a JSON string array`);
+        }
+        return parsed;
+    }
+    return raw
+        .split(',')
+        .map((item) => item.trim())
+        .filter(Boolean);
+}
+export function appendNodeOption(existing, option) {
+    return existing ? `${existing} ${option}` : option;
+}
+//# sourceMappingURL=env.js.map

package/dist/bridge/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/bridge/env.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS,CAAC,GAAc,EAAE,IAAY,EAAE,QAAgB;IACtE,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAc,EAAE,IAAY,EAAE,QAAiB;IACrE,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;IACxB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACzC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAAc,EAAE,IAAY,EAAE,QAAgB;IACnE,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;IACxB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,QAAQ,CAAC;IACzD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,6BAA6B,KAAK,GAAG,CAAC,CAAC;IAC7F,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAc,EAAE,IAAY,EAAE,QAAQ,GAAG,EAAE;IACjE,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;IAClC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAC3B,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;YAC9E,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,8BAA8B,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,GAAG;SACP,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAA4B,EAAE,MAAc;IAC3E,OAAO,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;AACrD,CAAC"}

package/dist/bridge/paths.d.ts

@@ -0,0 +1,4 @@
+export declare function resolvePlaywrightMcpCliPath(): string;
+export declare function resolvePlaywrightCoreBundlePath(): string;
+export declare function currentModuleDir(metaUrl: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/bridge/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/bridge/paths.ts"],"names":[],"mappings":"AAOA,wBAAgB,2BAA2B,IAAI,MAAM,CAMpD;AAED,wBAAgB,+BAA+B,IAAI,MAAM,CAiBxD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/bridge/paths.js

@@ -0,0 +1,30 @@
+import { existsSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const requireFromHere = createRequire(import.meta.url);
+export function resolvePlaywrightMcpCliPath() {
+    if (process.env.PLAYWRIGHT_MCP_CLI_PATH)
+        return process.env.PLAYWRIGHT_MCP_CLI_PATH;
+    if (existsSync('/app/cli.js'))
+        return '/app/cli.js';
+    const packageJson = requireFromHere.resolve('@playwright/mcp/package.json');
+    return path.join(path.dirname(packageJson), 'cli.js');
+}
+export function resolvePlaywrightCoreBundlePath() {
+    if (process.env.CLOAK_PLAYWRIGHT_MCP_CORE_BUNDLE_PATH) {
+        return process.env.CLOAK_PLAYWRIGHT_MCP_CORE_BUNDLE_PATH;
+    }
+    if (existsSync('/app/node_modules/playwright-core/lib/coreBundle.js')) {
+        return '/app/node_modules/playwright-core/lib/coreBundle';
+    }
+    const packageJson = requireFromHere.resolve('@playwright/mcp/package.json');
+    const nestedCoreBundle = path.join(path.dirname(packageJson), 'node_modules', 'playwright-core', 'lib', 'coreBundle');
+    if (existsSync(`${nestedCoreBundle}.js`))
+        return nestedCoreBundle;
+    return requireFromHere.resolve('playwright-core/lib/coreBundle');
+}
+export function currentModuleDir(metaUrl) {
+    return path.dirname(fileURLToPath(metaUrl));
+}
+//# sourceMappingURL=paths.js.map

package/dist/bridge/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/bridge/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEvD,MAAM,UAAU,2BAA2B;IACzC,IAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB;QAAE,OAAO,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IACpF,IAAI,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,aAAa,CAAC;IAEpD,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAC5E,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,+BAA+B;IAC7C,IAAI,OAAO,CAAC,GAAG,CAAC,qCAAqC,EAAE,CAAC;QACtD,OAAO,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC;IAC3D,CAAC;IACD,IAAI,UAAU,CAAC,qDAAqD,CAAC,EAAE,CAAC;QACtE,OAAO,kDAAkD,CAAC;IAC5D,CAAC;IACD,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC;IAC5E,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAChC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EACzB,cAAc,EACd,iBAAiB,EACjB,KAAK,EACL,YAAY,CACb,CAAC;IACF,IAAI,UAAU,CAAC,GAAG,gBAAgB,KAAK,CAAC;QAAE,OAAO,gBAAgB,CAAC;IAClE,OAAO,eAAe,CAAC,OAAO,CAAC,gCAAgC,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/bridge/tools.d.ts

@@ -0,0 +1,8 @@
+import type { CallToolResult, Tool } from '@modelcontextprotocol/sdk/types.js';
+import { type BridgeRuntime } from './config.js';
+export declare const localToolNames: readonly ["cloakbrowser_binary_info", "cloakbrowser_bridge_info"];
+export type LocalToolName = (typeof localToolNames)[number];
+export declare function createLocalTools(): Tool[];
+export declare function isLocalTool(name: string): name is LocalToolName;
+export declare function callLocalTool(name: LocalToolName, runtime: BridgeRuntime, upstreamToolCount: number): CallToolResult;
+//# sourceMappingURL=tools.d.ts.map

package/dist/bridge/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/bridge/tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAA6B,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAS5E,eAAO,MAAM,cAAc,mEAAoE,CAAC;AAGhG,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAiC5D,wBAAgB,gBAAgB,IAAI,IAAI,EAAE,CAEzC;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,aAAa,CAE/D;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,aAAa,EACtB,iBAAiB,EAAE,MAAM,GACxB,cAAc,CA0BhB"}

package/dist/bridge/tools.js

@@ -0,0 +1,72 @@
+import { getCurrentCloakBinaryInfo } from './config.js';
+import { CLOAKBROWSER_TOOL_COUNT, PLAYWRIGHT_MCP_BROWSER_TOOL_COUNT, PLAYWRIGHT_MCP_PACKAGE, PLAYWRIGHT_MCP_VERSION, PROJECT_METADATA, } from '../project/metadata.js';
+export const localToolNames = ['cloakbrowser_binary_info', 'cloakbrowser_bridge_info'];
+const localToolNameSet = new Set(localToolNames);
+const emptyInputSchema = {
+    type: 'object',
+    properties: {},
+    additionalProperties: false,
+};
+const localTools = [
+    {
+        name: 'cloakbrowser_binary_info',
+        title: 'CloakBrowser binary info',
+        description: 'Return CloakBrowser package, cache, platform, and resolved browser binary information.',
+        inputSchema: emptyInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    {
+        name: 'cloakbrowser_bridge_info',
+        title: 'CloakBrowser bridge info',
+        description: 'Return runtime metadata for the CloakBrowser bridge over upstream Playwright MCP.',
+        inputSchema: emptyInputSchema,
+        annotations: {
+            readOnlyHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+];
+export function createLocalTools() {
+    return localTools;
+}
+export function isLocalTool(name) {
+    return localToolNameSet.has(name);
+}
+export function callLocalTool(name, runtime, upstreamToolCount) {
+    if (name === 'cloakbrowser_binary_info') {
+        return jsonResult({
+            browserEngine: runtime.browserEngine,
+            executablePath: runtime.cloakBinaryPath ?? null,
+            outputDir: runtime.outputDir,
+            binary: getCurrentCloakBinaryInfo(),
+        });
+    }
+    return jsonResult({
+        name: PROJECT_METADATA.mcpName,
+        title: PROJECT_METADATA.title,
+        version: PROJECT_METADATA.version,
+        runtime: 'playwright-mcp-bridge',
+        browserEngine: runtime.browserEngine,
+        upstream: {
+            package: PLAYWRIGHT_MCP_PACKAGE,
+            version: PLAYWRIGHT_MCP_VERSION,
+            toolCount: upstreamToolCount || PLAYWRIGHT_MCP_BROWSER_TOOL_COUNT,
+        },
+        localTools: {
+            toolCount: CLOAKBROWSER_TOOL_COUNT,
+            names: localToolNames,
+        },
+    });
+}
+function jsonResult(value) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(value, null, 2) }],
+        structuredContent: value,
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/bridge/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/bridge/tools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAsB,MAAM,aAAa,CAAC;AAC5E,OAAO,EACL,uBAAuB,EACvB,iCAAiC,EACjC,sBAAsB,EACtB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,0BAA0B,EAAE,0BAA0B,CAAU,CAAC;AAChG,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAS,cAAc,CAAC,CAAC;AAIzD,MAAM,gBAAgB,GAAG;IACvB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE,EAAE;IACd,oBAAoB,EAAE,KAAK;CACnB,CAAC;AAEX,MAAM,UAAU,GAAW;IACzB;QACE,IAAI,EAAE,0BAA0B;QAChC,KAAK,EAAE,0BAA0B;QACjC,WAAW,EAAE,wFAAwF;QACrG,WAAW,EAAE,gBAAgB;QAC7B,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF;IACD;QACE,IAAI,EAAE,0BAA0B;QAChC,KAAK,EAAE,0BAA0B;QACjC,WAAW,EAAE,mFAAmF;QAChG,WAAW,EAAE,gBAAgB;QAC7B,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;KACF;CACF,CAAC;AAEF,MAAM,UAAU,gBAAgB;IAC9B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,IAAmB,EACnB,OAAsB,EACtB,iBAAyB;IAEzB,IAAI,IAAI,KAAK,0BAA0B,EAAE,CAAC;QACxC,OAAO,UAAU,CAAC;YAChB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,cAAc,EAAE,OAAO,CAAC,eAAe,IAAI,IAAI;YAC/C,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE,yBAAyB,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,UAAU,CAAC;QAChB,IAAI,EAAE,gBAAgB,CAAC,OAAO;QAC9B,KAAK,EAAE,gBAAgB,CAAC,KAAK;QAC7B,OAAO,EAAE,gBAAgB,CAAC,OAAO;QACjC,OAAO,EAAE,uBAAuB;QAChC,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,QAAQ,EAAE;YACR,OAAO,EAAE,sBAAsB;YAC/B,OAAO,EAAE,sBAAsB;YAC/B,SAAS,EAAE,iBAAiB,IAAI,iCAAiC;SAClE;QACD,UAAU,EAAE;YACV,SAAS,EAAE,uBAAuB;YAClC,KAAK,EAAE,cAAc;SACtB;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,KAA8B;IAChD,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACjE,iBAAiB,EAAE,KAAK;KACzB,CAAC;AACJ,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+import { readFileSync } from 'node:fs';
+import process from 'node:process';
+import { PROJECT_METADATA } from './project/metadata.js';
+import { startBridge } from './server.js';
+const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+const help = `cloakbrowser-mcp ${pkg.version}
+
+Playwright MCP bridge backed by CloakBrowser.
+
+Usage:
+  cloakbrowser-mcp
+  cloakbrowser-mcp --help
+  cloakbrowser-mcp --version
+
+Primary configuration is provided with PLAYWRIGHT_MCP_* environment variables.
+Cloak-specific toggles use CLOAK_PLAYWRIGHT_MCP_*.
+
+Common environment variables:
+  PLAYWRIGHT_MCP_BROWSER_ENGINE        cloak | playwright (default: cloak)
+  PLAYWRIGHT_MCP_HEADLESS              true | false (default: true)
+  PLAYWRIGHT_MCP_OUTPUT_DIR            artifact directory (default: .playwright-mcp)
+  PLAYWRIGHT_MCP_OUTPUT_MODE           stdout | file (default: stdout)
+  PLAYWRIGHT_MCP_VIEWPORT_SIZE         WIDTHxHEIGHT
+  PLAYWRIGHT_MCP_TIMEOUT_ACTION        action timeout ms (default: 5000)
+  PLAYWRIGHT_MCP_TIMEOUT_NAVIGATION    navigation timeout ms (default: 60000)
+  CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK true | false (default: true)
+  CLOAK_PLAYWRIGHT_MCP_STEALTH_ARGS    true | false (default: true)
+  CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS      comma-separated or JSON array Chromium args
+`;
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.includes('--help') || args.includes('-h')) {
+        process.stdout.write(help);
+        return;
+    }
+    if (args.includes('--version') || args.includes('-V')) {
+        process.stdout.write(`${pkg.version}\n`);
+        return;
+    }
+    const bridge = await startBridge({
+        serverInfo: {
+            name: PROJECT_METADATA.mcpName,
+            title: PROJECT_METADATA.title,
+            version: pkg.version,
+            description: PROJECT_METADATA.description,
+            websiteUrl: PROJECT_METADATA.websiteUrl,
+            icons: PROJECT_METADATA.icons,
+        },
+    });
+    for (const signal of ['SIGINT', 'SIGTERM']) {
+        process.once(signal, () => {
+            void bridge.dispose().finally(() => process.exit(0));
+        });
+    }
+}
+void main().catch((error) => {
+    process.stderr.write(`fatal: ${error.message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAEvF,CAAC;AAEF,MAAM,IAAI,GAAG,oBAAoB,GAAG,CAAC,OAAO;;;;;;;;;;;;;;;;;;;;;;;CAuB3C,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;QACzC,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC;QAC/B,UAAU,EAAE;YACV,IAAI,EAAE,gBAAgB,CAAC,OAAO;YAC9B,KAAK,EAAE,gBAAgB,CAAC,KAAK;YAC7B,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,WAAW,EAAE,gBAAgB,CAAC,WAAW;YACzC,UAAU,EAAE,gBAAgB,CAAC,UAAU;YACvC,KAAK,EAAE,gBAAgB,CAAC,KAAK;SAC9B;KACF,CAAC,CAAC;IAEH,KAAK,MAAM,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAU,EAAE,CAAC;QACpD,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;YACxB,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAW,KAAe,CAAC,OAAO,IAAI,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { PROJECT_METADATA } from './project/metadata.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { PROJECT_METADATA } from './project/metadata.js';
+//# 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,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/project/metadata.d.ts

@@ -0,0 +1,20 @@
+export declare const PLAYWRIGHT_MCP_PACKAGE = "@playwright/mcp";
+export declare const PLAYWRIGHT_MCP_VERSION: string;
+export declare const PLAYWRIGHT_MCP_BROWSER_TOOL_COUNT = 23;
+export declare const CLOAKBROWSER_TOOL_COUNT = 2;
+export declare const PROJECT_METADATA: Readonly<{
+    packageName: string;
+    version: string;
+    license: string;
+    mcpName: string;
+    title: "CloakBrowser MCP";
+    description: string;
+    websiteUrl: "https://swimmwatch.github.io/cloakbrowser-mcp/";
+    icons: {
+        src: string;
+        mimeType: string;
+        sizes: string[];
+    }[];
+}>;
+export declare const MCP_SERVER_INSTRUCTIONS: string;
+//# sourceMappingURL=metadata.d.ts.map

package/dist/project/metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../src/project/metadata.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,sBAAsB,oBAAoB,CAAC;AACxD,eAAO,MAAM,sBAAsB,QAAgD,CAAC;AACpF,eAAO,MAAM,iCAAiC,KAAK,CAAC;AACpD,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;EAiB3B,CAAC;AAEH,eAAO,MAAM,uBAAuB,QAIzB,CAAC"}

package/dist/project/metadata.js

@@ -0,0 +1,36 @@
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+const packageMetadata = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8'));
+const requireFromHere = createRequire(import.meta.url);
+export const PLAYWRIGHT_MCP_PACKAGE = '@playwright/mcp';
+export const PLAYWRIGHT_MCP_VERSION = readDependencyVersion(PLAYWRIGHT_MCP_PACKAGE);
+export const PLAYWRIGHT_MCP_BROWSER_TOOL_COUNT = 23;
+export const CLOAKBROWSER_TOOL_COUNT = 2;
+export const PROJECT_METADATA = Object.freeze({
+    packageName: packageMetadata.name,
+    version: packageMetadata.version,
+    license: packageMetadata.license ?? 'MIT',
+    mcpName: packageMetadata.mcpName ?? 'io.github.swimmwatch/cloakbrowser-mcp',
+    title: 'CloakBrowser MCP',
+    description: packageMetadata.description ??
+        'Playwright MCP bridge that runs upstream browser tools with the CloakBrowser Chromium binary.',
+    websiteUrl: 'https://swimmwatch.github.io/cloakbrowser-mcp/',
+    icons: [
+        {
+            src: 'https://swimmwatch.github.io/cloakbrowser-mcp/assets/brand/logo.svg',
+            mimeType: 'image/svg+xml',
+            sizes: ['any'],
+        },
+    ],
+});
+export const MCP_SERVER_INSTRUCTIONS = [
+    'This server forwards upstream Playwright MCP browser tools and runs them with CloakBrowser by default.',
+    'Use browser_snapshot before interacting with unfamiliar pages.',
+    'Use cloakbrowser_bridge_info and cloakbrowser_binary_info for bridge diagnostics.',
+].join(' ');
+function readDependencyVersion(packageName) {
+    const packageJson = requireFromHere.resolve(`${packageName}/package.json`);
+    const metadata = JSON.parse(readFileSync(packageJson, 'utf8'));
+    return metadata.version ?? 'unknown';
+}
+//# sourceMappingURL=metadata.js.map

package/dist/project/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/project/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAU5C,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAChC,YAAY,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAClD,CAAC;AACrB,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEvD,MAAM,CAAC,MAAM,sBAAsB,GAAG,iBAAiB,CAAC;AACxD,MAAM,CAAC,MAAM,sBAAsB,GAAG,qBAAqB,CAAC,sBAAsB,CAAC,CAAC;AACpF,MAAM,CAAC,MAAM,iCAAiC,GAAG,EAAE,CAAC;AACpD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAEzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5C,WAAW,EAAE,eAAe,CAAC,IAAI;IACjC,OAAO,EAAE,eAAe,CAAC,OAAO;IAChC,OAAO,EAAE,eAAe,CAAC,OAAO,IAAI,KAAK;IACzC,OAAO,EAAE,eAAe,CAAC,OAAO,IAAI,uCAAuC;IAC3E,KAAK,EAAE,kBAAkB;IACzB,WAAW,EACT,eAAe,CAAC,WAAW;QAC3B,+FAA+F;IACjG,UAAU,EAAE,gDAAgD;IAC5D,KAAK,EAAE;QACL;YACE,GAAG,EAAE,qEAAqE;YAC1E,QAAQ,EAAE,eAAe;YACzB,KAAK,EAAE,CAAC,KAAK,CAAC;SACf;KACF;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,wGAAwG;IACxG,gEAAgE;IAChE,mFAAmF;CACpF,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,SAAS,qBAAqB,CAAC,WAAmB;IAChD,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,WAAW,eAAe,CAAC,CAAC;IAC3E,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAyB,CAAC;IACvF,OAAO,QAAQ,CAAC,OAAO,IAAI,SAAS,CAAC;AACvC,CAAC"}

package/dist/runtime/consoleFallback.d.ts

@@ -0,0 +1,3 @@
+export declare const consoleFallbackInitScript = "(() => {\n  const messages = [];\n  Object.defineProperty(globalThis, '__cloakMcpConsoleMessages', {\n    value: messages,\n    configurable: true,\n  });\n\n  const methods = {\n    debug: 'debug',\n    error: 'error',\n    info: 'info',\n    log: 'log',\n    warn: 'warning',\n  };\n\n  const formatValue = (value) => {\n    if (typeof value === 'string') return value;\n    try {\n      return JSON.stringify(value);\n    } catch {\n      return String(value);\n    }\n  };\n\n  const sourceLocation = () => {\n    const stack = new Error().stack ?? '';\n    for (const line of stack.split('\\n')) {\n      const match = /((?:https?|file):[^)\\s]+):(\\d+):(\\d+)/.exec(line);\n      if (match) return { url: match[1], lineNumber: Math.max(Number(match[2]) - 1, 0) };\n    }\n    return { url: location.href, lineNumber: 0 };\n  };\n\n  for (const [method, type] of Object.entries(methods)) {\n    const original = console[method]?.bind(console);\n    if (!original) continue;\n    console[method] = (...args) => {\n      const entry = sourceLocation();\n      messages.push({\n        type,\n        text: args.map(formatValue).join(' '),\n        timestamp: Date.now(),\n        url: entry.url,\n        lineNumber: entry.lineNumber,\n      });\n      return original(...args);\n    };\n  }\n})();";
+export declare function consoleFallbackPreloadScript(coreBundlePath: string): string;
+//# sourceMappingURL=consoleFallback.d.ts.map

package/dist/runtime/consoleFallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consoleFallback.d.ts","sourceRoot":"","sources":["../../src/runtime/consoleFallback.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,0xCAgDhC,CAAC;AAEP,wBAAgB,4BAA4B,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CA2E3E"}

package/dist/runtime/consoleFallback.js

@@ -0,0 +1,126 @@
+export const consoleFallbackInitScript = `(() => {
+  const messages = [];
+  Object.defineProperty(globalThis, '__cloakMcpConsoleMessages', {
+    value: messages,
+    configurable: true,
+  });
+
+  const methods = {
+    debug: 'debug',
+    error: 'error',
+    info: 'info',
+    log: 'log',
+    warn: 'warning',
+  };
+
+  const formatValue = (value) => {
+    if (typeof value === 'string') return value;
+    try {
+      return JSON.stringify(value);
+    } catch {
+      return String(value);
+    }
+  };
+
+  const sourceLocation = () => {
+    const stack = new Error().stack ?? '';
+    for (const line of stack.split('\\n')) {
+      const match = /((?:https?|file):[^)\\s]+):(\\d+):(\\d+)/.exec(line);
+      if (match) return { url: match[1], lineNumber: Math.max(Number(match[2]) - 1, 0) };
+    }
+    return { url: location.href, lineNumber: 0 };
+  };
+
+  for (const [method, type] of Object.entries(methods)) {
+    const original = console[method]?.bind(console);
+    if (!original) continue;
+    console[method] = (...args) => {
+      const entry = sourceLocation();
+      messages.push({
+        type,
+        text: args.map(formatValue).join(' '),
+        timestamp: Date.now(),
+        url: entry.url,
+        lineNumber: entry.lineNumber,
+      });
+      return original(...args);
+    };
+  }
+})();`;
+export function consoleFallbackPreloadScript(coreBundlePath) {
+    return `'use strict';
+
+if (process.env.CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK !== 'false') {
+  const { tools } = require(${JSON.stringify(coreBundlePath)});
+  const originalCount = tools.Tab.prototype.consoleMessageCount;
+  const originalMessages = tools.Tab.prototype.consoleMessages;
+  const originalClear = tools.Tab.prototype.clearConsoleMessages;
+
+  tools.Tab.prototype.consoleMessageCount = async function consoleMessageCount() {
+    const nativeCount = await originalCount.call(this);
+    if (nativeCount.total > 0) return nativeCount;
+    if (hasModalState(this)) return nativeCount;
+    const messages = await readMessages(this.page);
+    return {
+      total: messages.length,
+      errors: messages.filter((message) => message.type === 'error').length,
+      warnings: messages.filter((message) => message.type === 'warning').length,
+    };
+  };
+
+  tools.Tab.prototype.consoleMessages = async function consoleMessages(level, all) {
+    const nativeMessages = await originalMessages.call(this, level, all);
+    if (nativeMessages.length > 0) return nativeMessages;
+    if (hasModalState(this)) return nativeMessages;
+    const messages = await readMessages(this.page);
+    return messages.filter((message) => includesLevel(level, message.type)).map(toConsoleMessage);
+  };
+
+  tools.Tab.prototype.clearConsoleMessages = async function clearConsoleMessages() {
+    await originalClear.call(this);
+    await this.page
+      .evaluate(() => {
+        if (Array.isArray(globalThis.__cloakMcpConsoleMessages)) {
+          globalThis.__cloakMcpConsoleMessages.length = 0;
+        }
+      })
+      .catch(() => undefined);
+  };
+}
+
+function hasModalState(tab) {
+  return Array.isArray(tab._modalStates) && tab._modalStates.length > 0;
+}
+
+async function readMessages(page) {
+  return page
+    .evaluate(() => {
+      const messages = globalThis.__cloakMcpConsoleMessages;
+      return Array.isArray(messages) ? messages : [];
+    })
+    .catch(() => []);
+}
+
+function toConsoleMessage(message) {
+  return {
+    type: message.type,
+    timestamp: message.timestamp,
+    text: message.text,
+    toString: () => \`[\${message.type.toUpperCase()}] \${message.text} @ \${message.url}:\${message.lineNumber}\`,
+  };
+}
+
+function includesLevel(level, type) {
+  const levels = ['error', 'warning', 'info', 'debug'];
+  return levels.indexOf(levelForType(type)) <= levels.indexOf(level ?? 'info');
+}
+
+function levelForType(type) {
+  if (type === 'error' || type === 'assert') return 'error';
+  if (type === 'warning') return 'warning';
+  if (type === 'debug') return 'debug';
+  return 'info';
+}
+`;
+}
+//# sourceMappingURL=consoleFallback.js.map

package/dist/runtime/consoleFallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consoleFallback.js","sourceRoot":"","sources":["../../src/runtime/consoleFallback.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAgDnC,CAAC;AAEP,MAAM,UAAU,4BAA4B,CAAC,cAAsB;IACjE,OAAO;;;8BAGqB,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsE3D,CAAC;AACF,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,21 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
+import { type Implementation } from '@modelcontextprotocol/sdk/types.js';
+import { type BridgeRuntime } from './bridge/config.js';
+export interface StartBridgeOptions {
+    serverInfo?: Partial<Implementation>;
+}
+export interface BridgeServerOptions extends StartBridgeOptions {
+    runtime?: BridgeRuntime;
+    upstreamClient?: Client;
+}
+export interface BridgeServer {
+    server: Server;
+    runtime: BridgeRuntime;
+    start(transport?: Transport): Promise<void>;
+    dispose(): Promise<void>;
+}
+export declare function startBridge(options?: StartBridgeOptions): Promise<BridgeServer>;
+export declare function createBridgeServer(options?: BridgeServerOptions): Promise<BridgeServer>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EAGL,KAAK,cAAc,EAIpB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAK9E,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,wBAAsB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC,CAIzF;AAED,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC,CAwCjG"}

package/dist/server.js

@@ -0,0 +1,90 @@
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { prepareBridgeRuntime } from './bridge/config.js';
+import { resolvePlaywrightMcpCliPath } from './bridge/paths.js';
+import { callLocalTool, createLocalTools, isLocalTool } from './bridge/tools.js';
+import { MCP_SERVER_INSTRUCTIONS, PROJECT_METADATA } from './project/metadata.js';
+export async function startBridge(options = {}) {
+    const bridge = await createBridgeServer(options);
+    await bridge.start();
+    return bridge;
+}
+export async function createBridgeServer(options = {}) {
+    const runtime = options.runtime ?? (await prepareBridgeRuntime());
+    const upstreamClient = options.upstreamClient ?? (await connectUpstream(runtime));
+    const localTools = createLocalTools();
+    const upstreamToolCache = new Map();
+    let upstreamToolCount = 0;
+    const server = new Server(createServerInfo(options.serverInfo), {
+        capabilities: { tools: {} },
+        instructions: MCP_SERVER_INSTRUCTIONS,
+    });
+    server.setRequestHandler(ListToolsRequestSchema, async (request) => {
+        const upstream = await listUpstreamTools(upstreamClient, upstreamToolCache, request.params);
+        upstreamToolCount = Math.max(upstreamToolCount, upstream.tools.length);
+        if (request.params?.cursor)
+            return upstream;
+        return {
+            ...upstream,
+            tools: [...upstream.tools, ...localTools],
+        };
+    });
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        if (isLocalTool(request.params.name)) {
+            return callLocalTool(request.params.name, runtime, upstreamToolCount);
+        }
+        return (await upstreamClient.callTool(request.params));
+    });
+    return {
+        server,
+        runtime,
+        async start(transport) {
+            await server.connect(transport ?? new StdioServerTransport());
+        },
+        async dispose() {
+            await Promise.allSettled([upstreamClient.close(), server.close()]);
+            runtime.dispose();
+        },
+    };
+}
+function listUpstreamTools(upstreamClient, cache, params) {
+    const cacheKey = params?.cursor ?? '';
+    const cached = cache.get(cacheKey);
+    if (cached)
+        return cached;
+    const pending = upstreamClient.listTools(params).then((result) => result, (error) => {
+        cache.delete(cacheKey);
+        throw error;
+    });
+    cache.set(cacheKey, pending);
+    return pending;
+}
+async function connectUpstream(runtime) {
+    const transport = new StdioClientTransport({
+        command: process.execPath,
+        args: [resolvePlaywrightMcpCliPath(), '--config', runtime.configPath],
+        env: runtime.childEnv,
+        stderr: 'inherit',
+    });
+    const client = new Client({
+        name: `${PROJECT_METADATA.mcpName}-upstream-client`,
+        version: PROJECT_METADATA.version,
+    });
+    await client.connect(transport);
+    return client;
+}
+function createServerInfo(serverInfo) {
+    return {
+        name: PROJECT_METADATA.mcpName,
+        title: PROJECT_METADATA.title,
+        version: PROJECT_METADATA.version,
+        description: PROJECT_METADATA.description,
+        websiteUrl: PROJECT_METADATA.websiteUrl,
+        icons: PROJECT_METADATA.icons,
+        ...serverInfo,
+    };
+}
+//# 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/package.json

@@ -0,0 +1,97 @@
+{
+  "name": "cloakbrowser-mcp",
+  "version": "1.0.1",
+  "description": "Playwright MCP bridge that runs upstream browser tools with CloakBrowser.",
+  "mcpName": "io.github.swimmwatch/cloakbrowser-mcp",
+  "type": "module",
+  "packageManager": "npm@10.9.2",
+  "license": "MIT",
+  "author": "swimmwatch",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "exports": {
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "cloakbrowser-mcp": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "server.json"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist coverage",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:unit": "vitest run tests/unit",
+    "test:integration": "vitest run tests/integration",
+    "test:coverage": "vitest run --coverage",
+    "start": "node dist/cli.js",
+    "dev": "tsx src/cli.ts",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "docs:install": "python3 -m venv .venv-docs && .venv-docs/bin/pip install -r docs/requirements.txt",
+    "docs:assets": "node scripts/generate-brand-assets.mjs",
+    "docs:serve": ".venv-docs/bin/mkdocs serve",
+    "docs:build": ".venv-docs/bin/mkdocs build --strict",
+    "docs:seo:validate": "node scripts/validate-docs-seo.mjs",
+    "version:apply": "node scripts/apply-release-version.mjs",
+    "server:validate": "node scripts/validate-server-json.mjs",
+    "audit:prod": "npm audit --omit=dev --audit-level=high",
+    "package:verify": "npm run build && npm run server:validate && node scripts/verify-npm-package.mjs",
+    "docker:build": "docker buildx build --load -t cloakbrowser-mcp:dev --build-arg RELEASE_VERSION=$npm_package_version --build-arg RELEASE_VERSION_TAG=v$npm_package_version .",
+    "docker:smoke": "docker run --rm --init cloakbrowser-mcp:dev --help",
+    "bridge:compare": "node scripts/compare-playwright-mcp-bridge.mjs",
+    "upstream:check": "node scripts/check-playwright-mcp-updates.mjs",
+    "check": "npm run typecheck && npm run lint && npm run format:check && npm run server:validate && npm run build && npm test",
+    "check:ci": "npm run check && npm run audit:prod && npm run test:coverage"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.18.0",
+    "@playwright/mcp": "^0.0.75",
+    "cloakbrowser": "^0.3.30"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.13.0",
+    "@types/node": "^20.14.0",
+    "@vitest/coverage-v8": "^2.1.9",
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "eslint": "^9.13.0",
+    "eslint-config-prettier": "^9.1.0",
+    "prettier": "^3.3.3",
+    "tsx": "^4.19.0",
+    "typescript": "^5.5.4",
+    "typescript-eslint": "^8.11.0",
+    "vitest": "^2.0.5"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "cloakbrowser",
+    "browser-automation",
+    "playwright",
+    "stealth",
+    "ai-agent"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/swimmwatch/cloakbrowser-mcp.git"
+  },
+  "homepage": "https://swimmwatch.github.io/cloakbrowser-mcp/",
+  "bugs": {
+    "url": "https://github.com/swimmwatch/cloakbrowser-mcp/issues"
+  }
+}

package/server.json

@@ -0,0 +1,112 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.swimmwatch/cloakbrowser-mcp",
+  "title": "CloakBrowser MCP",
+  "description": "Playwright MCP bridge that runs upstream browser tools with the CloakBrowser Chromium binary.",
+  "version": "1.0.1",
+  "websiteUrl": "https://swimmwatch.github.io/cloakbrowser-mcp/",
+  "repository": {
+    "url": "https://github.com/swimmwatch/cloakbrowser-mcp",
+    "source": "github"
+  },
+  "icons": [
+    {
+      "src": "https://swimmwatch.github.io/cloakbrowser-mcp/assets/brand/logo.svg",
+      "mimeType": "image/svg+xml",
+      "sizes": ["any"]
+    }
+  ],
+  "packages": [
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "cloakbrowser-mcp",
+      "version": "1.0.1",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "PLAYWRIGHT_MCP_BROWSER_ENGINE",
+          "description": "Bridge browser engine: cloak or playwright.",
+          "format": "string",
+          "default": "cloak"
+        },
+        {
+          "name": "PLAYWRIGHT_MCP_HEADLESS",
+          "description": "Run the browser in headless mode.",
+          "format": "boolean",
+          "default": "true"
+        },
+        {
+          "name": "PLAYWRIGHT_MCP_OUTPUT_DIR",
+          "description": "Directory where upstream Playwright MCP writes artifacts.",
+          "format": "filepath",
+          "default": ".playwright-mcp"
+        },
+        {
+          "name": "PLAYWRIGHT_MCP_OUTPUT_MODE",
+          "description": "Return snapshots, console logs, and network logs through stdout or files.",
+          "format": "string",
+          "default": "stdout"
+        },
+        {
+          "name": "CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK",
+          "description": "Patch upstream console message collection for CloakBrowser compatibility.",
+          "format": "boolean",
+          "default": "true"
+        },
+        {
+          "name": "CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS",
+          "description": "Comma-separated or JSON array of extra Chromium launch arguments.",
+          "format": "string"
+        }
+      ]
+    },
+    {
+      "registryType": "oci",
+      "registryBaseUrl": "https://ghcr.io",
+      "identifier": "ghcr.io/swimmwatch/cloakbrowser-mcp:1.0.1",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "PLAYWRIGHT_MCP_BROWSER_ENGINE",
+          "description": "Bridge browser engine: cloak or playwright.",
+          "format": "string",
+          "default": "cloak"
+        },
+        {
+          "name": "PLAYWRIGHT_MCP_HEADLESS",
+          "description": "Run the browser in headless mode.",
+          "format": "boolean",
+          "default": "true"
+        },
+        {
+          "name": "PLAYWRIGHT_MCP_OUTPUT_DIR",
+          "description": "Directory inside the container where upstream Playwright MCP writes artifacts.",
+          "format": "filepath",
+          "default": "/data"
+        },
+        {
+          "name": "PLAYWRIGHT_MCP_OUTPUT_MODE",
+          "description": "Return snapshots, console logs, and network logs through stdout or files.",
+          "format": "string",
+          "default": "stdout"
+        },
+        {
+          "name": "CLOAK_PLAYWRIGHT_MCP_CONSOLE_FALLBACK",
+          "description": "Patch upstream console message collection for CloakBrowser compatibility.",
+          "format": "boolean",
+          "default": "true"
+        },
+        {
+          "name": "CLOAK_PLAYWRIGHT_MCP_EXTRA_ARGS",
+          "description": "Comma-separated or JSON array of extra Chromium launch arguments.",
+          "format": "string"
+        }
+      ]
+    }
+  ]
+}