mcp-server-webdriver

Vytvořeno: 30.6.2026 | Aktualizováno: 30.06.2026 09:24

mcp-server-webdriver je MCP server pro ovládání Firefoxu přes Selenium WebDriver a geckodriver. AI agent díky němu může otevřít reálný Firefox, procházet web, klikat, vyplňovat formuláře, pořizovat screenshoty a číst diagnostická data z konzole nebo síťových požadavků.

Prakticky jde o vhodný nástroj ve chvíli, kdy je potřeba testovat nebo ladit web ve Firefoxu. Ve vztahu ke Chrome DevTools MCP je to spíš Firefoxová alternativa pro browser automation a základní diagnostiku, ne plnohodnotná náhrada všech Chrome DevTools funkcí.

Server je napsaný v Pythonu nad FastMCP a používá Selenium WebDriver. Pro Firefox se připojuje přes geckodriver a pro diagnostiku využívá WebDriver BiDi.

Důležitý rozdíl proti Chrome DevTools MCP:

• mcp-server-webdriver ovládá Firefox přes Selenium WebDriver a WebDriver BiDi.
• chrome-devtools-mcp ovládá Chrome / Chromium přes Chrome DevTools Protocol.
• mcp-server-webdriver má DevTools-like nástroje pro konzoli, JavaScript chyby, síťové požadavky, CSS a screenshoty.
• chrome-devtools-mcp je vhodnější pro Chrome-specifický debugging, například Lighthouse, DevTools performance trace nebo heap snapshoty.

Základní nástroje pokrývají běžnou web automation:

• otevření a zavření Firefox session;
• navigace na URL, zpět, vpřed a refresh;
• klikání na prvky podle CSS selectoru;
• vyplňování formulářů;
• výběr hodnot v <select>;
• čekání na prvek nebo text;
• hover, scroll, práce s iframe;
• potvrzení nebo zrušení JavaScript dialogů;
• čtení a nastavování cookies;
• změna viewportu pro responzivní testování.

Pro kontrolu obsahu stránky umí server získat:

• titulek stránky;
• aktuální URL;
• HTML source;
• viditelný text celé stránky nebo konkrétního prvku;
• atributy prvků;
• seznam elementů odpovídajících CSS selectoru;
• screenshot celé stránky nebo konkrétního elementu.

Hlavní diagnostický nástroj je devtools_report. Vrací souhrn JavaScript chyb, chybových a varovných výpisů v konzoli, failed resources a pomalých síťových požadavků.

K dispozici jsou i samostatné nástroje:

• devtools_js_errors — JavaScript výjimky;
• devtools_console — konzolové výpisy;
• devtools_network_failed — síťové chyby, 4xx/5xx odpovědi a nedostupné zdroje;
• devtools_network_all — síťové požadavky s filtrováním;
• devtools_computed_css — výsledné CSS vlastnosti elementu;
• devtools_element_info — informace o elementu, bounding box, atributy, ARIA a část HTML;
• devtools_css_variables — CSS custom properties.

mcp-server-webdriver dává smysl hlavně pro:

• ověření chování webu přímo ve Firefoxu;
• ladění rozdílů mezi Chromem a Firefoxem;
• základní UI automation přes AI agenta;
• screenshoty a kontrolu layoutu;
• diagnostiku JavaScript chyb, konzole a failed network resources ve Firefoxu;
• práci se skutečným Firefox profilem, pokud je potřeba použít existující přihlášení.

Pokud jde jen o obecné klikání, formuláře, screenshoty a scraping, podobnou roli plní i Playwright MCP. Pokud je ale problém specifický pro Firefox, Selenium/geckodriver cesta je přirozenější.

Chrome DevTools MCP je vhodnější, pokud je potřeba:

• ladit Chrome / Chromium;
• spouštět Lighthouse audity;
• dělat DevTools performance tracing;
• analyzovat heap snapshoty a memory leaks;
• řešit hlubší Chrome DevTools scénáře.

Tyto nástroje se tedy nepřekrývají úplně. Dává smysl mít je vedle sebe: jeden pro Firefox přes WebDriver, druhý pro Chrome přes DevTools.

Podle README projekt vyžaduje:

• Python 3.11 nebo novější;
• FastMCP 2.10 nebo novější;
• Selenium 4.0 nebo novější;
• aktuální Firefox;
• geckodriver 0.34 nebo novější pro WebDriver BiDi.

Na Debianu autor projektu doporučuje instalaci z repozitáře VitexSoftware:

sudo curl -fsSL http://repo.vitexsoftware.com/KEY.gpg -o /usr/share/keyrings/vitexsoftware-archive-keyring.gpg
 
echo "deb [signed-by=/usr/share/keyrings/vitexsoftware-archive-keyring.gpg] http://repo.vitexsoftware.com trixie main" \
  | sudo tee /etc/apt/sources.list.d/vitexsoftware.list
 
sudo apt update
sudo apt install python3-mcp-server-webdriver

Alternativně lze nainstalovat geckodriver systémově a Python závislosti přes pip:

pip install fastmcp selenium

Pokud geckodriver není nalezen v systému, server podle README podporuje fallback přes webdriver-manager. Ten lze vypnout proměnnou prostředí GECKODRIVER_AUTO_INSTALL=false.

Minimální konfigurace MCP klienta:

{
  "mcpServers": {
    "webdriver": {
      "command": "mcp-server-webdriver"
    }
  }
}

Použití pojmenovaného Firefox profilu:

{
  "mcpServers": {
    "webdriver": {
      "command": "mcp-server-webdriver",
      "args": ["-P", "work"]
    }
  }
}

Použití konkrétního profilu a explicitní cesty ke geckodriveru:

{
  "mcpServers": {
    "webdriver": {
      "command": "mcp-server-webdriver",
      "args": ["--profile", "/home/user/.mozilla/firefox/abc123.dev"],
      "env": {
        "GECKODRIVER_PATH": "/usr/bin/geckodriver"
      }
    }
  }
}

Použití reálného Firefox profilu je praktické, protože agent může využít existující přihlášení, cookies a případně rozšíření. Zároveň to ale znamená, že agent pracuje v prostředí se skutečnými session daty.

Pro bezpečnější použití je lepší vytvořit samostatný Firefox profil určený jen pro AI automation. Do hlavního osobního profilu je vhodné agenta pouštět jen tehdy, když je to opravdu potřeba.

mcp-server-webdriver je dobrý kandidát na Firefoxovou větev browser automation přes MCP. Nejde o přímou náhradu Chrome DevTools MCP, protože nestaví na CDP a nemá stejné hluboké Chrome DevTools funkce. Pro Firefox, Selenium/WebDriver workflow, screenshoty, formuláře, konzoli, síťové chyby a CSS diagnostiku je ale přesně k tomu určený.

• mcp-server-webdriver – GitHub
• Chrome DevTools MCP – článek ve wiki