====== mcp-server-webdriver ======

//Vytvořeno: **30.6.2026** | Aktualizováno: **~~LASTMOD~~**//

[[https://github.com/VitexSoftware/mcp-server-webdriver|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 [[https://wiki.petrnosek.cz/ai/mcp/servery/chrome-devtools-mcp|Chrome DevTools MCP]] je to spíš **Firefoxová alternativa pro browser automation a základní diagnostiku**, ne plnohodnotná náhrada všech Chrome DevTools funkcí.

===== Jak funguje =====

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.

===== Co umí =====

==== Ovládání prohlížeče ====

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í.

==== Inspekce stránky ====

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.

==== Diagnostika přes WebDriver BiDi ====

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.

===== Kdy ho použít =====

''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ší.

===== Kdy raději použít Chrome DevTools MCP =====

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.

===== Instalace a požadavky =====

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:

<code bash>
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
</code>

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

<code bash>
pip install fastmcp selenium
</code>

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''.

===== MCP konfigurace =====

Minimální konfigurace MCP klienta:

<code json>
{
  "mcpServers": {
    "webdriver": {
      "command": "mcp-server-webdriver"
    }
  }
}
</code>

Použití pojmenovaného Firefox profilu:

<code json>
{
  "mcpServers": {
    "webdriver": {
      "command": "mcp-server-webdriver",
      "args": ["-P", "work"]
    }
  }
}
</code>

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

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

===== Poznámky k bezpečnosti =====

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.

===== Shrnutí =====

''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ý.

===== Zdroje =====

  * [[https://github.com/VitexSoftware/mcp-server-webdriver|mcp-server-webdriver – GitHub]]
  * [[https://wiki.petrnosek.cz/ai/mcp/servery/chrome-devtools-mcp|Chrome DevTools MCP – článek ve wiki]]