brave-real-browser-mcp-server 2.12.12 → 2.14.0

package/dist/handlers/interaction-handlers.js

@@ -167,6 +167,68 @@ export async function handleType(args) {
         }, 'Failed to type text');
     });
 }
+// Press key handler
+export async function handlePressKey(args) {
+    return await withWorkflowValidation('press_key', args, async () => {
+        return await withErrorHandling(async () => {
+            const pageInstance = getPageInstance();
+            if (!pageInstance) {
+                throw new Error('Browser not initialized. Call browser_init first.');
+            }
+            const { key, selector, modifiers = [] } = args;
+            try {
+                // If selector is provided, focus on element first
+                if (selector) {
+                    const elementResult = await selfHealingLocators.findElementWithFallbacks(pageInstance, selector);
+                    if (elementResult) {
+                        await elementResult.element.focus();
+                    }
+                    else {
+                        console.warn(`Element not found: ${selector}, pressing key on current focus`);
+                    }
+                }
+                // Press key with modifiers if specified
+                if (modifiers.length > 0) {
+                    // Hold down modifiers
+                    for (const modifier of modifiers) {
+                        await pageInstance.keyboard.down(modifier);
+                    }
+                    // Press the main key
+                    await pageInstance.keyboard.press(key);
+                    // Release modifiers
+                    for (const modifier of modifiers.reverse()) {
+                        await pageInstance.keyboard.up(modifier);
+                    }
+                    const modifierStr = modifiers.join('+');
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Pressed key combination: ${modifierStr}+${key}${selector ? ` on element: ${selector}` : ''}\n\n✅ Keyboard interaction completed successfully`,
+                            },
+                        ],
+                    };
+                }
+                else {
+                    // Simple key press without modifiers
+                    await pageInstance.keyboard.press(key);
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: `Pressed key: ${key}${selector ? ` on element: ${selector}` : ''}\n\n✅ Keyboard interaction completed successfully`,
+                            },
+                        ],
+                    };
+                }
+            }
+            catch (pressError) {
+                throw new Error(`Failed to press key: ${key}. ` +
+                    `Error: ${pressError instanceof Error ? pressError.message : String(pressError)}`);
+            }
+        }, 'Failed to press key');
+    });
+}
 // Solve captcha handler
 export async function handleSolveCaptcha(args) {
     return await withErrorHandling(async () => {

package/dist/mcp-server.js

@@ -5,7 +5,7 @@ import { validateMCPResponse } from './mcp-response-validator.js';
 // Import handlers
 import { handleBrowserInit, handleBrowserClose } from './handlers/browser-handlers.js';
 import { handleNavigate, handleWait } from './handlers/navigation-handlers.js';
-import { handleClick, handleType, handleSolveCaptcha, handleRandomScroll } from './handlers/interaction-handlers.js';
+import { handleClick, handleType, handlePressKey, handleSolveCaptcha, handleRandomScroll } from './handlers/interaction-handlers.js';
 import { handleGetContent, handleFindSelector } from './handlers/content-handlers.js';
 import { handleSaveContentAsMarkdown } from './handlers/file-handlers.js';
 import { handleScrapeTable, handleExtractList, handleExtractJSON, handleScrapeMetaTags, handleExtractSchema } from './handlers/data-extraction-handlers.js';
@@ -54,6 +54,9 @@ export async function createMcpServer() {
                 case TOOL_NAMES.TYPE:
                     result = await handleType(args);
                     break;
+                case TOOL_NAMES.PRESS_KEY:
+                    result = await handlePressKey(args);
+                    break;
                 case TOOL_NAMES.WAIT:
                     result = await handleWait(args);
                     break;

package/dist/tool-definitions.js

@@ -172,6 +172,33 @@ export const TOOLS = [
             required: ['selector', 'text'],
         },
     },
+    {
+        name: 'press_key',
+        description: 'Press keyboard keys (Enter, Tab, Escape, Arrow keys, etc.) - Useful for form submission, navigation, and keyboard shortcuts',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                key: {
+                    type: 'string',
+                    description: 'Key to press. Common keys: Enter, Tab, Escape, Backspace, Delete, ArrowUp, ArrowDown, ArrowLeft, ArrowRight, Space, PageUp, PageDown, Home, End, F1-F12',
+                    enum: ['Enter', 'Tab', 'Escape', 'Backspace', 'Delete', 'Space', 'ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight', 'PageUp', 'PageDown', 'Home', 'End', 'F1', 'F2', 'F3', 'F4', 'F5', 'F6', 'F7', 'F8', 'F9', 'F10', 'F11', 'F12'],
+                },
+                selector: {
+                    type: 'string',
+                    description: 'Optional: CSS selector of element to focus before pressing key',
+                },
+                modifiers: {
+                    type: 'array',
+                    description: 'Optional: Modifier keys to hold (Ctrl, Shift, Alt, Meta)',
+                    items: {
+                        type: 'string',
+                        enum: ['Control', 'Shift', 'Alt', 'Meta'],
+                    },
+                },
+            },
+            required: ['key'],
+        },
+    },
     {
         name: 'wait',
         description: 'Wait for various conditions',
@@ -1480,6 +1507,7 @@ export const TOOL_NAMES = {
     GET_CONTENT: 'get_content',
     CLICK: 'click',
     TYPE: 'type',
+    PRESS_KEY: 'press_key',
     WAIT: 'wait',
     BROWSER_CLOSE: 'browser_close',
     SOLVE_CAPTCHA: 'solve_captcha',
@@ -1554,6 +1582,6 @@ export const TOOL_NAMES = {
 export const TOOL_CATEGORIES = {
     BROWSER_MANAGEMENT: [TOOL_NAMES.BROWSER_INIT, TOOL_NAMES.BROWSER_CLOSE],
     NAVIGATION: [TOOL_NAMES.NAVIGATE, TOOL_NAMES.WAIT],
-    INTERACTION: [TOOL_NAMES.CLICK, TOOL_NAMES.TYPE, TOOL_NAMES.SOLVE_CAPTCHA, TOOL_NAMES.RANDOM_SCROLL],
+    INTERACTION: [TOOL_NAMES.CLICK, TOOL_NAMES.TYPE, TOOL_NAMES.PRESS_KEY, TOOL_NAMES.SOLVE_CAPTCHA, TOOL_NAMES.RANDOM_SCROLL],
     CONTENT: [TOOL_NAMES.GET_CONTENT, TOOL_NAMES.FIND_SELECTOR, TOOL_NAMES.SAVE_CONTENT_AS_MARKDOWN],
 };

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "brave-real-browser-mcp-server",
-  "version": "2.12.12",
+  "version": "2.14.0",
   "description": "Universal AI IDE MCP Server - Auto-detects and supports all AI IDEs (Claude Desktop, Cursor, Windsurf, Cline, Zed, VSCode, Qoder AI, etc.) with Brave browser automation",
   "type": "module",
   "main": "dist/index.js",
   "scripts": {
+    "preinstall": "npm view brave-real-puppeteer-core version > .latest-version 2>&1 || echo 'Version check skipped'",
     "postinstall": "node scripts/patch-puppeteer-screen-recorder.cjs && node scripts/update-to-latest.cjs || echo 'Auto-update skipped'",
     "clean": "rimraf dist",
     "clean:cache": "npm cache clean --force",
@@ -133,12 +134,33 @@
     "linux",
     "win32"
   ],
+  "resolutions": {
+    "puppeteer": "npm:brave-real-puppeteer-core@latest",
+    "puppeteer-core": "npm:brave-real-puppeteer-core@latest",
+    "**/puppeteer": "npm:brave-real-puppeteer-core@latest",
+    "**/puppeteer-core": "npm:brave-real-puppeteer-core@latest"
+  },
   "overrides": {
     "puppeteer": "npm:brave-real-puppeteer-core@latest",
     "puppeteer-core": "npm:brave-real-puppeteer-core@latest",
     "puppeteer-screen-recorder": {
       "puppeteer": "npm:brave-real-puppeteer-core@latest",
-      "fluent-ffmpeg": "latest"
+      "puppeteer-core": "npm:brave-real-puppeteer-core@latest",
+      "fluent-ffmpeg": "latest",
+      "glob": "latest",
+      "rimraf": "latest"
+    },
+    "brave-real-browser": {
+      "puppeteer": "npm:brave-real-puppeteer-core@latest",
+      "puppeteer-core": "npm:brave-real-puppeteer-core@latest"
+    },
+    "tesseract.js": {
+      "puppeteer": "npm:brave-real-puppeteer-core@latest",
+      "puppeteer-core": "npm:brave-real-puppeteer-core@latest"
+    },
+    "*": {
+      "puppeteer": "npm:brave-real-puppeteer-core@latest",
+      "puppeteer-core": "npm:brave-real-puppeteer-core@latest"
     },
     "fluent-ffmpeg": "latest",
     "glob": "latest",

package/scripts/patch-puppeteer-screen-recorder.cjs

@@ -35,17 +35,18 @@ try {
   // Check if patch is needed
   if (packageJson.peerDependencies && packageJson.peerDependencies.puppeteer) {
     const currentValue = packageJson.peerDependencies.puppeteer;
+    const targetValue = 'npm:brave-real-puppeteer-core@latest';
     
-    // Only patch if it's the old version
-    if (currentValue === '19.0.0' || !currentValue.includes('brave-real-puppeteer-core')) {
-      // Update to brave-real-puppeteer-core
-      packageJson.peerDependencies.puppeteer = 'npm:brave-real-puppeteer-core@>=24.0.0';
+    // Always update to ensure it's using @latest tag (not @>=24.0.0)
+    if (currentValue !== targetValue) {
+      // Update to brave-real-puppeteer-core with latest tag
+      packageJson.peerDependencies.puppeteer = targetValue;
       
       // Write back to file
       fs.writeFileSync(packagePath, JSON.stringify(packageJson, null, 2), 'utf8');
       
       console.log('   ✓ puppeteer-screen-recorder patched successfully');
-      console.log('   ✓ peerDependencies.puppeteer: npm:brave-real-puppeteer-core@>=24.0.0');
+      console.log('   ✓ peerDependencies.puppeteer: npm:brave-real-puppeteer-core@latest');
     } else {
       console.log('   ✓ puppeteer-screen-recorder already patched');
     }

package/scripts/update-to-latest.cjs

@@ -54,7 +54,11 @@ try {
   for (const pkg of packagesToUpdate) {
     try {
       console.log(`   Updating ${pkg}...`);
-      execSync(`npm install ${pkg}@latest --save --no-audit --no-fund`, {
+      
+      // Force update for brave-real-puppeteer-core
+      const forceFlag = pkg === 'brave-real-puppeteer-core' ? '--force' : '';
+      
+      execSync(`npm install ${pkg}@latest --save --no-audit --no-fund ${forceFlag}`, {
         stdio: 'pipe',
         cwd: process.cwd()
       });
@@ -76,7 +80,13 @@ try {
       });
       const parsed = JSON.parse(version);
       const installedVersion = parsed.dependencies?.[pkg]?.version || 'not found';
-      console.log(`   ${pkg}: ${installedVersion}`);
+      
+      // Show 'latest' for brave-real-puppeteer-core
+      if (pkg === 'brave-real-puppeteer-core') {
+        console.log(`   ${pkg}: ${installedVersion} (latest)`);
+      } else {
+        console.log(`   ${pkg}: ${installedVersion}`);
+      }
     } catch (error) {
       // Ignore errors
     }