@ricardodeazambuja/browser-mcp-server 1.3.0 → 1.4.0

package/CHANGELOG-v1.4.0.md

@@ -0,0 +1,8 @@
+# Changelog - v1.4.0 (2026-01-01)
+
+- ✅ **Full Power User Suite**: Added 26 CDP-based tools for performance, network, security, and storage analysis (63 tools total)
+- ✅ **Version Unification**: Centralized version management to use `package.json` as the single source of truth
+- ✅ **Performance Profiling**: Added CPU profiling, heap snapshots, and web vitals monitoring
+- ✅ **Network Analysis**: Added request monitoring, HAR export, and WebSocket inspection
+- ✅ **Security Testing**: Added security header inspection, CSP monitoring, and certificate details
+- ✅ **Storage Inspection**: Added IndexedDB, Cache Storage, and Service Worker management

package/README.md

@@ -2,14 +2,14 @@
 
 A universal browser automation MCP server using Playwright. Control Chrome programmatically through the Model Context Protocol.
 
-**37 powerful browser automation tools** including multi-tab management, media monitoring/control, low-level interaction, session recording, and on-demand documentation.
+**63 powerful browser automation tools** including multi-tab management, media monitoring/control, low-level interaction, session recording, CDP-based performance profiling, network analysis, security testing, and on-demand documentation.
 
 ## Features
 
 - ✅ **Smart Chrome Detection**: Automatically finds and uses system Chrome/Chromium
 - ✅ **Three-Tier Strategy**: Antigravity Chrome → System Chrome → Playwright Chromium
 - ✅ **Universal**: Works with Antigravity, Claude Desktop, and any MCP client
