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. > 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": { "type": "local", "command": ["uvx", "pydoll-browser-mcp"], "enabled": true } } } ``` Local checkout / venv: ```jsonc { "mcp": { "pydoll": { "type": "local", "command": ["C:\\path\\to\\pydoll-mcp\\.venv\\Scripts\\python.exe", "-m", "pydoll_mcp.server"], "environment": { "PYDOLL_MCP_PROFILE": "full", "PYDOLL_MCP_HEADLESS": "true" }, "enabled": true } } } ``` ## Profiles `PYDOLL_MCP_PROFILE` selects the default tool set: `core`, `balanced` (default) or `full`. `balanced` = core + network + storage + meta. `full` also enable…