mcpbrowser 0.2.2 → 0.2.4

package/README.md

@@ -4,7 +4,7 @@
 [![npm version](https://img.shields.io/npm/v/mcpbrowser.svg)](https://www.npmjs.com/package/mcpbrowser)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Alternative web fetcher for GitHub Copilot when normal URL access fails due to authentication or anti-crawler restrictions. Uses your Chrome/Edge browser session via DevTools to bypass login requirements and bot detection.
+Alternative web fetcher for GitHub Copilot when normal URL access fails due to authentication or anti-crawler restrictions. Uses your Chrome/Edge browser session via DevTools Protocol to bypass login requirements and bot detection.
 
 ## 🚀 Installation Options
 
@@ -30,7 +30,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.2.
+Published on npm as [mcpbrowser](https://www.npmjs.com/package/mcpbrowser) v0.2.3.
 
 Add to your `mcp.json`:
 ```jsonc
@@ -47,7 +47,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.2.
+Available in the [MCP Registry](https://registry.modelcontextprotocol.io/) as `io.github.cherchyk/browser` v0.2.3.
 
 Search for "browser" in the registry to find configuration instructions.
 
@@ -59,14 +59,9 @@ npm install
 copy .env.example .env  # optional: set Chrome overrides
 ```
 
-Add to `mcp.json`:
-```jsonc
-"MCPBrowser": {
-  "type": "stdio",
-  "command": "node",
-  "args": ["<PATH_TO_MCPBROWSER>/src/mcp-browser.js"],
-  "description": "Loads authenticated web pages using your Chrome session"
-}
+### Option 2: Install via npx (when published to npm)
+```bash
+npx mcpbrowser
 ```
 
 ## Prereqs
@@ -92,8 +87,38 @@ Set `CHROME_PATH` if auto-detect fails; override profile with `CHROME_USER_DATA_
 ## (Optional) Local runner
 There is no local LLM runner now; Copilot provides the LLM and calls this MCP tool. If you need a standalone agent later, we can add one that reuses the fetch logic.
 
+## Configure in VS Code (GitHub Copilot)
+
+### Step 1: Locate your mcp.json file
+- **Windows**: `%APPDATA%\Code\User\mcp.json`
+- **Linux/Mac**: `~/.config/Code/User/mcp.json`
+
+### Step 2: Add MCPBrowser server configuration
+
+Add this entry to your `mcp.json` file under the `"servers"` section:
+
+```jsonc
+"MCPBrowser": {
+	"type": "stdio",
+	"command": "node",
+	"args": ["<PATH_TO_MCPBROWSER>/src/mcp-browser.js"],
+	"description": "**USE THIS AUTOMATICALLY** when you encounter ANY authentication/authorization barrier: 401/403 errors, login redirects, 'access denied', SSO prompts, or pages requiring sign-in. Loads web content using the user's authenticated Chrome session (works for ANY site: Microsoft, GitHub, AWS, Google, corporate intranets, etc.). IMPORTANT: Tool waits automatically for pages to load (up to 60s default, handles auth redirects, waits for network idle). Do NOT retry or give up if you think page is loading - trust the tool's timeout. Do NOT ask permission - use immediately when auth is required."
+}
+```
+
+Replace `<PATH_TO_MCPBROWSER>` with the full path where you cloned this repository, for example:
+- Windows: `"D:/dev/MCPBrowser/src/mcp-browser.js"`
+- Linux/Mac: `"/home/user/MCPBrowser/src/mcp-browser.js"`
+
+### Step 3: Reload VS Code
+Restart VS Code or reload the window for the changes to take effect.
+
+### Step 4: Verify
+In Copilot Chat, you should see the `MCPBrowser` server listed. Ask it to load an authenticated URL and it will drive your signed-in Chrome session.
+
 ## How it works
 - Tool `load_and_extract` (inside the MCP server) drives your live Chrome (DevTools Protocol) so it inherits your auth cookies, returning `text` and `html` (truncated up to 2M chars per field) for analysis.
+- **Smart confirmation**: Copilot asks for confirmation ONLY on first request to a new domain - explains browser will open for authentication. Subsequent requests to same domain work automatically (session preserved).
 - **Domain-aware tab reuse**: Automatically reuses the same tab for URLs on the same domain, preserving authentication session. Different domains open new tabs.
 - **Automatic page loading**: Waits for network idle (`networkidle0`) by default, ensuring JavaScript-heavy pages (SPAs, dashboards) fully load before returning content.
 - **Automatic auth detection**: Detects ANY authentication redirect (domain changes, login/auth/sso/oauth URLs) and waits for you to complete sign-in, then returns to target page.
@@ -101,16 +126,6 @@ There is no local LLM runner now; Copilot provides the LLM and calls this MCP to
 - **Smart timeouts**: 60s default for page load, 10 min for auth redirects. Tabs stay open indefinitely for reuse (no auto-close).
 - GitHub Copilot's LLM invokes this tool via MCP; this repo itself does not run an LLM.
 
-## Distribution
-
-MCPBrowser is available through three channels:
-
-1. **VS Code Extension** (easiest): [cherchyk.mcpbrowser](https://marketplace.visualstudio.com/items?itemName=cherchyk.mcpbrowser) - One-click configuration
-2. **npm**: [mcpbrowser](https://www.npmjs.com/package/mcpbrowser) v0.2.2 - Use with npx
-3. **MCP Registry**: [io.github.cherchyk/browser](https://registry.modelcontextprotocol.io/) v0.2.2 - Discoverable in registry
-
-All three methods configure the same underlying MCP server that drives Chrome via DevTools Protocol.
-
 ## Auth-assisted fetch flow
 - Copilot can call with just the URL, or with no params if you set an env default (`DEFAULT_FETCH_URL` or `MCP_DEFAULT_FETCH_URL`). By default tabs stay open indefinitely for reuse (domain-aware).
 - First call opens the tab and leaves it open so you can sign in. No extra params needed.

package/package.json

@@ -1,6 +1,5 @@
-{
-  "name": "mcpbrowser",
-  "version": "0.2.2",
+{  "name": "mcpbrowser",
+  "version": "0.2.4",
   "mcpName": "io.github.cherchyk/browser",
   "type": "module",
   "description": "MCP server that loads authenticated web pages using Chrome DevTools Protocol",

package/server.json

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

package/src/mcp-browser.js

@@ -14,13 +14,49 @@ 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;
-const userDataDir = process.env.CHROME_USER_DATA_DIR || path.join(os.homedir(), "AppData/Local/ChromeAuthProfile");
+
+// Use default Chrome profile if not explicitly set
+function getDefaultUserDataDir() {
+  const platform = os.platform();
+  const home = os.homedir();
+  
+  if (platform === "win32") {
+    return path.join(home, "AppData/Local/Google/Chrome/User Data");
+  } else if (platform === "darwin") {
+    return path.join(home, "Library/Application Support/Google/Chrome");
+  } else {
+    return path.join(home, ".config/google-chrome");
+  }
+}
+
+const userDataDir = process.env.CHROME_USER_DATA_DIR || getDefaultUserDataDir();
 const chromePathEnv = process.env.CHROME_PATH;
-const defaultChromePaths = [
-  "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",
-];
+
+function getDefaultChromePaths() {
+  const platform = os.platform();
+  
+  if (platform === "win32") {
+    return [
+      "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",
+    ];
+  } else if (platform === "darwin") {
+    return [
+      "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+      "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
+      "/Applications/Chromium.app/Contents/MacOS/Chromium",
+    ];
+  } else {
+    return [
+      "/usr/bin/google-chrome",
+      "/usr/bin/chromium-browser",
+      "/usr/bin/chromium",
+    ];
+  }
+}
+
+const defaultChromePaths = getDefaultChromePaths();
 
 let cachedBrowser = null;
 let lastKeptPage = null; // reuse the same tab when requested

package/.mcpregistry_github_token

@@ -1 +0,0 @@
-ghu_GEGvUt8NgjqiZYHTwekKgM9yUsX1n22fSpJ5

package/.mcpregistry_registry_token

@@ -1 +0,0 @@
-{"token":"eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJtY3AtcmVnaXN0cnkiLCJleHAiOjE3NjY0MjQ1NTMsIm5iZiI6MTc2NjQyNDI1MywiaWF0IjoxNzY2NDI0MjUzLCJhdXRoX21ldGhvZCI6ImdpdGh1Yi1hdCIsImF1dGhfbWV0aG9kX3N1YiI6ImNoZXJjaHlrIiwicGVybWlzc2lvbnMiOlt7ImFjdGlvbiI6InB1Ymxpc2giLCJyZXNvdXJjZSI6ImlvLmdpdGh1Yi5jaGVyY2h5ay8qIn1dfQ.pVy-6UXIaWbfS_fZH6fw2g_tQluhRxxY_zfkp3sFwl_dMDf3io17bu12WkWwSl5k9OoWVNtGpu1gooWrvvj0Bg","expires_at":1766424553}

package/extension/node_modules/.package-lock.json

@@ -1,32 +0,0 @@
-{
-  "name": "mcpbrowser",
-  "version": "0.1.2",
-  "lockfileVersion": 3,
-  "requires": true,
-  "packages": {
-    "node_modules/@types/node": {
-      "version": "20.19.27",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.27.tgz",
-      "integrity": "sha512-N2clP5pJhB2YnZJ3PIHFk5RkygRX5WO/5f0WC08tp0wd+sv0rsJk3MqWn3CbNmT2J505a5336jaQj4ph1AdMug==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "undici-types": "~6.21.0"
-      }
-    },
-    "node_modules/@types/vscode": {
-      "version": "1.107.0",
-      "resolved": "https://registry.npmjs.org/@types/vscode/-/vscode-1.107.0.tgz",
-      "integrity": "sha512-XS8YE1jlyTIowP64+HoN30OlC1H9xqSlq1eoLZUgFEC8oUTO6euYZxti1xRiLSfZocs4qytTzR6xCBYtioQTCg==",
-      "dev": true,
-      "license": "MIT"
-    },
-    "node_modules/undici-types": {
-      "version": "6.21.0",
-      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
-      "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
-      "dev": true,
-      "license": "MIT"
-    }
-  }
-}

package/extension/node_modules/@types/node/LICENSE

@@ -1,21 +0,0 @@
-    MIT License
-
-    Copyright (c) Microsoft Corporation.
-
-    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/extension/node_modules/@types/node/README.md

@@ -1,15 +0,0 @@
-# Installation
-> `npm install --save @types/node`
-
-# Summary
-This package contains type definitions for node (https://nodejs.org/).
-
-# Details
-Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/node/v20.
-
-### Additional Details
- * Last updated: Sun, 14 Dec 2025 00:04:32 GMT
- * Dependencies: [undici-types](https://npmjs.com/package/undici-types)
-
-# Credits
-These definitions were written by [Microsoft TypeScript](https://github.com/Microsoft), [Alberto Schiabel](https://github.com/jkomyno), [Andrew Makarov](https://github.com/r3nya), [Benjamin Toueg](https://github.com/btoueg), [David Junger](https://github.com/touffy), [Mohsen Azimi](https://github.com/mohsen1), [Nikita Galkin](https://github.com/galkin), [Sebastian Silbermann](https://github.com/eps1lon), [Wilco Bakker](https://github.com/WilcoBakker), [Marcin Kopacz](https://github.com/chyzwar), [Trivikram Kamat](https://github.com/trivikr), [Junxiao Shi](https://github.com/yoursunny), [Ilia Baryshnikov](https://github.com/qwelias), [ExE Boss](https://github.com/ExE-Boss), [Piotr Błażejewicz](https://github.com/peterblazejewicz), [Anna Henningsen](https://github.com/addaleax), [Victor Perin](https://github.com/victorperin), [NodeJS Contributors](https://github.com/NodeJS), [Linus Unnebäck](https://github.com/LinusU), [wafuwafu13](https://github.com/wafuwafu13), [Matteo Collina](https://github.com/mcollina), and [Dmitry Semigradsky](https://github.com/Semigradsky).

package/extension/node_modules/@types/node/assert/strict.d.ts

@@ -1,8 +0,0 @@
-declare module "assert/strict" {
-    import { strict } from "node:assert";
-    export = strict;
-}
-declare module "node:assert/strict" {
-    import { strict } from "node:assert";
-    export = strict;
-}