pydoll-browser-mcp

# pydoll-browser-mcp An MCP server for browser automation built on [pydoll](https://github.com/autoscrape-labs/pydoll) (real Chrome/Edge over CDP) with: - multi-context and multi-tab control, - **per-context proxies** (isolated cookies/storage per identity), - a large tool surface covering navigation, elements, network, storage, devtools, stealth, HTTP-via-browser and a raw `cdp_send` escape hatch, - **screenshot zoom & coordinates** (fork addition): `tab_screenshot`/`element_screenshot` accept `region=[x1,y1,x2,y2]` (viewport CSS pixels), `scale` (magnification, e.g. 2.0) and `grid=[cols,rows]` (a labeled coordinate grid drawn on the returned image, ready to read click targets from). Cropping, zooming and the grid happen on the captured bitmap in Python (Pillow) — the page is never scrolled, restyled or injected into; only `full_page=True` uses CDP `captureBeyondViewport`. The plain viewport shot is capped in width by `PYDOLL_MCP_SCREENSHOT_WIDTH` (1280, set 0 to disable). > Note: the PyPI distribution is `pydoll-browser-mcp` (the older `pydoll-mcp` name belongs to an > unrelated project). The Python import package is `pydoll_mcp`. ## Install / run (no project files needed) Once published, run it straight from PyPI with [`uv`](https://docs.astral.sh/uv/): ```bash uvx pydoll-browser-mcp ``` or with [`pipx`](https://pipx.pypa.io/): ```bash pipx run pydoll-browser-mcp ``` Both download the server + dependencies into an isolated environment and run it over stdio, so nothing is added to the user's project directory. To install it permanently: ```bash uv tool install pydoll-browser-mcp # or: pipx install pydoll-browser-mcp ``` ### Development install (this repo) ```bash python -m venv .venv .venv\Scripts\python -m pip install -e . .venv\Scripts\python -m pydoll_mcp.server ``` ## opencode config Published (isolated, no project files): ```jsonc { "mcp": { "pydoll": { "typ…