@vibebrowser/chrome-devtools-mcp 0.26.1 → 0.26.3

package/README.md

@@ -1,6 +1,67 @@
-# Chrome DevTools for Agents
+# Chrome DevTools MCP — Multi-Agent Fork
 
-[![npm chrome-devtools-mcp package](https://img.shields.io/npm/v/chrome-devtools-mcp.svg)](https://npmjs.org/package/chrome-devtools-mcp)
+[![npm @vibebrowser/chrome-devtools-mcp](https://img.shields.io/npm/v/@vibebrowser/chrome-devtools-mcp.svg)](https://npmjs.org/package/@vibebrowser/chrome-devtools-mcp)
+
+> **Fork of [ChromeDevTools/chrome-devtools-mcp](https://github.com/ChromeDevTools/chrome-devtools-mcp)** with HTTP transport for multi-agent sharing.
+>
+> The upstream only supports stdio — one agent per process, one CDP connection per browser. This fork adds a persistent HTTP service that multiple agents can connect to simultaneously without resetting each other's sessions.
+
+---
+
+## Quick Start
+
+Install as a background service (macOS/Linux):
+
+```bash
+npx @vibebrowser/chrome-devtools-mcp install --port 9333
+```
+
+That's it. The service auto-connects to your running Chrome and starts accepting MCP requests at `http://localhost:9333/mcp`.
+
+### Add to your agent config
+
+Works with OpenCode, Copilot, Claude, Cursor, or any MCP client:
+
+```json
+{
+  "mcpServers": {
+    "chrome-devtools": {
+      "url": "http://localhost:9333/mcp"
+    }
+  }
+}
+```
+
+### Expose to cloud agents via Tailscale
+
+```bash
+npx @vibebrowser/chrome-devtools-mcp install --port 9333 --tailscale
+```
+
+Your browser becomes accessible at `https://your-mac.tailnet.ts.net/mcp` — private, encrypted, no public exposure.
+
+### Manage the service
+
+```bash
+npx @vibebrowser/chrome-devtools-mcp status
+npx @vibebrowser/chrome-devtools-mcp uninstall
+```
+
+---
+
+## What's Different From Upstream
+
+| | Upstream (`chrome-devtools-mcp`) | This fork (`@vibebrowser/chrome-devtools-mcp`) |
+|---|---|---|
+| Transport | stdio only | stdio + HTTP (StreamableHTTP) |
+| Multi-agent | ❌ One agent per process | ✅ Multiple agents, independent sessions |
+| Deployment | Per-invocation via `npx` | Background service (launchd/systemd) |
+| Remote access | None | Tailscale serve integration |
+| Package | `chrome-devtools-mcp` | `@vibebrowser/chrome-devtools-mcp` |
+
+---
+
+## Original README
 
 Chrome DevTools for Agents (`chrome-devtools-mcp`) lets your coding agent (such as Gemini, Claude, Cursor or Copilot)
 control and inspect a live Chrome browser. It acts as a Model-Context-Protocol

package/build/src/bin/chrome-devtools-mcp-main.js

@@ -11,8 +11,7 @@ import { createMcpServer, logDisclaimers } from '../index.js';
 import { logger, saveLogsToFile } from '../logger.js';
 import { ClearcutLogger } from '../telemetry/ClearcutLogger.js';
 import { computeFlagUsage } from '../telemetry/flagUtils.js';
-import { StdioServerTransport, StreamableHTTPServerTransport, } from '../third_party/index.js';
-import { isInitializeRequest } from '@modelcontextprotocol/sdk/types.js';
+import { StdioServerTransport, StreamableHTTPServerTransport, isInitializeRequest, } from '../third_party/index.js';
 import { checkForUpdates } from '../utils/check-for-updates.js';
 import { VERSION } from '../version.js';
 import { cliOptions, parseArguments } from './chrome-devtools-mcp-cli-options.js';

package/build/src/bin/install-service.js

@@ -209,6 +209,46 @@ function uninstallTailscale(port) {
         // ignore — might not have been configured
     }
 }
+async function healthCheck(port, retries = 10, delayMs = 1000) {
+    const url = `http://localhost:${port}/mcp`;
+    const body = JSON.stringify({
+        jsonrpc: '2.0',
+        id: 1,
+        method: 'initialize',
+        params: {
+            protocolVersion: '2024-11-05',
+            capabilities: {},
+            clientInfo: { name: 'health-check', version: '1.0' },
+        },
+    });
+    process.stdout.write('⏳ Checking service health');
+    for (let i = 0; i < retries; i++) {
+        await new Promise(r => setTimeout(r, delayMs));
+        process.stdout.write('.');
+        try {
+            const res = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Accept: 'application/json, text/event-stream',
+                },
+                body,
+            });
+            if (res.ok) {
+                const text = await res.text();
+                if (text.includes('"protocolVersion"')) {
+                    console.log(' ✅ healthy');
+                    return true;
+                }
+            }
+        }
+        catch {
+            // Service not ready yet
+        }
+    }
+    console.log(' ❌ failed');
+    return false;
+}
 // Main
 const { port, action, tailscale } = parseArgs();
 const platform = process.platform;
@@ -237,10 +277,25 @@ else {
     console.error('   Supported: macOS (launchd), Linux (systemd)');
     process.exit(1);
 }
-if (action === 'install' && tailscale) {
-    installTailscale(port);
-}
-else if (action === 'install') {
-    printMcpConfig(`http://localhost:${port}/mcp`);
+if (action === 'install') {
+    const healthy = await healthCheck(port);
+    if (!healthy) {
+        console.error(`\n⚠️  Service installed but health check failed.`);
+        console.error(`   Check logs for errors.`);
+        if (platform === 'darwin') {
+            const logDir = path.join(process.env['HOME'] || '/tmp', 'Library', 'Logs', 'chrome-devtools-mcp');
+            console.error(`   Logs: cat ${logDir}/chrome-devtools-mcp.stderr.log`);
+        }
+        else {
+            console.error(`   Logs: journalctl --user -u chrome-devtools-mcp`);
+        }
+        process.exit(1);
+    }
+    if (tailscale) {
+        installTailscale(port);
+    }
+    else {
+        printMcpConfig(`http://localhost:${port}/mcp`);
+    }
 }
 //# sourceMappingURL=install-service.js.map

package/build/src/third_party/index.js

@@ -186288,5 +186288,5 @@ const snapshot = snapshot$1;
 const navigation = navigation$1;
 const generateReport = generateReport$1;
 
-export { Browser as BrowserEnum, CDPSessionEvent, Client$1 as Client, mcp as DevTools, KnownDevices, ListRootsRequestSchema, ListRootsResultSchema, Locator, McpServer, PipeTransport, PredefinedNetworkConditions, RootsListChangedNotificationSchema, SetLevelRequestSchema, StdioClientTransport, StdioServerTransport, StreamableHTTPServerTransport, ajv, debug$2 as debug, detectBrowserPlatform, generateReport, hideBin, navigation, puppeteer, resolveDefaultUserDataDir, semver, snapshot, Yargs as yargs, z$1 as zod };
+export { Browser as BrowserEnum, CDPSessionEvent, Client$1 as Client, mcp as DevTools, KnownDevices, ListRootsRequestSchema, ListRootsResultSchema, Locator, McpServer, PipeTransport, PredefinedNetworkConditions, RootsListChangedNotificationSchema, SetLevelRequestSchema, StdioClientTransport, StdioServerTransport, StreamableHTTPServerTransport, ajv, debug$2 as debug, detectBrowserPlatform, generateReport, hideBin, isInitializeRequest, navigation, puppeteer, resolveDefaultUserDataDir, semver, snapshot, Yargs as yargs, z$1 as zod };
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibebrowser/chrome-devtools-mcp",
-  "version": "0.26.1",
+  "version": "0.26.3",
   "description": "Chrome DevTools MCP server with Streamable HTTP transport for multi-agent sharing",
   "type": "module",
   "bin": {