customable-mcp/browser-mcp
2
0
Fork 0
Code Issues 2 Pull requests Projects Releases 9 Packages 1 Wiki Activity Actions
9 releases 9 tags
  • v3.0.0 91b80de158

    v3.0.0 - Playwright Migration 🚀
    All checks were successful
    Publish Package / publish (push) Successful in 58s
    Details
    Stable

    jack released this 2025-10-11 08:57:34 +02:00 | 1 commits to main since this release

    🚀 Major Release - Playwright Migration

    This is a major upgrade migrating from Puppeteer to Playwright, bringing multi-browser support and modern automation capabilities.

    ✨ New Features

    Multi-Browser Support

    • 🌐 Chromium - Fast, feature-rich browser (default)
    • 🦊 Firefox - Mozilla's privacy-focused browser
    • 🧭 WebKit - Apple's browser engine (Safari)
    • 🔄 Switch browsers via BROWSER_TYPE environment variable
    • 📦 Automatic browser installation via playwright install

    Smart Viewport Management

    • 📐 Automatic 1920x1080 viewport in GUI mode (HEADLESS=false)
    • 🎯 Optimized viewing experience for non-headless browsing
    • 📏 Customizable viewport still available via setViewport tool

    🔄 Breaking Changes

    Migration from Puppeteer to Playwright

    • ⚡ New Engine: Playwright 1.56.0 replaces Puppeteer 22.0.0
    • 🎯 Modern API: Locator-based element interaction for better reliability
    • 🔌 CDP Access: Chromium DevTools Protocol still available for advanced features
    • 🌐 Context-based: Browser contexts for better isolation and management

    API Changes

    • Updated selector handling with Playwright's locator API
    • Improved network emulation with Playwright's native methods
    • Enhanced geolocation with built-in permission granting
    • Better wait strategies with waitForLoadState

    🛠️ Improvements

    Reliability

    • ✅ More stable element waiting and interaction
    • ✅ Better network idle detection
    • ✅ Improved error handling and timeout management
    • ✅ Modern async/await patterns throughout

    Type Safety

    • ✅ Full TypeScript compatibility with Playwright types
    • ✅ Better type inference for browser contexts
    • ✅ Proper typing for multi-parameter evaluate functions

    Developer Experience

    • ✅ Clearer console logging with browser detection
    • ✅ Better error messages
    • ✅ Automatic dependency management via postinstall

    📦 Dependencies

    • ➕ Added playwright@^1.56.0
    • ➖ Removed puppeteer@^22.0.0
    • ⬆️ Updated @modelcontextprotocol/sdk@^1.20.0

    🔧 Configuration

    New environment variable:

    • BROWSER_TYPE - Choose browser engine: chromium, firefox, or webkit (default: chromium)

    📝 Documentation

    • ✅ Updated README with Playwright information
    • ✅ Added multi-browser support documentation
    • ✅ Enhanced configuration examples
    • ✅ Updated all code examples for Playwright API

    See CHANGELOG.md for full details.

    Downloads
  • v2.0.0 e89543d9b6

    v2.0.0 - Major Feature Expansion
    All checks were successful
    Publish Package / publish (push) Successful in 55s
    Details
    Stable

    jack released this 2025-10-10 09:48:15 +02:00 | 4 commits to main since this release

    🎉 Major Release - Complete Rewrite & Feature Expansion

    This is a major release with significant architectural improvements, comprehensive testing, and 15+ new tools.

    🏗️ Architecture & Code Quality

    Refactoring (#8)

    • ✅ Modular Architecture: Split monolithic 640-line index.ts into clean, focused modules
      • src/types.ts - Type definitions and interfaces
      • src/tool-definitions.ts - Tool schema definitions
      • src/handlers.ts - Tool execution handlers
      • src/index.ts - Main server setup (now only 117 lines)
    • ✅ Better separation of concerns
    • ✅ Improved maintainability and testability
    • ✅ Enhanced TypeScript type inference

    Type Safety (#5)

    • ✅ Eliminated all any types from codebase
    • ✅ Added proper TypeScript interfaces
    • ✅ Better IDE autocomplete and compile-time checking

    Documentation (#6)

    • ✅ Comprehensive JSDoc for all public APIs
    • ✅ Improved developer experience with IntelliSense

    Testing (#4)

    • ✅ Full test suite with Vitest
    • ✅ 22 unit tests covering handlers and tool definitions
    • ✅ Coverage reporting configured

    ✨ New Features

    💾 Storage Management (6 tools)

    • get_local_storage, set_local_storage, clear_local_storage
    • get_session_storage, set_session_storage, clear_session_storage

    📝 Console Debugging (3 tools)

    • start_console_capture, get_console_logs, clear_console_logs

    🌍 Device & Network Simulation (4 tools)

    • set_geolocation - Override browser geolocation
    • emulate_network_conditions - Simulate network conditions
    • set_headless_mode - Change headless mode at runtime
    • get_headless_mode - Get current headless status

    ⚡ Enhanced Performance

    • Navigation timing breakdown
    • Resource performance tracking
    • Memory usage monitoring
    • Core Web Vitals support

    📦 Dependencies

    • ✅ @modelcontextprotocol/sdk from 0.5.0 → 1.20.0 (latest)
    • ✅ Added vitest ^1.0.0
    • ✅ Added @vitest/coverage-v8 ^1.0.0

    📊 Statistics

    • New Tools: 15
    • Total Tools: 32+
    • Test Coverage: 22 unit tests
    • Type Safety: 100%
    • Lines Changed: 2000+

    🔄 Breaking Changes

    None! While this is a major version bump, the API remains backward compatible.

    🤖 Generated with Claude Code

    Downloads
  • v1.2.0 16494b76bb

    Release v1.2.0: Multi-Tab Management System
    All checks were successful
    Publish Package / publish (push) Successful in 48s
    Details
    Stable

    jonas.hanisch released this 2025-10-09 14:25:23 +02:00 | 14 commits to main since this release

    ✨ Major new features:

    • Multi-tab management with create_tab, close_tab, list_tabs, navigate_tab
    • All tools now support persistent tabs via tabId parameter
    • Enhanced documentation and examples

    🔧 Improvements:

    • 13 tools enhanced for tab support
    • Better resource management
    • ~771 lines of improvements

    See CHANGELOG.md for full details.

  • v1.0.5 e0275a309b

    Release v1.0.5: Fix CI authentication with direct token
    All checks were successful
    Publish Package / publish (push) Successful in 2m3s
    Details
    Stable

    jonas.hanisch released this 2025-10-07 17:09:50 +02:00 | 16 commits to main since this release

  • v1.0.4 965088ca97

    Release v1.0.4: Fix npm publish registry URL
    Some checks failed
    Publish Package / publish (push) Failing after 2m20s
    Details
    Stable

    jonas.hanisch released this 2025-10-07 17:04:27 +02:00 | 17 commits to main since this release

  • v1.0.3 4b2a075443

    Release v1.0.3: Fix CI authentication flow
    Some checks failed
    Publish Package / publish (push) Failing after 2m1s
    Details
    Stable

    jonas.hanisch released this 2025-10-07 12:51:21 +02:00 | 18 commits to main since this release

  • v1.0.2 3bb86d7a74

    Release v1.0.2: Fix CI workflow authentication
    Some checks failed
    Publish Package / publish (push) Failing after 2m1s
    Details
    Stable

    jonas.hanisch released this 2025-10-07 12:38:42 +02:00 | 19 commits to main since this release

  • v1.0.1 5d0e7a0d88

    v1.0.1
    Some checks failed
    Publish Package / publish (push) Failing after 2m18s
    Details
    Stable

    jonas.hanisch released this 2025-10-07 12:33:48 +02:00 | 20 commits to main since this release

    🐛 Fix npm registry configuration

    See CHANGELOG.md for details.

  • v1.0.0 9938c4d43f

    v1.0.0
    Some checks failed
    Publish Package / publish (push) Failing after 50s
    Details
    Stable

    jonas.hanisch released this 2025-10-07 12:30:22 +02:00 | 21 commits to main since this release

    🎉 First stable release of @customable/browser-mcp

    See CHANGELOG.md for details.