@ricardodeazambuja/browser-mcp-server 1.0.3

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@ricardodeazambuja/browser-mcp-server",
+  "version": "1.0.3",
+  "description": "Universal browser automation MCP server using Playwright. Works with Antigravity, Claude Desktop, and any MCP client.",
+  "main": "browser-mcp-server-playwright.js",
+  "bin": {
+    "browser-mcp-server": "./browser-mcp-server-playwright.js"
+  },
+  "scripts": {
+    "start": "node browser-mcp-server-playwright.js",
+    "install-browsers": "npx playwright install chromium",
+    "test": "echo 'Testing MCP server...' && echo '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2024-11-05\",\"capabilities\":{},\"clientInfo\":{\"name\":\"test\",\"version\":\"1.0.0\"}}}' | node browser-mcp-server-playwright.js"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "browser-automation",
+    "playwright",
+    "claude",
+    "antigravity",
+    "web-automation",
+    "testing",
+    "scraping"
+  ],
+  "author": "Ricardo de Azambuja (https://ricardodeazambuja.com)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ricardodeazambuja/browser-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ricardodeazambuja/browser-mcp-server/issues"
+  },
+  "homepage": "https://github.com/ricardodeazambuja/browser-mcp-server#readme",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "playwright": "^1.57.0"
+  },
+  "files": [
+    "browser-mcp-server-playwright.js",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG-v1.0.2.md",
+    "test-mcp.js",
+    "test-browser-automation.js"
+  ]
+}

package/test-browser-automation.js

