seleniumboot MCP sunucusu
Commit 1 Kas 2026Yapay zeka asistanlarının Selenium WebDriver aracılığıyla gerçek tarayıcıları kontrol etmesini ve Python, Java ve Gherkin dillerinde otomatik test kodları oluşturmasını sağlar.
Ayrıca bilinen adı seleniumboot/selenium-mcp
- Yıldızlar
- 2
- Araçlar
- 63
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 1 Kas 2026
- Lisans
- —
seleniumboot MCP nedir?
Yapay zeka asistanlarının Selenium WebDriver aracılığıyla gerçek tarayıcıları kontrol etmesini ve Python, Java ve Gherkin dillerinde otomatik test kodları oluşturmasını sağlar. 63 araç sunar; örneğin start_browser, navigate, take_screenshot.
Özet, projenin README dosyasından oluşturuldu
seleniumboot MCP sunucusu hakkında
selenium-mcp, yapay zeka asistanı kullanan geliştiricilerin web tarayıcı etkileşimlerini otomatikleştirmesine ve kaydedilen oturumlardan test scriptleri oluşturmasına olanak tanır. Bu sunucu; Claude Desktop, GitHub Copilot veya JetBrains AI Assistant ile bağlantı kurarak, bir yapay zekanın sayfalar arasında gezinmesi, öğelerle etkileşime girmesi ve doğrulama (assertion) yapması için gerçek bir Chrome tarayıcısını kontrol etmesini sağlar. Tarayıcı yaşam döngüsünü otomatik olarak yönetir; yani Chrome, manuel ChromeDriver yapılandırması gerektirmeden ilk kullanımda otomatik olarak başlatılır.
Yazılımcılar, 43 varsayılan araçla tarayıcıyla etkileşime geçebilir veya SELENIUM_MCP_TOOLS ortam değişkenini all olarak ayarlayarak araç sayısını 77'ye çıkarabilirler. Sunucu, canlı tarayıcı eylemlerini Python, Java ve Gherkin dahil olmak üzere çeşitli frameworkler için çalışmaya hazır kodlara dönüştürme konusunda uzmanlaşmıştır. TestNG, JUnit 5 ve Cucumber gibi spesifik Java çıktılarının yanı sıra Page Object Model yapılarını da destekler. Bu özellik, doğal dil talimatları ile resmi otomatik test paketleri arasındaki boşluğu doldurmak isteyen QA mühendisleri ve geliştiriciler için onu özelleşmiş bir araç haline getirir.
Neler yapabilirsiniz
- 1Otomatik tarayıcı navigasyonuBir siteye giriş yapmak veya form doldurmak gibi belirli web görevlerini yerine getirmesi için bir yapay zekayı yönlendirin.
- 2Test kodu oluşturmaKaydedilmiş bir tarayıcı oturumunu yapılandırılmış bir Java TestNG veya Gherkin test dosyasına dönüştürün.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
seleniumboot MCP araçları 63
README dosyasından algılandıstart_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 | — |
63 aracın tümünü gösterDaha az araç göster
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 | — |
Yapılandırma
SELENIUM_MCP_TOOLS
| Ad | Açıklama | Sunucu |
|---|---|---|
| SELENIUM_MCP_TOOLS | — |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirseleniumboot/selenium-mcp is public and reachablegithub.com/seleniumboot/selenium-mcp ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorKontrol edilmedi
- Derleme kökeni (Sigstore onayı)Kontrol edilmedi
- Açık kaynak lisansı (OSI)No licenseBulgu
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-01github.com/seleniumboot/selenium-mcp ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
- Modele yönelik gizli talimat yok63 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
seleniumboot-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
seleniumboot MCP soruları
seleniumboot MCP hangi araçları sunar?
63 araç sunar; bunlar arasında start_browser, navigate, take_screenshot, get_page_title, get_current_url yer alır.
ChromeDriver'ı ayrıca yüklemem gerekiyor mu?
Hayır, Selenium Manager bunu otomatik olarak halleder, bu nedenle ayrı bir ChromeDriver kurulumuna gerek yoktur.
Sunucu hangi programlama dilleri için test kodu oluşturabilir?
Sunucu Python, Java, C#, Gherkin ve hatta GitHub Actions, Jenkins ve GitLab CI gibi CI yapılandırmaları için test kodu oluşturabilir.
Bu sunucu ile kaç tane araç kullanılabilir?
Sunucu varsayılan olarak 43 araç sunar, ancak SELENIUM_MCP_TOOLS ortam değişkenini 'all' olarak ayarlayarak tüm 77 aracı etkinleştirebilirsiniz.