Selenium MCP Server

Bereitstellungsfertiger Python-MCP-Server für die Selenium-Browser-Automatisierung. Er unterstützt die lokale STDIO-Nutzung und produktionsnahes Streamable HTTP unter /mcp sowie Health-Endpunkte für Container-Plattformen.

Tools

• browser_start, browser_stop, browser_reset, browser_state

• navigate, go_back, go_forward, refresh

• set_window_size, open_new_tab, switch_window, close_window

• find_element, wait_for_element, click, type_text

• get_text, get_attribute, execute_script, scroll

• page_source, screenshot, save_screenshot

• list_cookies, add_cookie, delete_cookies

Locator-Strategien: id, name, css selector, xpath, link text, partial link text, tag name, class name.

Related MCP server: Selenium MCP Server

HTTP-Endpunkte

• POST /mcp und zugehörige Streamable HTTP-MCP-Aufrufe

• GET /healthz

• GET /readyz

• POST /browser/start

• POST /browser/stop

Lokale Einrichtung

Windows Python-Voraussetzung

Wenn PowerShell meldet, dass Python was not found, installieren Sie zuerst Python 3.11+. Die schnellsten Optionen sind:

winget install Python.Python.3.12

Schließen Sie danach PowerShell und öffnen Sie es erneut. Wenn python --version weiterhin die Microsoft Store-Aufforderung öffnet, deaktivieren Sie die python.exe- und python3.exe-App-Ausführungsaliase unter:

Settings > Apps > Advanced app settings > App execution aliases

python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

PowerShell:

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e ".[dev]"

Ausführung als lokaler STDIO-MCP-Server:

selenium-mcp

Ausführung als Streamable HTTP-MCP-Server:

selenium-mcp-http

Verbinden Sie dann MCP-Clients mit:

http://localhost:8000/mcp

Claude Desktop-Beispiel

{
  "mcpServers": {
    "selenium": {
      "command": "selenium-mcp",
      "env": {
        "SELENIUM_BROWSER": "chrome",
        "SELENIUM_HEADLESS": "true"
      }
    }
  }
}

Docker

Bauen und ausführen mit einem Chromium-Browser im Container:

docker build -t selenium-mcp .
docker run --rm -p 8000:8000 selenium-mcp

Ausführen mit einem dedizierten Selenium Grid-Browser-Container:

docker compose up --build

Konfiguration

Kopieren Sie .env.example nach .env und passen Sie die Datei an:

SELENIUM_BROWSER=chrome
SELENIUM_HEADLESS=true
SELENIUM_REMOTE_URL=
SELENIUM_IMPLICIT_WAIT_SECONDS=2
SELENIUM_PAGE_LOAD_TIMEOUT_SECONDS=30
SELENIUM_SCRIPT_TIMEOUT_SECONDS=30
SELENIUM_WINDOW_WIDTH=1440
SELENIUM_WINDOW_HEIGHT=1000
SELENIUM_ALLOW_FILE_URLS=false
SELENIUM_DEFAULT_DOWNLOAD_DIR=/tmp/selenium-downloads
SELENIUM_HTTP_HOST=0.0.0.0
SELENIUM_HTTP_PORT=8000
SELENIUM_MCP_TRANSPORT=stdio

Für ein Remote-Selenium-Grid setzen Sie:

SELENIUM_REMOTE_URL=http://selenium:4444/wd/hub

Sicherheitshinweise

Dieser Server kann im Web surfen, JavaScript ausführen, Seiten-HTML lesen und Screenshots auf dem Host speichern. Führen Sie ihn in der Produktion in einem abgesicherten Container oder einer VM aus, beschränken Sie den ausgehenden Netzwerkzugriff, behalten Sie SELENIUM_ALLOW_FILE_URLS=false bei und platzieren Sie den HTTP-MCP-Endpunkt hinter Ihrer Plattform-Authentifizierungsschicht.

Validierung

ruff check .
pytest