@mehmoodqureshi/chrome-mcp 0.1.0

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@mehmoodqureshi/chrome-mcp",
+  "version": "0.1.0",
+  "description": "Drive a real Chrome browser over MCP. A stdio MCP server (CLI) plus an MV3 extension, behind one pluggable Executor (extension via chrome.scripting, or a Playwright CDP fallback).",
+  "author": "Mehmood Ur Rehman Qureshi",
+  "license": "MIT",
+  "homepage": "https://github.com/Mehmoodqureshi/chrome-mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Mehmoodqureshi/chrome-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Mehmoodqureshi/chrome-mcp/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "chrome-mcp": "dist/src/cli.js"
+  },
+  "files": [
+    "dist/src/**/*.js",
+    "dist/src/**/*.d.ts",
+    "dist/shared/**/*.js",
+    "dist/shared/**/*.d.ts",
+    "extension-dist",
+    "scripts/postinstall.js",
+    "README.md",
+    "LICENSE",
+    "docs/BLUEPRINT.md"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "chrome",
+    "chrome-extension",
+    "browser-automation",
+    "cdp",
+    "playwright",
+    "claude"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "build:ext": "node extension/scripts/build-ext.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "typecheck:ext": "tsc -p tsconfig.ext.json",
+    "clean": "rimraf dist extension-dist",
+    "test": "npm run clean && npm run build && npm run build:ext && node --test dist/test",
+    "test:hitl": "npm run build && node dist/hitl/index.js",
+    "prepack": "npm run clean && npm run build && npm run build:ext",
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "playwright": "^1.49.1",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/chrome": "^0.0.287",
+    "@types/node": "^20.17.10",
+    "@types/ws": "^8.5.13",
+    "esbuild": "^0.24.0",
+    "rimraf": "^5.0.10",
+    "typescript": "^5.7.2"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,50 @@
+/**
+ * postinstall — install the Chromium that the CDP fallback needs.
+ *
+ * Skip-guarded and never fatal: a failure here must not break `npm install`
+ * (the extension path needs no browser, and CI rarely wants the download).
+ * Skips when:
+ *   - CHROME_MCP_SKIP_BROWSER_DOWNLOAD / PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD is set,
+ *   - CI is set,
+ *   - playwright is not installed yet (it is added in phase 3).
+ */
+'use strict';
+
+function shouldSkip() {
+  return (
+    process.env.CHROME_MCP_SKIP_BROWSER_DOWNLOAD === '1' ||
+    process.env.PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD === '1' ||
+    process.env.CI === 'true' ||
+    process.env.CI === '1'
+  );
+}
+
+function hasPlaywright() {
+  try {
+    require.resolve('playwright');
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function main() {
+  if (shouldSkip()) {
+    process.stdout.write('[postinstall] skipping Chromium download (guard set).\n');
+    return;
+  }
+  if (!hasPlaywright()) {
+    process.stdout.write('[postinstall] playwright not installed; CDP fallback unavailable until phase 3.\n');
+    return;
+  }
+  try {
+    const { execFileSync } = require('node:child_process');
+    execFileSync('npx', ['playwright', 'install', 'chromium'], { stdio: 'inherit' });
+  } catch (err) {
+    process.stdout.write(
+      `[postinstall] Chromium install skipped (non-fatal): ${err && err.message ? err.message : err}\n`,
+    );
+  }
+}
+
+main();