-- ✅ **37 Tools**: Media control, multi-tab, pixel-based interaction, and more
+- ✅ **63 Tools**: Media control, multi-tab, pixel-based interaction, CDP power user tools, and more
 - ✅ **On-Demand Docs**: Built-in documentation tool with return schemas and examples
 - ✅ **Auto-Install**: Playwright installed automatically via npm (no manual setup)
 - ✅ **Safe**: Isolated browser profile (won't touch your personal Chrome)
@@ -253,7 +253,7 @@ gemini mcp add --timeout 30000 browser node /path/to/src/index.js
 gemini mcp add --trust browser node /path/to/src/index.js
 ```
 
-## Available Tools (37)
+## Available Tools (63)
 
 ### Documentation
 1. **browser_docs(toolName?)** - Get detailed docs, return schemas, examples, and caveats for any tool
@@ -308,6 +308,79 @@ gemini mcp add --trust browser node /path/to/src/index.js
 36. **browser_stop_video_recording()** - Stop and save recording
 37. **browser_health_check()** - Verify browser connection
 
+## 🔬 Power User Tools (CDP-Based)
+
+Advanced diagnostic tools using Chrome DevTools Protocol for performance analysis, network debugging, security testing, and storage inspection. These 26 additional tools provide deep insights into browser internals.
+
+### Performance Profiling (8 tools)
+38. **browser_perf_start_profile(sampleInterval?)** - Start CPU profiling
+39. **browser_perf_stop_profile()** - Get CPU profile data with summary
+40. **browser_perf_take_heap_snapshot(reportProgress?)** - Capture memory snapshot
+41. **browser_perf_get_heap_usage()** - Current JavaScript heap statistics
+42. **browser_perf_get_metrics()** - Runtime metrics (DOM nodes, listeners, etc.)
+43. **browser_perf_get_performance_metrics()** - Web vitals (FCP, LCP, CLS, TTFB)
+44. **browser_perf_start_coverage(resetOnNavigation?)** - Track code coverage
+45. **browser_perf_stop_coverage()** - Get coverage results
+
+**Use Cases**: Memory leak detection, CPU profiling, performance optimization, code coverage analysis, web vitals monitoring
+
+### Network Analysis (7 tools)
+46. **browser_net_start_monitoring(patterns?)** - Monitor network requests
+47. **browser_net_get_requests(filter?)** - Get captured requests with timing
+48. **browser_net_stop_monitoring()** - Stop monitoring and clear log
+49. **browser_net_export_har(includeContent?)** - Export HTTP Archive log
+50. **browser_net_get_websocket_frames(requestId)** - Inspect WebSocket frames
+51. **browser_net_set_request_blocking(patterns)** - Block URL patterns
+52. **browser_net_emulate_conditions(offline, latency, download, upload)** - Network throttling
+
+**Use Cases**: API debugging, HAR export, WebSocket debugging, performance testing, request blocking, network throttling
+
+### Security Testing (6 tools)
+53. **browser_sec_get_security_headers()** - Inspect security HTTP headers
+54. **browser_sec_get_certificate_info()** - TLS/SSL certificate details
+55. **browser_sec_detect_mixed_content()** - Find HTTP resources on HTTPS pages
+56. **browser_sec_start_csp_monitoring()** - Monitor CSP violations
+57. **browser_sec_get_csp_violations()** - Get violation log
+58. **browser_sec_stop_csp_monitoring()** - Stop monitoring
+
+**Use Cases**: Security audits, CSP debugging, HTTPS migration, certificate validation, mixed content detection
+
+### Storage & Service Workers (5 tools)
+59. **browser_storage_get_indexeddb(databaseName?, objectStoreName?)** - Inspect IndexedDB
+60. **browser_storage_get_cache_storage(cacheName?)** - List Cache Storage entries
+61. **browser_storage_delete_cache(cacheName)** - Delete cache
+62. **browser_storage_get_service_workers()** - Service worker state
+63. **browser_storage_unregister_service_worker(scopeURL)** - Unregister worker
+
+**Use Cases**: IndexedDB inspection, Cache Storage management, Service Worker debugging, offline functionality testing
+
+### Getting Started with CDP Tools
+
+```javascript
+// Start CPU profiling
+browser_perf_start_profile({})
+// ... perform actions to profile ...
+browser_perf_stop_profile({})  // Get results
+
+// Monitor network activity
+browser_net_start_monitoring({})
+// ... navigate and interact ...
+browser_net_get_requests({ filter: 'api' })
+browser_net_export_har({})
+
+// Security audit
+browser_sec_get_security_headers({})
+browser_sec_start_csp_monitoring({})
+// ... trigger violations ...
+browser_sec_get_csp_violations({})
+
+// Inspect storage
+browser_storage_get_indexeddb({ databaseName: 'myDB' })
+browser_storage_get_cache_storage({ cacheName: 'my-cache-v1' })
+```
+
+**Note**: All CDP tools have comprehensive documentation available via `browser_docs({ toolName: 'browser_perf_start_profile' })`.
+
 ## On-Demand Documentation
 
 The `browser_docs` tool provides comprehensive documentation for all browser tools **without increasing token overhead** in normal operations.
@@ -423,7 +496,7 @@ browser_docs(toolName: "browser_get_audio_analysis")
 // ⚠️ Important: Requires CORS headers for cross-origin media
 
 // List all tools:
-browser_docs()  // Shows all 37 tools
+browser_docs()  // Shows all 63 tools
 ```
 
 ## How It Works
@@ -646,7 +719,7 @@ Check `/tmp/mcp-browser-server.log` for detailed logs:
 ## Comparison with Other Tools
 
 ### vs. Puppeteer MCP Servers
-- ✅ More tools (37 vs typical 8-10)
+- ✅ More tools (63 vs typical 8-10)
 - ✅ Console capture built-in
 - ✅ Better error messages
 - ✅ Hybrid mode (connect OR launch)
@@ -689,7 +762,15 @@ MIT License - see LICENSE file
 
 ## Changelog
 
-### v1.3.0 (2025-12-27) ⭐ NEW
+### v1.4.0 (2026-01-01) ⭐ NEW
+- ✅ **Full Power User Suite**: Added 26 CDP-based tools for performance, network, security, and storage analysis (63 tools total)
+- ✅ **Version Unification**: Centralized version management to use `package.json` as the single source of truth
+- ✅ **Performance Profiling**: Added CPU profiling, heap snapshots, and web vitals monitoring
+- ✅ **Network Analysis**: Added request monitoring, HAR export, and WebSocket inspection
+- ✅ **Security Testing**: Added security header inspection, CSP monitoring, and certificate details
+- ✅ **Storage Inspection**: Added IndexedDB, Cache Storage, and Service Worker management
+
+### v1.3.0 (2025-12-27)
 - ✅ **On-Demand Documentation**: New `browser_docs` tool provides detailed specs, return schemas, examples, and caveats for all 37 tools
 - ✅ **Modular Architecture**: Complete refactor into `src/` modules for better maintainability
 - ✅ **Plugin System**: New `plugins/` directory for extending functionality

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricardodeazambuja/browser-mcp-server",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Universal browser automation MCP server using Playwright. Works with Antigravity, Claude Desktop, and any MCP client.",
   "main": "src/index.js",
   "bin": {
@@ -9,7 +9,7 @@
   "scripts": {
     "start": "node src/index.js",
     "install-browsers": "npx playwright install chromium",
-    "test": "node tests/test-mcp.js"
+    "test": "node tests/run-all.js"
   },
   "keywords": [
     "mcp",
@@ -44,6 +44,7 @@
     "README.md",
     "LICENSE",
     "CHANGELOG-v1.3.0.md",
+    "CHANGELOG-v1.4.0.md",
     "tests/",
     "plugins/"
   ]

package/src/browser.js

@@ -4,6 +4,7 @@
 
 const os = require('os');
 const { debugLog, loadPlaywright, findChromeExecutable } = require('./utils');
+const { resetCDPSession } = require('./cdp');
 
 // Browser state
 let browser = null;
@@ -140,6 +141,7 @@ function resetBrowserState() {
     context = null;
     page = null;
     activePageIndex = 0;
+    resetCDPSession();
 }
 
 module.exports = {

package/src/cdp.js

@@ -0,0 +1,58 @@
+/**
+ * CDP (Chrome DevTools Protocol) Session Manager
+ * Manages CDP session lifecycle for advanced browser automation tools
+ */
+
+const { debugLog } = require('./utils');
+
+// CDP session state
+let cdpSession = null;
+let currentPage = null;
+
+/**
+ * Get or create CDP session for current page
+ * Sessions are cached per page instance for efficiency
+ * @returns {CDPSession} Active CDP session
+ */
+async function getCDPSession() {
+    // Lazy-load to avoid circular dependency with browser.js
+    const { connectToBrowser } = require('./browser');
+    const { page } = await connectToBrowser();
+
+    // If page changed or session doesn't exist, create new session
+    if (!cdpSession || currentPage !== page) {
+        // Detach old session if it exists
+        if (cdpSession) {
+            try {
+                await cdpSession.detach();
+                debugLog('Detached old CDP session');
+            } catch (e) {
+                debugLog(`Failed to detach old CDP session: ${e.message}`);
+            }
+        }
+
+        // Create new session for current page
+        currentPage = page;
+        cdpSession = await page.context().newCDPSession(page);
+        debugLog('Created new CDP session');
+    }
+
+    return cdpSession;
+}
+
+/**
+ * Reset CDP session state
+ * Called when browser state is reset (connection lost, browser restart, etc.)
+ */
+function resetCDPSession() {
+    if (cdpSession) {
+        debugLog('Resetting CDP session state');
+    }
+    cdpSession = null;
+    currentPage = null;
+}
+
+module.exports = {
+    getCDPSession,
+    resetCDPSession
+};

package/src/index.js

@@ -6,7 +6,7 @@
  */
 
 const readline = require('readline');
-const { debugLog } = require('./utils');
+const { debugLog, version } = require('./utils');
 const { tools, handlers } = require('./tools');
 const { getBrowserState } = require('./browser');
 
@@ -66,7 +66,7 @@ class BrowserMCPServer {
             capabilities: { tools: {} },
             serverInfo: {
                 name: 'browser-automation-playwright',
-                version: '1.3.0'
+                version: version
             }
         });
     }