mcpbrowser 0.2.30 → 0.2.32

package/.github/workflows/test.yml

@@ -29,5 +29,5 @@ jobs:
     - name: Run MCP server tests
       run: npm run test:mcp
     
-    - name: Run all tests
-      run: npm test
+    - name: Run unit tests (excluding integration tests)
+      run: node --test tests/auth-flow.test.js tests/domain-tab-pooling.test.js tests/mcp-server.test.js tests/prepare-html.test.js tests/redirect-detection.test.js

package/README.md

@@ -20,7 +20,7 @@ Or search "MCPBrowser" in VS Code Extensions view.
 **From GitHub Release:**
 Download from [GitHub Releases](https://github.com/cherchyk/MCPBrowser/releases):
 ```bash
-code --install-extension mcpbrowser-0.2.24.vsix
+code --install-extension mcpbrowser-0.2.32.vsix
 ```
 
 The extension automatically:
@@ -31,7 +31,7 @@ The extension automatically:
 📦 [View on Marketplace](https://marketplace.visualstudio.com/items?itemName=cherchyk.mcpbrowser)
 
 ### Option 2: npm Package (Recommended for Manual Setup)
-Published on npm as [mcpbrowser](https://www.npmjs.com/package/mcpbrowser) v0.2.24.
+Published on npm as [mcpbrowser](https://www.npmjs.com/package/mcpbrowser) v0.2.32.
 
 Add to your `mcp.json`:
 ```jsonc
@@ -39,7 +39,7 @@ Add to your `mcp.json`:
   "type": "stdio",
   "command": "npx",
   "args": ["-y", "mcpbrowser@latest"],
-  "description": "In-browser web page fetching. Used for: (1) auth-required pages (401/403, login, SSO, corporate intranets), (2) anti-bot/crawler blocks, CAPTCHA/human verification, (3) JavaScript-heavy sites (SPAs, dynamic content). Browser opens to load the page, user may be asked to authenticate or to prove it's not a robot."
+  "description": "Web page fetching via browser for sites requiring authentication, anti-bot protection, or JavaScript rendering. Use when standard HTTP requests fail for: (1) auth-required pages (401/403, SSO, corporate intranets), (2) anti-bot verification (CAPTCHA, Cloudflare), (3) JavaScript-heavy sites (SPAs, dynamic content). Opens a browser where the user can authenticate, then automatically extracts content."
 }
 ```
 
@@ -48,7 +48,7 @@ Add to your `mcp.json`:
 - Mac/Linux: `~/.config/Code/User/mcp.json`
 
 ### Option 3: MCP Registry
-Available in the [MCP Registry](https://registry.modelcontextprotocol.io/) as `io.github.cherchyk/browser` v0.2.24.
+Available in the [MCP Registry](https://registry.modelcontextprotocol.io/) as `io.github.cherchyk/browser` v0.2.32.
 
 Search for "browser" in the registry to find configuration instructions.
 
@@ -77,7 +77,6 @@ Restart Claude Desktop after configuration.
 git clone https://github.com/cherchyk/MCPBrowser.git
 cd MCPBrowser
 npm install
-copy .env.example .env  # optional: set Chrome overrides
 ```
 
 ## Prereqs
@@ -118,7 +117,7 @@ Add this entry to your `mcp.json` file under the `"servers"` section:
 	"type": "stdio",
 	"command": "node",
 	"args": ["<PATH_TO_MCPBROWSER>/src/mcp-browser.js"],
-	"description": "In-browser web page fetching. Used for: (1) auth-required pages (401/403, login, SSO, corporate intranets), (2) anti-bot/crawler blocks, CAPTCHA/human verification, (3) JavaScript-heavy sites (SPAs, dynamic content). Browser opens to load the page, user may be asked to authenticate or to prove it's not a robot."
+	"description": "Web page fetching via browser for sites requiring authentication, anti-bot protection, or JavaScript rendering. Use when standard HTTP requests fail for: (1) auth-required pages (401/403, SSO, corporate intranets), (2) anti-bot verification (CAPTCHA, Cloudflare), (3) JavaScript-heavy sites (SPAs, dynamic content). Opens a browser where the user can authenticate, then automatically extracts content."
 }
 ```
 
@@ -149,8 +148,15 @@ In Claude Code or Copilot Chat, you should see the `MCPBrowser` server listed. A
 - Optional fields (`authWaitSelector`, `waitForSelector`, `waitForUrlPattern`, etc.) are available but not required.
 
 ## Configuration
-- `.env`: optional overrides for `CHROME_WS_ENDPOINT`, `CHROME_REMOTE_DEBUG_HOST/PORT`, `CHROME_PATH`, `CHROME_USER_DATA_DIR`.
-- To use a specific WS endpoint: set `CHROME_WS_ENDPOINT` from Chrome `chrome://version` DevTools JSON.
+Optional environment variables for advanced configuration:
+- `CHROME_PATH`: Custom path to Chrome/Edge executable
+- `CHROME_USER_DATA_DIR`: Custom browser profile directory
+- `CHROME_REMOTE_DEBUG_HOST`: DevTools host (default: `127.0.0.1`)
+- `CHROME_REMOTE_DEBUG_PORT`: DevTools port (default: `9222`)
+- `CHROME_WS_ENDPOINT`: Explicit WebSocket endpoint URL
+- `DEFAULT_FETCH_URL` or `MCP_DEFAULT_FETCH_URL`: Default URL when called without params
+
+Set these in your shell or system environment before running the MCP server.
 
 ## Tips
 - **Universal auth**: Works with ANY authenticated site - corporate intranets, SSO, OAuth, SAML, login pages, CAPTCHA, human verification, etc.

package/extension/package.json

@@ -2,7 +2,7 @@
   "name": "mcpbrowser",
   "displayName": "MCP Browser",
   "description": "Lightweight MCP server-extension for in-browser web page fetching - handles login, SSO, and anti-crawler restrictions. Should be used when standard fetch_webpage fails",
-  "version": "0.2.29",
+  "version": "0.2.32",
   "publisher": "cherchyk",
   "icon": "icon.png",
   "engines": {

package/package.json

@@ -1,43 +1 @@
-{  "name": "mcpbrowser",
-  "version": "0.2.30",
-  "mcpName": "io.github.cherchyk/browser",
-  "type": "module",
-  "description": "MCP server for in-browser web page fetching using Chrome DevTools Protocol",
-  "main": "src/mcp-browser.js",
-  "bin": {
-    "mcpbrowser": "src/mcp-browser.js"
-  },
-  "scripts": {
-    "mcp": "node src/mcp-browser.js",
-    "test": "node --test tests/*.test.js",
-    "test:mcp": "node --test tests/mcp-server.test.js"
-  },
-  "keywords": [
-    "mcp",
-    "mcp-server",
-    "model-context-protocol",
-    "chrome",
-    "puppeteer",
-    "authentication",
-    "web-scraping",
-    "github-copilot"
-  ],
-  "author": "cherchyk",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/cherchyk/MCPBrowser.git"
-  },
-  "bugs": {
-    "url": "https://github.com/cherchyk/MCPBrowser/issues"
-  },
-  "homepage": "https://github.com/cherchyk/MCPBrowser#readme",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.25.1",
-    "dotenv": "^16.4.5",
-    "puppeteer-core": "^23.4.1"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}
+{"name":"mcpbrowser","version":"0.2.32","mcpName":"io.github.cherchyk/browser","type":"module","description":"MCP server for in-browser web page fetching using Chrome DevTools Protocol","main":"src/mcp-browser.js","bin":{"mcpbrowser":"src/mcp-browser.js"},"scripts":{"mcp":"node src/mcp-browser.js","test":"node --test tests/*.test.js","test:mcp":"node --test tests/mcp-server.test.js"},"keywords":["mcp","mcp-server","model-context-protocol","chrome","puppeteer","authentication","web-scraping","github-copilot"],"author":"cherchyk","license":"MIT","repository":{"type":"git","url":"git+https://github.com/cherchyk/MCPBrowser.git"},"bugs":{"url":"https://github.com/cherchyk/MCPBrowser/issues"},"homepage":"https://github.com/cherchyk/MCPBrowser#readme","dependencies":{"@modelcontextprotocol/sdk":"^1.25.1","puppeteer-core":"^23.4.1"},"engines":{"node":">=18.0.0"}}

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/cherchyk/MCPBrowser",
     "source": "github"
   },
-  "version": "0.2.29",
+  "version": "0.2.32",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "mcpbrowser",
-      "version": "0.2.3",
+      "version": "0.2.32",
       "transport": {
         "type": "stdio"
       }

package/src/mcp-browser.js

@@ -1,5 +1,4 @@
 #!/usr/bin/env node
-import dotenv from "dotenv";
 import puppeteer from "puppeteer-core";
 import { existsSync } from "fs";
 import os from "os";
@@ -9,8 +8,6 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { ListToolsRequestSchema, CallToolRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 
-dotenv.config();
-
 const chromeHost = process.env.CHROME_REMOTE_DEBUG_HOST || "127.0.0.1";
 const chromePort = Number(process.env.CHROME_REMOTE_DEBUG_PORT || 9222);
 const explicitWSEndpoint = process.env.CHROME_WS_ENDPOINT;
@@ -49,6 +46,7 @@ function getDefaultChromePaths() {
       "C:/Program Files/Google/Chrome/Application/chrome.exe",
       "C:/Program Files (x86)/Google/Chrome/Application/chrome.exe",
       "C:/Program Files/Microsoft/Edge/Application/msedge.exe",
+      "C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe",
     ];
   } else if (platform === "darwin") {
     return [
@@ -61,6 +59,8 @@ function getDefaultChromePaths() {
       "/usr/bin/google-chrome",
       "/usr/bin/chromium-browser",
       "/usr/bin/chromium",
+      "/usr/bin/microsoft-edge",
+      "/opt/microsoft/msedge/msedge",
     ];
   }
 }
@@ -884,7 +884,9 @@ export {
 };
 
 // Run the MCP server only if this is the main module (not imported for testing)
-if (import.meta.url === `file:///${process.argv[1].replace(/\\/g, '/')}`) {
+import { fileURLToPath } from 'url';
+if (import.meta.url === new URL(process.argv[1], 'file://').href || 
+    fileURLToPath(import.meta.url) === process.argv[1]) {
   main().catch((err) => {
     console.error(err);
     process.exit(1);

package/test-mcp.js

@@ -1,63 +0,0 @@
-#!/usr/bin/env node
-import { spawn } from 'child_process';
-
-const mcpProcess = spawn('node', ['src/mcp-browser.js'], {
-  cwd: process.cwd(),
-  stdio: ['pipe', 'pipe', 'inherit']
-});
-
-// Send initialize request
-const initRequest = {
-  jsonrpc: '2.0',
-  id: 1,
-  method: 'initialize',
-  params: {
-    protocolVersion: '2024-11-05',
-    capabilities: {},
-    clientInfo: { name: 'test', version: '1.0' }
-  }
-};
-
-console.log('Sending initialize request...');
-mcpProcess.stdin.write(JSON.stringify(initRequest) + '\n');
-
-// Send list tools request
-const listToolsRequest = {
-  jsonrpc: '2.0',
-  id: 2,
-  method: 'tools/list',
-  params: {}
-};
-
-setTimeout(() => {
-  console.log('Sending tools/list request...');
-  mcpProcess.stdin.write(JSON.stringify(listToolsRequest) + '\n');
-}, 1000);
-
-let responseBuffer = '';
-mcpProcess.stdout.on('data', (data) => {
-  responseBuffer += data.toString();
-  const lines = responseBuffer.split('\n');
-  responseBuffer = lines.pop() || '';
-  
-  lines.forEach(line => {
-    if (line.trim()) {
-      try {
-        const response = JSON.parse(line);
-        console.log('Response:', JSON.stringify(response, null, 2));
-      } catch (e) {
-        console.log('Raw output:', line);
-      }
-    }
-  });
-});
-
-mcpProcess.on('error', (err) => {
-  console.error('Error:', err);
-});
-
-setTimeout(() => {
-  console.log('Closing...');
-  mcpProcess.kill();
-  process.exit(0);
-}, 3000);