mirror of
https://github.com/hanzoai/python-sdk.git
synced 2026-10-23 20:23:00 +00:00
zeekay
4991923b67
The browser tool's bespoke register() returned execute()'s dict RAW, so FastMCP
flat-JSON-serialized a screenshot's ToolImage (base64 inline, 250K chars) →
overflowed the agent context and wedged the run — the SAME bug main's
ImageContent converter (711eb498) fixed for every OTHER tool via
BaseTool.register→_result_to_mcp, but the browser tool bypassed that path.
Now both registration paths share the one converter: nested ToolImage anywhere
in the result becomes a native MCP ImageContent block the client SEES. One way.
hanzo-tools-browser
Browser automation tools for Hanzo MCP using Playwright.
Installation
pip install hanzo-tools-browser
Tools
browser - Complete Playwright API
70+ browser actions for full automation.
Navigation:
browser(action="navigate", url="https://example.com")
browser(action="go_back")
browser(action="reload")
Input:
browser(action="click", selector="button.submit")
browser(action="fill", selector="input[name=email]", text="[email protected]")
browser(action="type", selector="textarea", text="Hello")
Touch/Mobile:
browser(action="tap", selector=".button")
browser(action="swipe", selector=".carousel", direction="left")
browser(action="emulate", device="mobile") # or tablet, laptop
Assertions:
browser(action="expect_visible", selector=".modal")
browser(action="expect_text", selector="h1", expected="Welcome")
browser(action="expect_url", expected="*/dashboard*")
Content:
browser(action="get_text", selector=".content")
browser(action="screenshot", full_page=True)
browser(action="pdf")
Parallel Agents:
# Each agent gets isolated session
browser(action="new_context") # Separate cookies/storage
Device Presets:
mobile- iPhone-like (390x844, touch)tablet- iPad-like (1024x1366, touch)laptop- MacBook-like (1440x900)iphone_14,pixel_7,ipad_pro, etc.
License
MIT