Skip to content

v0.5.1 — new tools, bug fixes, docs, tests, manpage

Latest
Latest

Choose a tag to compare

View all tags
@Vitexus Vitexus released this 21 Jun 15:21
· 1 commit to main since this release
v0.5.1
53c3ce6

New tools (8)

Tool Purpose
browser_scroll Scroll page to coords, by offset, or element into view
browser_press_key Send enter / tab / escape / arrow / F-keys
browser_hover Mouse hover for :hover states, tooltips, and dropdowns
browser_find_elements Enumerate all elements matching a CSS selector
browser_accept_dialog Accept a JS alert() / confirm() / prompt()
browser_dismiss_dialog Dismiss a JS confirm() / prompt()
browser_get_cookies Read all cookies for the current page
browser_set_cookie Inject a cookie (auth tokens, session IDs)

Improvements to existing tools

  • browser_open — URL is now optional (default about:blank)
  • browser_navigate / browser_open — bare hostnames (e.g. example.com) get https:// prepended automatically
  • browser_execute_js — returns JSON-serialised result instead of str()
  • browser_wait — new condition parameter: visible (default), clickable, present, or text:<string>
  • devtools_network_all — new limit= parameter to cap context-window size on busy pages

Bug fixes

  • ctx.state → ctx.lifespan_context — FastMCP 2.x compatibility (all tools were broken without this)
  • _resolve_geckodriver() returned None instead of the actual path when geckodriver was found on system PATH, causing Selenium to fall back to the broken selenium-manager
  • driver.network AttributeError was caught by the outer handler, disabling all BiDi (including console and JS error capture) instead of just network capture

Packaging

  • Manpage: debian/mcp-server-webdriver.1 with TOOLS (37), ENVIRONMENT, GECKODRIVER RESOLUTION, and USE CASES sections
  • debian/rules now runs unit tests during dh_auto_test

Tests

tests/test_server.py — 21 unit tests + 20 integration tests covering:
argument parsing, --help, geckodriver resolution, URL normalisation, key map, tool registry (37 tools), and full browser integration flow

Documentation

  • README: "What it does" intro + 10 use-case scenarios with tool sequences
  • Manpage: all 37 tools documented with parameters and a USE CASES section

Installation

echo "deb http://repo.vitexsoftware.com trixie main" \
  | sudo tee /etc/apt/sources.list.d/vitexsoftware.list
sudo apt update && sudo apt install python3-mcp-server-webdriver

Or download the .deb from this release and install directly:

sudo dpkg -i python3-mcp-server-webdriver_0.5.1-1_all.deb
Assets 3
Loading