mcpbrowser 0.2.0 → 0.2.2

package/.mcpregistry_github_token

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

package/.mcpregistry_registry_token

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

package/README.md

@@ -1,10 +1,57 @@
 # MCPBrowser (MCP fetch tool with authenticated Chrome)
 
-An MCP server that exposes an authenticated page fetch tool for GitHub Copilot. It drives your signed-in Chrome/Edge via DevTools, reusing your profile to read restricted pages.
+[![VS Code Marketplace](https://img.shields.io/visual-studio-marketplace/v/cherchyk.mcpbrowser.svg)](https://marketplace.visualstudio.com/items?itemName=cherchyk.mcpbrowser)
+[![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)
 
-## Quick Install
+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.
 
-### Option 1: Install from GitHub (Recommended)
+## 🚀 Installation Options
+
+### Option 1: VS Code Extension (Easiest - One Click)
+
+**From VS Code Marketplace:**
+```bash
+code --install-extension cherchyk.mcpbrowser
+```
+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.1.4.vsix
+```
+
+The extension automatically:
+- Installs the MCPBrowser npm package globally
+- Configures mcp.json for GitHub Copilot
+- Complete one-click setup - no manual steps needed
+
+📦 [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.
+
+Add to your `mcp.json`:
+```jsonc
+"MCPBrowser": {
+  "type": "stdio",
+  "command": "npx",
+  "args": ["-y", "mcpbrowser@latest"],
+  "description": "Loads authenticated web pages using your Chrome session"
+}
+```
+
+**mcp.json Location:**
+- Windows: `%APPDATA%\Code\User\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.
+
+Search for "browser" in the registry to find configuration instructions.
+
+### Option 4: Clone from GitHub (Development)
 ```bash
 git clone https://github.com/cherchyk/MCPBrowser.git
 cd MCPBrowser
@@ -12,9 +59,14 @@ npm install
 copy .env.example .env  # optional: set Chrome overrides
 ```
 
-### Option 2: Install via npx (when published to npm)
-```bash
-npx mcpbrowser
+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"
+}
 ```
 
 ## Prereqs
@@ -40,35 +92,6 @@ 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.
 - **Domain-aware tab reuse**: Automatically reuses the same tab for URLs on the same domain, preserving authentication session. Different domains open new tabs.
@@ -78,6 +101,16 @@ In Copilot Chat, you should see the `MCPBrowser` server listed. Ask it to load a
 - **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/extension/.vscodeignore

@@ -0,0 +1,6 @@
+.vscode/**
+.vscode-test/**
+node_modules/**
+.gitignore
+.yarnrc
+*.vsix

package/extension/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 cherchyk
+
+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/README.md

@@ -0,0 +1,61 @@
+# MCPBrowser
+
+Alternative web fetcher for GitHub Copilot when normal URL access fails due to authentication or anti-crawler restrictions.
+
+## Features
+
+- 🚀 **One-Click Setup**: Installs npm package and configures mcp.json automatically
+- 🔐 **Bypass Authentication**: Opens pages in your Chrome/Edge browser - you authenticate if needed, MCPBrowser waits and fetches the final page content
+- 🤖 **Beat Anti-Crawler**: Works when sites block Copilot's normal fetching
+- ⚙️ **Auto-Configuration**: Complete setup with a single click
+
+## How It Works
+
+When Copilot needs to access an authenticated or protected page:
+1. MCPBrowser opens the URL in your Chrome/Edge browser
+2. If authentication is required, you log in normally in the browser
+3. MCPBrowser waits for the page to fully load (handles redirects automatically)
+4. Once loaded, it extracts the content and returns it to Copilot
+5. The browser tab stays open to reuse your session for future requests
+
+## Usage
+
+### Installation Steps
+
+1. Install this extension from VS Code marketplace
+2. You'll see a notification: **"MCPBrowser is available! Would you like to configure it for GitHub Copilot?"**
+3. Click **"Configure Now"**
+4. Wait for "Installing MCPBrowser npm package..." to complete
+5. When you see **"MCPBrowser configured successfully!"**, click **"Restart Now"**
+6. After restart, MCPBrowser is ready to use with Copilot!
+
+### Using with GitHub Copilot
+
+Once configured, Copilot will automatically use MCPBrowser when it encounters auth/crawler blocks. You can also explicitly request it:
+
+**Example prompts:**
+```
+Read https://internal.company.com/docs (I'm already logged in)
+
+Load the content from https://portal.azure.com/resources - use my authenticated session
+
+Fetch https://github.com/private-repo/issues using MCPBrowser
+```
+
+Copilot will use your Chrome/Edge browser session to access these pages, bypassing authentication and anti-crawler restrictions.
+
+### Manual Commands
+
+Command Palette (`Ctrl+Shift+P` or `Cmd+Shift+P`):
+- **Configure MCPBrowser for GitHub Copilot** - Set up or update configuration
+- **Remove MCPBrowser from GitHub Copilot** - Remove configuration
+
+## About MCPBrowser
+
+Alternative web fetcher for GitHub Copilot when normal URL access fails. Uses Chrome DevTools Protocol to access authenticated and crawler-protected pages through your browser session.
+
+Learn more: [MCPBrowser on GitHub](https://github.com/cherchyk/MCPBrowser)
+
+## License
+
+MIT

package/extension/icon.svg

@@ -0,0 +1,35 @@
+<svg width="128" height="128" viewBox="0 0 128 128" xmlns="http://www.w3.org/2000/svg">
+  <!-- Background circle -->
+  <circle cx="64" cy="64" r="60" fill="#0078D4"/>
+  
+  <!-- Browser window outline -->
+  <rect x="24" y="28" width="80" height="56" rx="4" fill="white"/>
+  <rect x="28" y="32" width="72" height="48" rx="2" fill="#E8F4FD"/>
+  
+  <!-- Browser chrome bar -->
+  <rect x="28" y="32" width="72" height="8" fill="#0078D4"/>
+  
+  <!-- Browser dots (window controls) -->
+  <circle cx="33" cy="36" r="1.5" fill="white"/>
+  <circle cx="38" cy="36" r="1.5" fill="white"/>
+  <circle cx="43" cy="36" r="1.5" fill="white"/>
+  
+  <!-- Lock/Shield icon (authentication symbol) -->
+  <g transform="translate(48, 48)">
+    <!-- Shield -->
+    <path d="M 16 4 L 16 14 C 16 18 12 22 8 24 C 4 22 0 18 0 14 L 0 4 L 8 0 Z" 
+          fill="#10B981" stroke="none"/>
+    <!-- Checkmark inside shield -->
+    <path d="M 5 12 L 7 14 L 12 8" 
+          stroke="white" 
+          stroke-width="2" 
+          stroke-linecap="round" 
+          stroke-linejoin="round" 
+          fill="none"/>
+  </g>
+  
+  <!-- Connection indicator (small dots) -->
+  <circle cx="90" cy="48" r="3" fill="#10B981"/>
+  <circle cx="98" cy="48" r="2" fill="#10B981" opacity="0.7"/>
+  <circle cx="104" cy="48" r="1.5" fill="#10B981" opacity="0.4"/>
+</svg>

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

@@ -0,0 +1,32 @@
+{
+  "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

@@ -0,0 +1,21 @@
+    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

@@ -0,0 +1,15 @@
+# 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

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