Skip to content

MCP Server and CDP Mode updates #4480

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
mdmintz merged 10 commits into from
Aug 30, 2026
Merged

MCP Server and CDP Mode updates #4480

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
c131852
Add `select_option_by_*` methods for the Driver() format
mdmintz Aug 30, 2026
dd4dcb8
Add `fast_type(selector, text)` to CDP Mode
mdmintz Aug 30, 2026
8e191d4
Add `wait_for_element_present(selector)` to CDP Mode
mdmintz Aug 30, 2026
0fa9f2e
Improve support for XPath in CDP Mode
mdmintz Aug 30, 2026
0e033eb
Fix bug that caused orphaned browsers in async CDP Mode
mdmintz Aug 30, 2026
bfd8f97
Update the MCP Server and related files
mdmintz Aug 30, 2026
28f2359
Update the docs
mdmintz Aug 30, 2026
9bba9fe
Update examples
mdmintz Aug 30, 2026
31b459e
Refresh Python dependencies
mdmintz Aug 30, 2026
56a75cc
Version 4.53.0
mdmintz Aug 30, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion examples/boilerplates/samples/google_objects.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,6 @@ class HomePage(object):
dialog_box = '[role="dialog"] div'
search_box = '[title="Search"]'
search_button = 'input[value="Google Search"]'
feeling_lucky_button = """input[value="I'm Feeling Lucky"]"""


class ResultsPage(object):
Expand Down
1 change: 0 additions & 1 deletion examples/boilerplates/samples/google_test.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,6 @@ def test_google_dot_com(self):
self.save_screenshot_to_logs() # ("./latest_logs" folder)
self.type(HomePage.search_box, "GitHub")
self.assert_element(HomePage.search_button)
self.assert_element(HomePage.feeling_lucky_button)
self.click(HomePage.search_button)
self.sleep(1)
self.assert_text("github.com", ResultsPage.search_results)
2 changes: 2 additions & 0 deletions examples/cdp_mode/ReadMe.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -430,6 +430,7 @@ sb.remove_elements(selector)
sb.send_keys(selector, text, timeout=None)
sb.press_keys(selector, text, timeout=None)
sb.type(selector, text, timeout=None)
sb.fast_type(selector, text, timeout=None)
sb.set_value(selector, text, timeout=None)
sb.clear_input(selector, timeout=None)
sb.clear(selector, timeout=None)
Expand Down Expand Up @@ -526,6 +527,7 @@ sb.is_text_visible(text, selector="body")
sb.is_exact_text_visible(text, selector="body")
sb.wait_for_text(text, selector="body", timeout=None)
sb.wait_for_text_not_visible(text, selector="body", timeout=None)
sb.wait_for_element_present(selector, timeout=None)
sb.wait_for_element_visible(selector, timeout=None)
sb.wait_for_element(selector, timeout=None)
sb.wait_for_element_not_visible(selector, timeout=None)
Expand Down
4 changes: 2 additions & 2 deletions examples/cdp_mode/raw_basic_cdp.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,8 @@
sb.save_as_pdf_to_logs()
sb.save_screenshot_to_logs()
sb.save_page_source_to_logs()
sb.save_data_to_logs("hello!")
sb.append_data_to_logs("more data!")
sb.save_data_to_logs("Extra data for logs")
sb.append_data_to_logs("Add data for logs")
sb.click_link("Sign out")
sb.assert_text("signed out", "#top_message")
sb.quit()
2 changes: 1 addition & 1 deletion examples/cdp_mode/raw_cdp_pixelscan.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

