seleniumboot MCP server
Commit 1 Nov 2026Memungkinkan asisten AI untuk mengontrol browser asli melalui Selenium WebDriver dan menghasilkan kode test otomatis dalam bahasa Python, Java, dan Gherkin.
Juga dikenal sebagai seleniumboot/selenium-mcp
- Stars
- 2
- Tools
- 63
- Unduhan, 30 hari
- —
- Versi terbaru
- —
- Commit terakhir
- 1 Nov 2026
- Lisensi
- —
Apa itu seleniumboot MCP?
Memungkinkan asisten AI untuk mengontrol browser asli melalui Selenium WebDriver dan menghasilkan kode test otomatis dalam bahasa Python, Java, dan Gherkin. Server ini menyediakan 63 tool, seperti start_browser, navigate, take_screenshot.
Ringkasan dibuat dari README proyek
Tentang seleniumboot MCP server
Automasi interaksi web browser dan pembuatan script test dari sesi yang direkam adalah fungsi utama selenium-mcp bagi developer yang menggunakan asisten AI. Dengan terhubung ke Claude Desktop, GitHub Copilot, atau JetBrains AI Assistant, server ini memungkinkan AI untuk mengontrol browser Chrome asli guna menavigasi halaman, berinteraksi dengan elemen, dan melakukan assertion. Server ini menangani lifecycle browser secara otomatis, yang berarti Chrome akan berjalan pada penggunaan pertama tanpa memerlukan konfigurasi ChromeDriver secara manual.
User dapat berinteraksi dengan browser melalui 43 tool default atau memperluasnya menjadi 77 tool dengan mengatur environment variable SELENIUM_MCP_TOOLS ke all. Server ini spesialis dalam mengubah aksi browser secara live menjadi kode yang siap dijalankan untuk berbagai framework, termasuk Python, Java, dan Gherkin. Server ini mendukung output Java spesifik seperti TestNG, JUnit 5, dan Cucumber, serta struktur Page Object Model. Hal ini menjadikannya tool khusus bagi QA engineer dan developer yang ingin menjembatani celah antara instruksi bahasa alami dengan suite automated testing formal.
Apa yang bisa Anda lakukan dengannya
- 1Automated browser navigationInstruksikan AI untuk melakukan tugas web spesifik seperti login ke sebuah situs atau mengisi formulir.
- 2Test code generationKonversi sesi browser yang direkam menjadi file test Java TestNG atau Gherkin yang terstruktur.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Tool seleniumboot MCP 63
Terdeteksi dari READMEstart_browsernavigatetake_screenshotget_page_titleget_current_urlget_page_sourceexecute_scriptrefreshswitch_to_windowopen_new_tabclose_current_tablist_windows
| start_browser | — | |
| navigate | — | |
| take_screenshot | — | |
| get_page_title | — | |
| get_current_url | — | |
| get_page_source | — | |
| execute_script | — | |
| refresh | — | |
| switch_to_window | — | |
| open_new_tab | — | |
| close_current_tab | — | |
| list_windows | — |
Tampilkan semua 63 toolTampilkan lebih sedikit tool
close_browserscroll_to_topscroll_to_bottomscroll_byemulate_deviceget_console_logswait_for_network_idleinspect_pageget_network_logsmock_responseclear_mock_responsescompare_screenshotcheck_accessibilityfind_elementfind_elementsclicktype_textget_textget_attributeselect_optionhoverdouble_clickright_clickdrag_and_dropis_displayedis_enabledwait_for_elementscroll_to_elementclear_fieldsend_keysupload_fileget_alert_texttype_in_alertswitch_to_frameswitch_to_default_contentfind_shadow_elementget_table_datafill_formget_healed_locatorsclear_healed_locatorsassert_titleassert_urlassert_textassert_element_visibleassert_element_not_visibleassert_attributeassert_page_containsassert_element_countgenerateget_session_logclear_session_log
| close_browser | — | |
| scroll_to_top | — | |
| scroll_to_bottom | — | |
| scroll_by | — | |
| emulate_device | — | |
| get_console_logs | — | |
| wait_for_network_idle | — | |
| inspect_page | — | |
| get_network_logs | — | |
| mock_response | — | |
| clear_mock_responses | — | |
| compare_screenshot | — | |
| check_accessibility | — | |
| find_element | — | |
| find_elements | — | |
| click | — | |
| type_text | — | |
| get_text | — | |
| get_attribute | — | |
| select_option | — | |
| hover | — | |
| double_click | — | |
| right_click | — | |
| drag_and_drop | — | |
| is_displayed | — | |
| is_enabled | — | |
| wait_for_element | — | |
| scroll_to_element | — | |
| clear_field | — | |
| send_keys | — | |
| upload_file | — | |
| get_alert_text | — | |
| type_in_alert | — | |
| switch_to_frame | — | |
| switch_to_default_content | — | |
| find_shadow_element | — | |
| get_table_data | — | |
| fill_form | — | |
| get_healed_locators | — | |
| clear_healed_locators | — | |
| assert_title | — | |
| assert_url | — | |
| assert_text | — | |
| assert_element_visible | — | |
| assert_element_not_visible | — | |
| assert_attribute | — | |
| assert_page_contains | — | |
| assert_element_count | — | |
| generate | — | |
| get_session_log | — | |
| clear_session_log | — |
Konfigurasi
SELENIUM_MCP_TOOLS
| Nama | Deskripsi | Tipe |
|---|---|---|
| SELENIUM_MCP_TOOLS | — |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkauseleniumboot/selenium-mcp is public and reachablegithub.com/seleniumboot/selenium-mcp ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)No licenseTemuan
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-11-01github.com/seleniumboot/selenium-mcp ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model63 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubseleniumboot-mcp
A Python Model Context Protocol (MCP) server for Selenium WebDriver automation.
Let Claude or GitHub Copilot control a real browser — navigate pages, interact with elements,
run assertions, and generate ready-to-run Java TestNG / JUnit 5 / Cucumber / pytest test code from recorded sessions.
43 tools by default (77 with SELENIUM_MCP_TOOLS=all). No ChromeDriver setup. Browser auto-starts on first use.
Demo
Installation
pip install seleniumboot-mcp
Requires Python 3.10+ and Chrome. No separate ChromeDriver needed — Selenium Manager handles it automatically.
Setup
VS Code — Marketplace Extension (easiest)
Install Selenium Boot MCP from the VS Code Marketplace.
The extension automatically:
- Registers the MCP server with GitHub Copilot (no config file needed)
- Creates a
.mcp.jsonin your project so Claude Code detects it on next open - Prompts to
pip install seleniumboot-mcpif the Python package is missing
When Claude Code asks "Allow MCP server seleniumboot?" — click Allow.
JetBrains IDEs — Marketplace Plugin
Install Selenium Boot MCP from Settings → Plugins → Marketplace (search "Selenium Boot MCP"), or from the plugin page.
The plugin registers the MCP server with the JetBrains AI Assistant and prompts to
pip install seleniumboot-mcp if the Python package is missing. Use
Tools → Selenium Boot MCP to install/upgrade, register, or check status.
VS Code — Manual
Add .vscode/mcp.json to your project root (for GitHub Copilot):
{
"servers": {
"selenium": {
"type": "stdio",
"command": "seleniumboot-mcp"
}
}
}
For Claude Code, add .mcp.json to your project root:
{
"mcpServers": {
"seleniumboot": {
"command": "seleniumboot-mcp",
"args": []
}
}
}
Open the project in VS Code → Claude Code will prompt to approve the server → done.
Claude Desktop
Edit your Claude Desktop config:
- Windows:
%APPDATA%\claude-desktop\config.json - macOS:
~/.config/claude-desktop/config.json
{
"mcpServers": {
"selenium": {
"command": "seleniumboot-mcp"
}
}
}
Restart Claude Desktop.
How to use
Once the server is running, talk to Claude naturally — no start_browser call needed, Chrome launches automatically on first use:
Go to https://myapp.com and fill the login form with admin/password, then click Login
Assert the dashboard heading is visible
Generate a Java TestNG test class for everything we just did
Generate a Gherkin feature file and step definitions for the login flow
Claude controls the real browser, records every action, and on request generates complete test code ready to paste into your Maven or Gradle project.
Migrating an existing Selenium project
The migrate tool runs selenium-boot-migrator's
read-only analyze on a project and returns its JSON report (what maps cleanly, what needs a human).
It needs Java 17+. On first use it downloads the pinned migrator release (v0.1.2) from GitHub
into ~/.cache/seleniumboot-mcp/, verifies its SHA-256, and reuses it afterwards; this is the only
network call the tool makes. To skip the download, set SELENIUM_BOOT_MIGRATOR_JAR to a jar you
built, or put a selenium-boot-migrator launcher on PATH. It never edits your project.
Tools (77 total; 43 exposed by default)
Reducing token use
Tool definitions are sent to the model every session. Since 0.8.0 the server exposes the
core profile by default: 43 tools, ~3.9k tokens, covering the record-and-generate workflow
(browser, elements, assertions, the single generate tool for every output target, and migrate).
Cookies, storage, windows/tabs, network mocking, device emulation, screenshot-diff,
accessibility, healing, shadow DOM, tables and double/right-click/drag are left out.
Set SELENIUM_MCP_TOOLS=all to expose all 77 (~6.4k tokens).
{ "mcpServers": { "selenium": { "command": "seleniumboot-mcp", "env": { "SELENIUM_MCP_TOOLS": "all" } } } }
Browser
| Tool | Description |
|---|---|
start_browser |
Optional — Chrome auto-starts on first use. Use this to pick Firefox, enable headless, or set window size |
navigate |
Go to a URL |
take_screenshot |
Capture page as an inline image |
get_page_title |
Return page title |
get_current_url |
Return current URL |
get_page_source |
Return full HTML source |
execute_script |
Run JavaScript |
go_back / go_forward |
Browser history |
refresh |
Reload page |
switch_to_window |
Switch between tabs by index |
open_new_tab |
Open a new browser tab, optionally at a URL |
close_current_tab |
Close the active tab and switch to the previous |
list_windows |
List all open tabs with index, title, and URL |
close_browser |
Quit the browser |
scroll_to_top |
Scroll page to the top |
scroll_to_bottom |
Scroll page to the bottom |
scroll_by |
Scroll page by x/y pixels |
emulate_device |
Emulate a mobile device (iPhone, iPad, Pixel, Galaxy) via CDP |
get_console_logs |
Get browser console errors/warnings/info (Chrome) |
get_cookies / set_cookie |
Read or write a cookie |
delete_cookie / delete_all_cookies |
Remove cookies |
get_local_storage / set_local_storage |
Read or write localStorage |
get_session_storage / set_session_storage |
Read or write sessionStorage |
wait_for_network_idle |
Wait until XHR/fetch traffic is quiet — essential for SPAs |
inspect_page |
Discover all inputs, buttons, selects, links with best-fit CSS selectors |
get_network_logs |
Captured XHR/fetch requests — method, URL, status, timing |
mock_response |
Stub fetch/XHR by URL pattern with a canned response |
clear_mock_responses |
Remove all active mock rules |
compare_screenshot |
Pixel diff against a saved baseline — visual regression |
check_accessibility |
Built-in WCAG audit — alt text, labels, headings, keyboard access |
Elements
| Tool | Description |
|---|---|
find_element |
Find element, return tag/text/state |
find_elements |
Find all matching elements |
click |
Click with explicit wait |
type_text |
Clear + type into input |
get_text |
Get visible text |
get_attribute |
Get any attribute value |
select_option |
Select from <select> by text, value, or index |
hover |
Mouse hover |
double_click |
Double click |
right_click |
Context menu click |
drag_and_drop |
Drag source → target |
is_displayed |
Check visibility |
is_enabled |
Check enabled state |
wait_for_element |
Wait: visible / clickable / present / invisible |
scroll_to_element |
Scroll element into view |
clear_field |
Clear input field |
send_keys |
Send special keys (Tab, Enter, Escape, Ctrl+A, F5, …) |
upload_file |
Upload a file via <input type="file"> |
accept_alert / dismiss_alert |
Handle JS alert/confirm dialogs |
get_alert_text |
Read the message from an alert |
type_in_alert |
Type into a JS prompt and accept |
switch_to_frame |
Focus into an iframe by index, name, or selector |
switch_to_default_content |
Return to the main page from a frame |
find_shadow_element |
Find element inside a shadow DOM |
get_table_data |
Extract an HTML table as a formatted text grid |
fill_form |
Fill multiple fields at once — auto-detects input/select/checkbox/radio |
get_healed_locators |
View all self-healed selector mappings for the session |
clear_healed_locators |
Reset the self-healing cache |
Assertions
| Tool | Description |
|---|---|
assert_title |
Page title equals/contains |
assert_url |
URL equals/contains |
assert_text |
Element text equals/contains |
assert_element_visible |
Element is visible |
assert_element_not_visible |
Element is hidden or absent |
assert_attribute |
Element attribute has expected value |
assert_page_contains |
Page body contains a string |
assert_element_count |
Count of matching elements equals expected |
Codegen
| Tool | Description |
|---|---|
generate |
Test code or CI config from the session. language: python, java, csharp, gherkin, playwright, github_actions, jenkins, gitlab_ci. Java: framework = testng / junit5 / selenium_boot, kind = test / page_object. |
get_session_log |
View recorded actions |
clear_session_log |
Reset the session recording |
Codegen Examples
Java TestNG
Go to https://myapp.com/login, enter admin/password, click Login
→ Generate a Java TestNG test
public class LoginTest {
@BeforeMethod public void setUp() { driver = new ChromeDriver(); ... }
@AfterMethod public void tearDown() { driver.quit(); }
@Test
public void recordedFlowTest() {
driver.get("https://myapp.com/login");
WebElement f = wait.until(visibilityOf(By.cssSelector("#username")));
f.clear(); f.sendKeys("admin");
wait.until(elementToBeClickable(By.cssSelector("button[type='submit']"))).click();
}
}
Page Object Model
Generate a Java Page Object for the login page
// LoginPage.java
public class LoginPage {
private final By usernameField = By.cssSelector("#username");
private final By submitButton = By.cssSelector("button[type='submit']");
public LoginPage enterUsernameField(String text) { ... return this; }
public LoginPage clickSubmitButton() { ... return this; }
}
// LoginTest.java
public class LoginTest {
@Test public void recordedFlowTest() {
driver.get("https://myapp.com/login");
page.enterUsernameField("admin").clickSubmitButton();
}
}
Cucumber / Gherkin
Generate a Gherkin feature file and step definitions for the login flow
Feature: Login
Scenario: User logs in with valid credentials
Given I navigate to "https://myapp.com/login"
And I enter "admin" in the username field
And I enter "password" in the password field
And I click the submit button
// LoginSteps.java
public class LoginSteps {
@Given("I navigate to {string}")
public void iNavigateTo(String url) { driver.get(url); }
@And("I enter {string} in the username field")
public void iEnterInUsernameField(String text) { ... el.sendKeys(text); }
@And("I click the submit button")
public void iClickTheSubmitButton() { wait.until(...).click(); }
}
Selenium Boot projects
The Java examples above are raw Selenium: you own the ChromeDriver/WebDriverWait lifecycle
and get plain TestNG/JUnit 5 asserts. If the project you're working in has
Selenium Boot — detected automatically from selenium-boot.yml or
the io.github.seleniumboot dependency, no flag needed — the same tools emit framework-native
code instead: classes extend BaseTest/BaseJUnit5Test/BaseCucumberSteps, there's no driver
lifecycle boilerplate to write, locators follow an accessibility-first ladder
(getByRole/getByLabel/getByTestId), and assertions are web-first
(assertThat(locator).isVisible()/.hasText()) instead of raw TestNG/JUnit calls.
If no Selenium Boot project is detected, generated Java now includes a short comment noting it as an option, with a link — nothing else changes, and Python/C# output is unaffected either way.
Self-Healing Locators
When a selector fails to find an element, seleniumboot-mcp automatically tries alternative strategies before giving up:
| Primary selector | Alternatives tried |
|---|---|
#my-id (CSS) |
by=id "my-id", [id='my-id'] |
.my-class (CSS) |
by=class "my-class", [class*='my-class'] |
input[type='email'] (CSS) |
//input[@type='email'] (XPath) |
//button[@id='ok'] (XPath) |
button[id='ok'] (CSS), by=id "ok" |
"A, B" comma list |
tries A first, then B |
Successful fallbacks are cached so the healed selector is reused automatically. Use get_healed_locators to inspect the cache and update your test code, and clear_healed_locators to start fresh.
Links
- GitHub: github.com/seleniumboot/selenium-mcp
- PyPI: pypi.org/project/seleniumboot-mcp
- VS Code Marketplace: marketplace.visualstudio.com
Roadmap
- Java TestNG / JUnit 5 / Python pytest code generation
- Screenshot returned as
ImageContent(renders inline in Claude) - Full session recording — hover, double_click, right_click, scroll, select_option
- Codegen for hover, drag-and-drop, select, scroll in Java and Python templates
- Auto-start browser on first use (no explicit
start_browserneeded) - Page Object Model generation (
generatewithlanguage=java, kind=page_object) - Cucumber / Gherkin step generation (
generatewithlanguage=gherkin) - Self-healing locators — automatic fallback when a selector breaks
- Alert/dialog handling, iframe switching, shadow DOM, table extraction
- Cookie, localStorage, sessionStorage management
- Mobile device emulation via Chrome DevTools Protocol
- Special key sending (Tab, Enter, F-keys, Ctrl+A, …)
- File upload via
<input type="file"> - Browser console log capture
- Multi-tab management (open, close, list)
- Page scroll (top, bottom, by pixels)
- C# NUnit + Selenium codegen
- GitHub Actions CI workflow generator (Maven / Gradle / pytest)
- Playwright TypeScript migration hints
- CI/CD config for Jenkins / GitLab CI
License
MIT
Pertanyaan tentang seleniumboot MCP
Tool apa yang disediakan seleniumboot MCP?
Server ini menyediakan 63 tool, termasuk start_browser, navigate, take_screenshot, get_page_title, get_current_url.
Apakah saya perlu menginstal ChromeDriver secara terpisah?
Tidak, Selenium Manager menanganinya secara otomatis, sehingga tidak diperlukan setup ChromeDriver terpisah.
Bahasa pemrograman apa saja yang bisa digunakan server ini untuk menghasilkan kode test?
Server ini dapat menghasilkan kode test untuk Python, Java, C#, Gherkin, bahkan konfigurasi CI seperti GitHub Actions, Jenkins, dan GitLab CI.
Berapa banyak tool yang tersedia dengan server ini?
Server menyediakan 43 tool secara default, tetapi Anda dapat mengaktifkan seluruh 77 tool dengan mengatur environment variable SELENIUM_MCP_TOOLS ke 'all'.