@@ -0,0 +1,189 @@
+#!/usr/bin/env node
+
+/**
+ * Comprehensive browser automation test
+ * Tests actual browser operations: navigate, evaluate JS, screenshot
+ */
+
+const { spawn } = require('child_process');
+const readline = require('readline');
+const fs = require('fs');
+
+let requestId = 0;
+let proc;
+
+function sendRequest(method, params = {}) {
+  const id = ++requestId;
+  const request = {
+    jsonrpc: '2.0',
+    id,
+    method,
+    params
+  };
+
+  console.log(`\n➡️  ${method}${params.name ? ` (${params.name})` : ''}`);
+  proc.stdin.write(JSON.stringify(request) + '\n');
+  return id;
+}
+
+async function runTests() {
+  console.log('🌐 Browser Automation Test Suite\n');
+  console.log('=' .repeat(60));
+
+  proc = spawn('node', ['browser-mcp-server-playwright.js'], {
+    stdio: ['pipe', 'pipe', 'pipe']
+  });
+
+  const rl = readline.createInterface({
+    input: proc.stdout,
+    crlfDelay: Infinity
+  });
+
+  let testStep = 0;
+  const tests = [
+    'Initialize',
+    'List Tools',
+    'Health Check',
+    'Navigate to Example.com',
+    'Evaluate JavaScript',
+    'Take Screenshot',
+    'Cleanup'
+  ];
+
+  rl.on('line', async (line) => {
+    try {
+      const response = JSON.parse(line);
+
+      if (response.id === undefined) return; // Skip notifications
+
+      const currentTest = tests[testStep];
+
+      if (response.error) {
+        console.log(`   ❌ ${currentTest} failed: ${response.error.message}`);
+        proc.kill();
+        process.exit(1);
+        return;
+      }
+
+      switch (response.id) {
+        case 1: // Initialize
+          console.log(`   ✅ ${currentTest}`);
+          testStep++;
+          setTimeout(() => sendRequest('tools/list'), 100);
+          break;
+
+        case 2: // Tools list
+          console.log(`   ✅ ${currentTest} (${response.result.tools.length} tools)`);
+          testStep++;
+          setTimeout(() => sendRequest('tools/call', {
+            name: 'browser_health_check',
+            arguments: {}
+          }), 100);
+          break;
+
+        case 3: // Health check
+          const healthText = response.result.content[0].text;
+          const mode = healthText.includes('Launched standalone')
+            ? 'Standalone Mode'
+            : 'Antigravity Mode';
+          console.log(`   ✅ ${currentTest} (${mode})`);
+          testStep++;
+
+          // Navigate to a real page
+          setTimeout(() => sendRequest('tools/call', {
+            name: 'browser_navigate',
+            arguments: { url: 'https://example.com' }
+          }), 100);
+          break;
+
+        case 4: // Navigate
+          console.log(`   ✅ ${currentTest}`);
+          testStep++;
+
+          // Evaluate some JavaScript
+          setTimeout(() => sendRequest('tools/call', {
+            name: 'browser_evaluate',
+            arguments: {
+              code: 'document.title + " - " + window.location.href'
+            }
+          }), 500);
+          break;
+
+        case 5: // Evaluate JS
+          const evalResult = JSON.parse(response.result.content[0].text);
+          console.log(`   ✅ ${currentTest}`);
+          console.log(`      Result: ${evalResult}`);
+          testStep++;
+
+          // Take a screenshot
+          setTimeout(() => sendRequest('tools/call', {
+            name: 'browser_screenshot',
+            arguments: { fullPage: false }
+          }), 500);
+          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)`);
+          testStep++;
+
+          // All tests complete
+          setTimeout(() => {
+            console.log('\n' + '='.repeat(60));
+            console.log('\n🎉 All browser automation tests passed!\n');
+            console.log('✅ Test Results:');
+            console.log('   • MCP protocol communication');
+            console.log('   • Browser launch (standalone mode)');
+            console.log('   • Page navigation (example.com)');
+            console.log('   • JavaScript evaluation');
+            console.log('   • Screenshot capture');
+            console.log('\n✨ The MCP server is fully functional!\n');
+
+            proc.kill();
+            process.exit(0);
+          }, 500);
+          break;
+      }
+    } catch (error) {
+      console.error(`\n❌ Error: ${error.message}`);
+      proc.kill();
+      process.exit(1);
+    }
+  });
+
+  proc.stderr.on('data', (data) => {
+    const msg = data.toString();
+    if (msg.toLowerCase().includes('error')) {
+      console.error(`⚠️  ${msg}`);
+    }
+  });
+
+  proc.on('close', (code) => {
+    if (code !== 0 && testStep < tests.length) {
+      console.error(`\n❌ Process exited unexpectedly (code ${code})`);
+      process.exit(code);
+    }
+  });
+
+  // Start test sequence
+  setTimeout(() => {
+    sendRequest('initialize', {
+      protocolVersion: '2024-11-05',
+      capabilities: {},
+      clientInfo: { name: 'automation-test', version: '1.0.0' }
+    });
+  }, 100);
+
+  // Timeout after 60 seconds
+  setTimeout(() => {
+    console.error('\n❌ Test timeout');
+    proc.kill();
+    process.exit(1);
+  }, 60000);
+}
+
+runTests().catch(error => {
+  console.error('❌ Fatal error:', error);
+  process.exit(1);
+});

package/test-mcp.js

@@ -0,0 +1,150 @@
+#!/usr/bin/env node
+
+/**
+ * Comprehensive test script for the browser MCP server
+ */
+
+const { spawn } = require('child_process');
+const readline = require('readline');
+
+let requestId = 0;
+
+function sendRequest(proc, method, params = {}) {
+  const id = ++requestId;
+  const request = {
+    jsonrpc: '2.0',
+    id,
+    method,
+    params
+  };
+
+  console.log(`\n➡️  Sending: ${method}`);
+  proc.stdin.write(JSON.stringify(request) + '\n');
+  return id;
+}
+
+function sendNotification(proc, method, params = {}) {
+  const notification = {
+    jsonrpc: '2.0',
+    method,
+    params
+  };
+
+  console.log(`\n➡️  Sending notification: ${method}`);
+  proc.stdin.write(JSON.stringify(notification) + '\n');
+}
+
+async function runTests() {
+  console.log('🧪 Starting MCP Server Tests\n');
+  console.log('=' .repeat(50));
+
+  const proc = spawn('node', ['browser-mcp-server-playwright.js'], {
+    stdio: ['pipe', 'pipe', 'pipe']
+  });
+
+  const rl = readline.createInterface({
+    input: proc.stdout,
+    crlfDelay: Infinity
+  });
+
+  const responses = new Map();
+  let testsCompleted = 0;
+  const totalTests = 3;
+
+  rl.on('line', (line) => {
+    try {
+      const response = JSON.parse(line);
+      console.log(`\n⬅️  Response (id=${response.id}):`);
+
+      if (response.error) {
+        console.log(`   ❌ Error: ${response.error.message}`);
+      } else if (response.result) {
+        if (response.id === 1) {
+          // Initialize response
+          console.log(`   ✅ Protocol: ${response.result.protocolVersion}`);
+          console.log(`   ✅ Server: ${response.result.serverInfo.name} v${response.result.serverInfo.version}`);
+          testsCompleted++;
+
+          // Send initialized notification
+          sendNotification(proc, 'notifications/initialized');
+
+          // Request tools list
+          setTimeout(() => sendRequest(proc, 'tools/list'), 100);
+
+        } else if (response.id === 2) {
+          // Tools list response
+          const toolCount = response.result.tools.length;
+          console.log(`   ✅ Received ${toolCount} tools:`);
+          response.result.tools.forEach(tool => {
+            console.log(`      - ${tool.name}`);
+          });
+          testsCompleted++;
+
+          // Test health check (actual browser operation)
+          setTimeout(() => sendRequest(proc, 'tools/call', {
+            name: 'browser_health_check',
+            arguments: {}
+          }), 100);
+
+        } else if (response.id === 3) {
+          // Health check response
+          if (response.result.content && response.result.content[0]) {
+            console.log(`   ✅ Health Check Result:`);
+            console.log(response.result.content[0].text.split('\n').map(l => `      ${l}`).join('\n'));
+          }
+          testsCompleted++;
+
+          // All tests done
+          setTimeout(() => {
+            console.log('\n' + '='.repeat(50));
+            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('   ✅ Browser automation (health check)');
+            console.log('\n🎉 MCP Server is fully functional!\n');
+            proc.kill();
+            process.exit(0);
+          }, 500);
+        }
+      }
+    } catch (error) {
+      console.error('❌ Error parsing response:', error.message);
+    }
+  });
+
+  proc.stderr.on('data', (data) => {
+    const msg = data.toString();
+    if (msg.includes('Error') || msg.includes('error')) {
+      console.error(`\n⚠️  stderr: ${msg}`);
+    }
+  });
+
+  proc.on('close', (code) => {
+    if (code !== 0 && testsCompleted < totalTests) {
+      console.error(`\n❌ Process exited with code ${code}`);
+      process.exit(code);
+    }
+  });
+
+  // Start the test sequence
+  setTimeout(() => {
+    sendRequest(proc, 'initialize', {
+      protocolVersion: '2024-11-05',
+      capabilities: {},
+      clientInfo: { name: 'test-client', version: '1.0.0' }
+    });
+  }, 100);
+
+  // Safety timeout
+  setTimeout(() => {
+    console.error('\n❌ Test timeout - tests did not complete in time');
+    proc.kill();
+    process.exit(1);
+  }, 30000); // 30 second timeout
+}
+
+runTests().catch(error => {
+  console.error('❌ Test failed:', error);
+  process.exit(1);
+});