@ricardodeazambuja/browser-mcp-server 1.0.3 → 1.3.0

package/{test-browser-automation.js → tests/test-browser-automation.js}

@@ -8,6 +8,7 @@
 const { spawn } = require('child_process');
 const readline = require('readline');
 const fs = require('fs');
+const path = require('path');
 
 let requestId = 0;
 let proc;
@@ -28,9 +29,10 @@ function sendRequest(method, params = {}) {
 
 async function runTests() {
   console.log('🌐 Browser Automation Test Suite\n');
-  console.log('=' .repeat(60));
+  console.log('='.repeat(60));
 
-  proc = spawn('node', ['browser-mcp-server-playwright.js'], {
+  const serverPath = path.join(__dirname, '..', 'src', 'index.js');
+  proc = spawn('node', [serverPath], {
     stdio: ['pipe', 'pipe', 'pipe']
   });
 
@@ -47,6 +49,9 @@ async function runTests() {
     'Navigate to Example.com',
     'Evaluate JavaScript',
     'Take Screenshot',
+    'Open New Page',
+    'List Pages',
+    'Wait',
     'Cleanup'
   ];
 
@@ -123,9 +128,41 @@ async function runTests() {
           break;
 
         case 6: // Screenshot
-          const imgData = response.result.content[0].data;
-          const imgSize = Buffer.from(imgData, 'base64').length;
-          console.log(`   ✅ ${currentTest} (${(imgSize / 1024).toFixed(1)} KB)`);
+          console.log(`   ✅ ${currentTest}`);
+          testStep++;
+
+          // Open new page
+          setTimeout(() => sendRequest('tools/call', {
+            name: 'browser_new_page',
+            arguments: { url: 'https://google.com' }
+          }), 100);
+          break;
+
+        case 7: // New Page
+          console.log(`   ✅ ${currentTest}`);
+          testStep++;
+
+          // List pages
+          setTimeout(() => sendRequest('tools/call', {
+            name: 'browser_list_pages',
+            arguments: {}
+          }), 100);
+
+          break;
+
+        case 8: // List Pages
+          console.log(`   ✅ ${currentTest}`);
+          testStep++;
+
+          // Wait
+          setTimeout(() => sendRequest('tools/call', {
+            name: 'browser_wait',
+            arguments: { ms: 500 }
+          }), 100);
+          break;
+
+        case 9: // Wait
+          console.log(`   ✅ ${currentTest}`);
           testStep++;
 
           // All tests complete
@@ -138,6 +175,8 @@ async function runTests() {
             console.log('   • Page navigation (example.com)');
             console.log('   • JavaScript evaluation');
             console.log('   • Screenshot capture');
+            console.log('   • Multi-page management');
+            console.log('   • Wait utility');
             console.log('\n✨ The MCP server is fully functional!\n');
 
             proc.kill();

package/{test-mcp.js → tests/test-mcp.js}

@@ -6,6 +6,7 @@
 
 const { spawn } = require('child_process');
 const readline = require('readline');
+const path = require('path');
 
 let requestId = 0;
 
@@ -36,9 +37,10 @@ function sendNotification(proc, method, params = {}) {
 
 async function runTests() {
   console.log('🧪 Starting MCP Server Tests\n');
-  console.log('=' .repeat(50));
+  console.log('='.repeat(50));
 
-  const proc = spawn('node', ['browser-mcp-server-playwright.js'], {
+  const serverPath = path.join(__dirname, '..', 'src', 'index.js');
+  const proc = spawn('node', [serverPath], {
     stdio: ['pipe', 'pipe', 'pipe']
   });
 
@@ -100,7 +102,9 @@ async function runTests() {
             console.log(`\n✅ All tests passed! (${testsCompleted}/${totalTests})`);
             console.log('\n📊 Test Summary:');
             console.log('   ✅ MCP Protocol initialization');
-            console.log('   ✅ Tools listing (16 tools)');
+            console.log('   ✅ Tools listing (37 tools)');
+
+
             console.log('   ✅ Browser automation (health check)');
             console.log('\n🎉 MCP Server is fully functional!\n');
             proc.kill();

package/tests/test-media-tools.js

@@ -0,0 +1,168 @@
+#!/usr/bin/env node
+
+/**
+ * Media Awareness Test Suite
+ * Tests browser_get_media_summary, browser_control_media, browser_get_audio_analysis
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+const readline = require('readline');
+
+const serverPath = path.join(__dirname, '..', 'src', 'index.js');
+const proc = spawn('node', [serverPath], { stdio: ['pipe', 'pipe', 'pipe'] });
+
+proc.stderr.on('data', (data) => {
+    console.error(data.toString().trim());
+});
+
+proc.on('error', (err) => {
+    console.error('Server error:', err);
+    process.exit(1);
+});
+
+const rl = readline.createInterface({ input: proc.stdout, terminal: false });
+
+let messageId = 1;
+let testStep = 0;
+
+function sendRequest(method, params) {
+    const request = { jsonrpc: '2.0', id: messageId++, method, params };
+    proc.stdin.write(JSON.stringify(request) + '\n');
+}
+
+console.log('🌐 Media Awareness Test Suite\n');
+
+rl.on('line', (line) => {
+    try {
+        const response = JSON.parse(line);
+        if (response.method === 'notifications/resources/list_changed') return;
+        if (response.error) {
+            console.error('❌ Error:', response.error.message);
+            process.exit(1);
+        }
+        if (response.result && response.id) {
+            handleResponse(response);
+        }
+    } catch (e) {
+        // Ignore non-JSON lines
+    }
+});
+
+function handleResponse(response) {
+    const currentTest = steps[testStep];
+    if (!currentTest) return;
+
+    console.log(`➡️  ${currentTest.name}`);
+
+    try {
+        currentTest.verify(response);
+        console.log(`   ✅ Passed\n`);
+    } catch (err) {
+        console.error(`   ❌ Failed: ${err.message}`);
+        process.exit(1);
+    }
+
+    testStep++;
+    if (testStep < steps.length) {
+        setTimeout(() => {
+            sendRequest(steps[testStep].method, steps[testStep].params());
+        }, 500);
+    } else {
+        console.log('🎉 All media tests passed!');
+        proc.kill();
+        process.exit(0);
+    }
+}
+
+const steps = [
+    {
+        name: 'Initialize',
+        method: 'initialize',
+        params: () => ({
+            protocolVersion: '2024-11-05',
+            capabilities: {},
+            clientInfo: { name: 'test-suite', version: '1.0.0' }
+        }),
+        verify: () => { }
+    },
+    {
+        name: 'Navigate to Local Media Test',
+        method: 'tools/call',
+        params: () => ({
+            name: 'browser_navigate',
+            arguments: { url: 'file://' + path.join(__dirname, 'fixtures', 'test-media.html') }
+        }),
+        verify: () => { }
+    },
+    {
+        name: 'Wait for Audio Element',
+        method: 'tools/call',
+        params: () => ({
+            name: 'browser_wait_for_selector',
+            arguments: { selector: 'audio', timeout: 10000 }
+        }),
+        verify: () => { }
+    },
+    {
+        name: 'Get Media Summary',
+        method: 'tools/call',
+        params: () => ({
+            name: 'browser_get_media_summary',
+            arguments: {}
+        }),
+        verify: (res) => {
+            const summary = JSON.parse(res.result.content[0].text);
+            console.log(`      Found ${summary.length} media element(s)`);
+            if (!Array.isArray(summary)) throw new Error('Result is not an array');
+        }
+    },
+    {
+        name: 'Play Media',
+        method: 'tools/call',
+        params: () => ({
+            name: 'browser_control_media',
+            arguments: { selector: 'audio', action: 'play' }
+        }),
+        verify: (res) => {
+            const result = JSON.parse(res.result.content[0].text);
+            if (result.status !== 'playing') throw new Error('Failed to play');
+        }
+    },
+    {
+        name: 'Wait for Playback',
+        method: 'tools/call',
+        params: () => ({
+            name: 'browser_wait',
+            arguments: { ms: 1000 }
+        }),
+        verify: () => { }
+    },
+    {
+        name: 'Analyze Audio',
+        method: 'tools/call',
+        params: () => ({
+            name: 'browser_get_audio_analysis',
+            arguments: { durationMs: 500 }
+        }),
+        verify: (res) => {
+            const analysis = JSON.parse(res.result.content[0].text);
+            if (typeof analysis.averageVolume !== 'number') throw new Error('Invalid analysis');
+        }
+    },
+    {
+        name: 'Pause Media',
+        method: 'tools/call',
+        params: () => ({
+            name: 'browser_control_media',
+            arguments: { selector: 'audio', action: 'pause' }
+        }),
+        verify: (res) => {
+            const result = JSON.parse(res.result.content[0].text);
+            if (result.status !== 'paused') throw new Error('Failed to pause');
+        }
+    }
+];
+
+// Start tests
+setTimeout(() => sendRequest(steps[0].method, steps[0].params()), 500);

package/CHANGELOG-v1.0.2.md

@@ -1,126 +0,0 @@
-# Changelog - Version 1.0.2
-
-## Release Date
-2025-12-26
-
-## Summary
-Enhanced browser detection and standalone mode support. The MCP server now intelligently searches for and uses system Chrome/Chromium installations, eliminating the need for redundant browser downloads.
-
-## New Features
-
-### 1. Smart Chrome/Chromium Detection
-- **New function**: `findChromeExecutable()` searches for Chrome/Chromium in common system locations
-- **Search locations**:
-  - Linux: `/usr/bin/google-chrome`, `/usr/bin/chromium`, `/usr/bin/chromium-browser`, `/snap/bin/chromium`
-  - macOS: `/Applications/Google Chrome.app`, `/Applications/Chromium.app`
-  - Windows: `C:\Program Files\Google\Chrome\Application\chrome.exe`
-  - Also uses `which` command as fallback on Unix systems
-
-### 2. Three-Tier Browser Strategy
-The server now tries browsers in this order:
-1. **Antigravity Mode**: Connect to existing Chrome on port 9222 (if available)
-2. **System Browser**: Use system-installed Chrome/Chromium (if found)
-3. **Playwright Chromium**: Fall back to Playwright's Chromium (if installed)
-
-### 3. Improved Error Messages
-When no browser is found, users get clear, actionable instructions:
-
-```
-❌ No Chrome/Chromium browser found!
-
-This MCP server needs a Chrome or Chromium browser to work.
-
-Option 1 - Install Chrome/Chromium on your system:
-  • Ubuntu/Debian: sudo apt install google-chrome-stable
-  • Ubuntu/Debian: sudo apt install chromium-browser
-  • Fedora: sudo dnf install google-chrome-stable
-  • macOS: brew install --cask google-chrome
-  • Or download from: https://www.google.com/chrome/
-
-Option 2 - Install Playwright's Chromium:
-  npm install playwright
-  npx playwright install chromium
-
-Option 3 - Use with Antigravity:
-  Open Antigravity and click the Chrome logo (top right) to start the browser.
-  This MCP server will automatically connect to it.
-```
-
-## Bug Fixes
-
-### 1. Browser Reconnection
-- Fixed browser disconnection detection
-- Improved reconnection logic after browser crashes or closures
-
-## Changes
-
-### package.json
-- Moved Playwright from `peerDependencies` to `dependencies` (^1.57.0)
-- Removed `postinstall` script (no longer auto-installs Chromium)
-- Users can now choose: system Chrome, Chromium, or Playwright Chromium
-
-### browser-mcp-server-playwright.js
-- Added `findChromeExecutable()` function (+43 lines)
-- Enhanced browser launch logic with Chrome detection
-- Improved error handling with context-aware messages
-- Better debug logging for troubleshooting
-
-## Benefits
-
-✅ **No Redundant Downloads**: Uses existing Chrome/Chromium installations
-✅ **Disk Space Savings**: Avoids downloading ~275MB Playwright Chromium if system browser exists
-✅ **Faster Installation**: No browser download during npm install
-✅ **Better UX**: Clear error messages guide users to solutions
-✅ **Flexible**: Works with Antigravity, system browsers, OR Playwright Chromium
-✅ **Cross-Platform**: Supports Linux, macOS, and Windows
-
-## Compatibility
-
-- **Node.js**: >=16.0.0
-- **Playwright**: ^1.57.0
-- **Browsers**: Chrome, Chromium, or Playwright Chromium
-
-## Testing
-
-All 16 browser automation tools tested and verified:
-- ✅ browser_navigate
-- ✅ browser_click
-- ✅ browser_screenshot
-- ✅ browser_get_text
-- ✅ browser_type
-- ✅ browser_evaluate
-- ✅ browser_wait_for_selector
-- ✅ browser_scroll
-- ✅ browser_resize_window
-- ✅ browser_get_dom
-- ✅ browser_start_video_recording
-- ✅ browser_stop_video_recording
-- ✅ browser_health_check
-- ✅ browser_console_start
-- ✅ browser_console_get
-- ✅ browser_console_clear
-
-## Migration Guide
-
-### From v1.0.1 to v1.0.2
-
-**No action required!** The update is fully backward compatible.
-
-**If you had Playwright Chromium installed:**
-- It will still work as a fallback
-- But the server will prefer your system Chrome/Chromium if available
-
-**If you didn't have any browser:**
-- The new error messages will guide you through installation options
-- Choose the option that works best for your system
-
-## Debug Logs
-
-Server logs are written to: `/tmp/mcp-browser-server.log`
-
-Example log output:
-```
-Found Chrome at: /usr/bin/google-chrome
-Using system Chrome/Chromium: /usr/bin/google-chrome
-✅ Successfully launched new Chrome instance (Standalone mode)
-```