seleniumbase/seleniumbase-mcp

SeleniumBase MCP Servers

About seleniumbase-mcp

This package provides three different SeleniumBase MCP servers for driving stealthy browser automation over the Model Context Protocol.

Here are the three server variants in this folder:

File Backs onto Best for --------- cdpserver.py seleniumbase.sbcdp.Chrome() (Pure CDP Mode, sync) Scraping/automation against bot-detection (Cloudflare, etc.) No WebDriver at all. Includes CAPTCHA-solving. driverserver.py seleniumbase.Driver() (WebDriver) General automation with Selenium ecosystem support. sbserver.py seleniumbase.SB() (used without with, via manual enter/exit) The broadest API surface: Everything Driver offers, plus drag-and-drop, MFA-handling, file downloads, etc. Can switch to CDP Mode mid-flow via activatecdpmode

All three set headless=False by default, where the browser window is visible unless you pass headless=True when starting a session.

Point your MCP client config at whichever server.py fits the task (see step 3 below), or register all three under different names.

uv sync reads pyproject.toml, creates a .venv/ in this folder, and installs the two dependencies (mcp[cli], seleniumbase) along with this project itself, which registers three console-script commands via [project.scripts]:

- seleniumbase-cdp - seleniumbase-driver - seleniumbase-sb

Each just calls that server file's main() function (mcp.run(transport="stdio")). This is what lets uv run work as the MCP client command in steps 3 and 4 below.

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/seleniumbase--seleniumbase-mcp.html)

Related MCP servers