mcpbrowser 0.2.0 → 0.2.2

package/extension/src/extension.js

@@ -0,0 +1,257 @@
+const vscode = require('vscode');
+const fs = require('fs').promises;
+const path = require('path');
+const os = require('os');
+const { exec } = require('child_process');
+const util = require('util');
+const execPromise = util.promisify(exec);
+
+/**
+ * Get the path to VS Code's mcp.json configuration file
+ */
+function getMcpConfigPath() {
+    if (process.platform === 'win32') {
+        return path.join(process.env.APPDATA, 'Code', 'User', 'mcp.json');
+    }
+    // macOS and Linux
+    return path.join(os.homedir(), '.config', 'Code', 'User', 'mcp.json');
+}
+
+/**
+ * Check if MCPBrowser is already configured in mcp.json
+ */
+async function isMcpBrowserConfigured() {
+    try {
+        const mcpPath = getMcpConfigPath();
+        const content = await fs.readFile(mcpPath, 'utf-8');
+        const config = JSON.parse(content);
+        return config.servers && config.servers.MCPBrowser !== undefined;
+    } catch (error) {
+        // File doesn't exist or can't be read
+        return false;
+    }
+}
+
+/**
+ * Install MCPBrowser npm package globally
+ */
+async function installMcpBrowser() {
+    try {
+        vscode.window.showInformationMessage('Installing MCPBrowser npm package...');
+        
+        // Install globally so npx can find it reliably
+        await execPromise('npm install -g mcpbrowser@latest');
+        
+        vscode.window.showInformationMessage('MCPBrowser package installed successfully!');
+        return true;
+    } catch (error) {
+        console.error('Error installing MCPBrowser:', error);
+        vscode.window.showErrorMessage(`Failed to install MCPBrowser: ${error.message}`);
+        return false;
+    }
+}
+
+/**
+ * Add MCPBrowser configuration to mcp.json
+ */
+async function configureMcpBrowser() {
+    try {
+        const mcpPath = getMcpConfigPath();
+        let config;
+
+        try {
+            const content = await fs.readFile(mcpPath, 'utf-8');
+            config = JSON.parse(content);
+        } catch (error) {
+            // File doesn't exist, create new config
+            config = { servers: {} };
+            // Ensure directory exists
+            await fs.mkdir(path.dirname(mcpPath), { recursive: true });
+        }
+
+        // Ensure servers object exists
+        if (!config.servers) {
+            config.servers = {};
+        }
+
+        // Add MCPBrowser configuration
+        config.servers.MCPBrowser = {
+            type: "stdio",
+            command: "npx",
+            args: ["-y", "mcpbrowser@latest"],
+            description: "**USE AUTOMATICALLY** when normal URL fetch fails due to: 401/403 errors, login/auth requirements, SSO prompts, anti-crawler/bot detection. **FIRST ACCESS**: Ask confirmation ONLY for first request to a domain - explain browser will open for authentication. **SUBSEQUENT REQUESTS**: Use automatically (session preserved). Loads pages using authenticated Chrome session via DevTools Protocol (works for Microsoft, GitHub, AWS, Google, corporate sites, etc.). Waits for page load automatically (up to 60s, handles redirects)."
+        };
+
+        // Write back to file with pretty formatting
+        await fs.writeFile(mcpPath, JSON.stringify(config, null, 2), 'utf-8');
+        
+        return true;
+    } catch (error) {
+        console.error('Error configuring MCPBrowser:', error);
+        throw error;
+    }
+}
+
+/**
+ * Remove MCPBrowser configuration from mcp.json
+ */
+async function removeMcpBrowser() {
+    try {
+        const mcpPath = getMcpConfigPath();
+        const content = await fs.readFile(mcpPath, 'utf-8');
+        const config = JSON.parse(content);
+
+        if (config.servers && config.servers.MCPBrowser) {
+            delete config.servers.MCPBrowser;
+            await fs.writeFile(mcpPath, JSON.stringify(config, null, 2), 'utf-8');
+            return true;
+        }
+        
+        return false;
+    } catch (error) {
+        console.error('Error removing MCPBrowser:', error);
+        throw error;
+    }
+}
+
+/**
+ * Check if MCPBrowser npm package is installed
+ */
+async function checkMcpBrowserInstalled() {
+    try {
+        const { exec } = require('child_process');
+        return new Promise((resolve) => {
+            exec('npm list -g mcpbrowser', (error, stdout, stderr) => {
+                // If package is found globally or locally, it will be in stdout
+                resolve(stdout.includes('mcpbrowser'));
+            });
+        });
+    } catch (error) {
+        return false;
+    }
+}
+
+/**
+ * Show notification to configure MCPBrowser
+ */
+async function showConfigurationPrompt(context) {
+    const configured = await isMcpBrowserConfigured();
+    
+    if (!configured) {
+        const action = await vscode.window.showInformationMessage(
+            'MCPBrowser is available! Would you like to configure it for GitHub Copilot?',
+            'Configure Now',
+            'Not Now',
+            "Don't Ask Again"
+        );
+
+        if (action === 'Configure Now') {
+            vscode.commands.executeCommand('mcpbrowser.configure');
+        } else if (action === "Don't Ask Again") {
+            // Store in workspace state to not show again
+            context.globalState.update('mcpbrowser.dontAskAgain', true);
+        }
+    }
+}
+
+/**
+ * Extension activation
+ */
+async function activate(context) {
+    console.log('MCPBrowser extension is now active');
+
+    // Register configure command
+    let configureCommand = vscode.commands.registerCommand('mcpbrowser.configure', async () => {
+        try {
+            const configured = await isMcpBrowserConfigured();
+            
+            if (configured) {
+                const action = await vscode.window.showWarningMessage(
+                    'MCPBrowser is already configured. Do you want to update it?',
+                    'Update',
+                    'Cancel'
+                );
+                
+                if (action !== 'Update') {
+                    return;
+                }
+            }
+            
+            // Step 1: Install npm package
+            const installed = await installMcpBrowser();
+            if (!installed) {
+                return; // Installation failed, abort
+            }
+            
+            // Step 2: Configure mcp.json
+            await configureMcpBrowser();
+            
+            const restart = await vscode.window.showInformationMessage(
+                '✓ MCPBrowser configured successfully! Restart VS Code to use it with GitHub Copilot.',
+                'Restart Now',
+                'Later'
+            );
+
+            if (restart === 'Restart Now') {
+                vscode.commands.executeCommand('workbench.action.reloadWindow');
+            }
+        } catch (error) {
+            vscode.window.showErrorMessage(
+                `Failed to configure MCPBrowser: ${error.message}`
+            );
+        }
+    });
+
+    // Register remove command
+    let removeCommand = vscode.commands.registerCommand('mcpbrowser.remove', async () => {
+        try {
+            const confirm = await vscode.window.showWarningMessage(
+                'Are you sure you want to remove MCPBrowser configuration?',
+                'Remove',
+                'Cancel'
+            );
+
+            if (confirm !== 'Remove') {
+                return;
+            }
+
+            const removed = await removeMcpBrowser();
+            
+            if (removed) {
+                vscode.window.showInformationMessage(
+                    '✓ MCPBrowser configuration removed. Restart VS Code for changes to take effect.'
+                );
+            } else {
+                vscode.window.showInformationMessage(
+                    'MCPBrowser was not configured.'
+                );
+            }
+        } catch (error) {
+            vscode.window.showErrorMessage(
+                `Failed to remove MCPBrowser: ${error.message}`
+            );
+        }
+    });
+
+    context.subscriptions.push(configureCommand);
+    context.subscriptions.push(removeCommand);
+
+    // Show configuration prompt if not already configured and user hasn't dismissed
+    const dontAskAgain = context.globalState.get('mcpbrowser.dontAskAgain', false);
+    if (!dontAskAgain) {
+        // Wait a bit after startup to not be intrusive
+        setTimeout(() => {
+            showConfigurationPrompt(context);
+        }, 5000);
+    }
+}
+
+/**
+ * Extension deactivation
+ */
+function deactivate() {}
+
+module.exports = {
+    activate,
+    deactivate
+};