sb = sb_cdp.Chrome(guest=True, ad_block=True)
sb.goto("https://pixelscan.net/fingerprint-check")
sb.remove_element("div.header-ad")
sb.remove_element("div.header-promo")
sb.remove_element("pxlscn-dynamic-ad")
sb.sleep(1.8)
sb.assert_text("No automated behavior", "pxlscn-bot-detection")
Expand Down
2 changes: 1 addition & 1 deletion examples/cdp_mode/raw_pixelscan.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
with SB(uc=True, test=True, guest=True) as sb:
sb.activate_cdp_mode(ad_block=True)
sb.goto("https://pixelscan.net/fingerprint-check")
sb.remove_element("div.header-ad")
sb.remove_element("div.header-promo")
sb.remove_element("pxlscn-dynamic-ad")
sb.sleep(1.8)
sb.assert_text("No automated behavior", "pxlscn-bot-detection")
Expand Down
2 changes: 1 addition & 1 deletion examples/test_shadow_dom.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
class ShadowDomTests(BaseCase):
def download_tar_file_from_pypi(self, package):
self.goto("https://pypi.org/project/%s/#files" % package)
pkg_header = self.get_text("h1.package-header__name").strip()
pkg_header = self.get_text('h1[class*="header__name"]').strip()
pkg_name = pkg_header.replace(" ", "-")
tar_file = pkg_name + ".tar.gz"
tar_selector = 'div#files a[href$="%s"]' % tar_file
Expand Down
2 changes: 2 additions & 0 deletions help_docs/cdp_mode_methods.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -76,6 +76,7 @@ sb.remove_elements(selector)
sb.send_keys(selector, text, timeout=None)
sb.press_keys(selector, text, timeout=None)
sb.type(selector, text, timeout=None)
sb.fast_type(selector, text, timeout=None)
sb.set_value(selector, text, timeout=None)
sb.clear_input(selector, timeout=None)
sb.clear(selector, timeout=None)
Expand Down Expand Up @@ -172,6 +173,7 @@ sb.is_text_visible(text, selector="body")
sb.is_exact_text_visible(text, selector="body")
sb.wait_for_text(text, selector="body", timeout=None)
sb.wait_for_text_not_visible(text, selector="body", timeout=None)
sb.wait_for_element_present(selector, timeout=None)
sb.wait_for_element_visible(selector, timeout=None)
sb.wait_for_element(selector, timeout=None)
sb.wait_for_element_not_visible(selector, timeout=None)
Expand Down
4 changes: 4 additions & 0 deletions help_docs/method_summary.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,7 @@ self.send_keys(selector, text, by="css selector", timeout=None)
# Duplicates:
# self.add_text(selector, text, by="css selector", timeout=None)
self.press_keys(selector, text, by="css selector", timeout=None)
self.fast_type(selector, text, by="css selector", timeout=None)
self.submit(selector, by="css selector")
self.clear(selector, by="css selector", timeout=None)
self.focus(selector, by="css selector", timeout=None)
Expand Down Expand Up @@ -725,6 +726,9 @@ driver.find_element(selector)
driver.find_elements(selector)
driver.select(selector)
driver.select_all(selector)
driver.select_option_by_text(dropdown_selector, option)
driver.select_option_by_index(dropdown_selector, option)
driver.select_option_by_value(dropdown_selector, option)
driver.wait_for_element(selector)
driver.wait_for_element_visible(selector)
driver.wait_for_element_present(selector)
Expand Down
2 changes: 1 addition & 1 deletion mcp_servers/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -129,7 +129,7 @@ claude mcp add seleniumbase-mcp -- uv run seleniumbase-mcp
| Navigation | `navigate`, `reload_page`, `go_back`/`go_forward`, `get_current_url`, `get_title` |
| Finding & reading | `find_element_info`, `find_all_info`, `get_text`, `get_html_source`, `get_element_attribute(s)`, `is_element_present/visible` |
| Interacting | `click`, `click_if_visible`, `click_visible_elements`, `type_text`, `send_keys`, `set_value`, `select_option_by_text/value/index`, `nested_click` |
| Waiting | `wait_for_element`, `wait_for_element_visible/not_visible/absent`, `wait_for_text` |
| Waiting | `wait_for_element_present`, `wait_for_element_visible/not_visible/absent`, `wait_for_text` |
| Assertions | `assert_element`, `assert_text`, `assert_exact_text`, `assert_title`, `assert_url(_contains)` |
| Cookies & storage | `get_all_cookies`, `save_cookies`/`load_cookies`, `get/set_local_storage_item`, `get/set_session_storage_item` |
| Scrolling | `scroll_into_view`, `scroll_to_top/bottom`, `scroll_up/down` |
Expand Down
4 changes: 2 additions & 2 deletions mcp_servers/pyproject.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
[project]
name = "seleniumbase-mcp"
version = "1.0.0dev0"
version = "1.1.0dev0"
description = "MCP server exposing SeleniumBase CDP Mode as tools for MCP clients."
readme = "README.md"
requires-python = ">=3.10"
license = "MIT"
dependencies = [
"mcp[cli]>=2.0.0,<3.0.0",
"mcp[cli]>=2.1.1,<3.0.0",
"seleniumbase",
]

Expand Down
2 changes: 1 addition & 1 deletion mcp_servers/requirements.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
mcp[cli]>=2.0.0,<3.0.0
mcp[cli]>=2.1.1,<3.0.0
-e ..

# `-e ..` installs SeleniumBase itself from the repo root (one directory
Expand Down
Loading