package/package.json

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

package/server.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.cherchyk/browser",
+  "description": "Alternative web fetcher for authenticated and crawler-protected pages. Bypasses login requirements and anti-bot restrictions using Chrome DevTools Protocol",
+  "repository": {
+    "url": "https://github.com/cherchyk/MCPBrowser",
+    "source": "github"
+  },
+  "version": "0.2.1",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "mcpbrowser",
+      "version": "0.2.1",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}

package/src/mcp-browser.js

@@ -191,7 +191,7 @@ async function main() {
   const tools = [
     {
       name: "load_and_extract",
-      description: "Fetch and extract content from authenticated web pages using a local Chrome/Edge browser via DevTools Protocol. Automatically detects auth redirects by waiting for network idle. Supports smart tab reuse within the same domain to preserve authentication sessions. Returns both plain text and HTML content.",
+      description: "**FALLBACK MECHANISM**: Use this when normal URL fetching fails due to authentication requirements, login redirects, 401/403 errors, anti-crawler/bot detection, or session requirements. **FIRST ACCESS ONLY**: Ask user for confirmation ONLY if this is the first request to this domain/site - explain a browser window will open where they may need to authenticate. **SUBSEQUENT REQUESTS**: Use automatically without asking - browser session is already authenticated. Loads web pages using your authenticated Chrome/Edge browser session via DevTools Protocol, bypassing auth and crawler restrictions. Automatically handles auth redirects, waits for network idle, and supports tab reuse to preserve sessions. Returns both plain text and HTML content.",
       inputSchema: {
         type: "object",
         properties: {