Nik-Browser MCP

Lokaler MCP-Server, der LLM einen eigenen unabhängigen Chromium bereitstellt. Der Browser, das Anmeldeprofil und die Screenshots werden im Projektordner gespeichert und nicht mit Ihrem normalen Chrome oder Edge vermischt.

Geeignet für Windows 10/11, LM Studio und andere MCP-Clients mit Standard-stdio-Transport.

Funktionen

• Öffnen von Websites und Tabs;

• Lesen von Seitentexten und Finden von Schaltflächen, Links und Feldern;

• Klicken von Schaltflächen und Tasten;

• Ausfüllen von Textfeldern;

• Auswählen von Listenelementen und Setzen von Kontrollkästchen;

• Anhängen von Dateien und Ordnern auf GitHub, Yandex Disk, Google Drive und anderen Websites;

• Erstellen von PNG-Screenshots von Seiten;

• Überprüfen von Git-Projekten auf typische Geheimnisse;

• Zusätzliches Veröffentlichen von Repositorys über die GitHub CLI.

Related MCP server: mare-browser-mcp

Was auf dem Computer erstellt wird

Im Projektordner werden folgende Elemente erstellt:

• .venv – eine separate Python-Umgebung;

• browser-runtime – ein eigener Chromium;

• browser-profile – Cookies und Anmeldungen auf Websites;

• screenshots – Seiten-Screenshots.

Alle diese Verzeichnisse sind von Git ausgeschlossen.

Schnellinstallation für Windows

Schritt 1. Installieren Sie Python

Laden Sie Python 3.10 oder neuer von https://www.python.org/downloads/windows/ herunter.

Aktivieren Sie auf dem ersten Bildschirm des Installationsprogramms Add Python to PATH.

Schritt 2. Laden Sie das Projekt herunter

Öffnen Sie PowerShell und führen Sie Folgendes aus:

cd "$HOME\Desktop"
git clone https://github.com/Nikolay-3D/nik-browser-mcp.git
cd nik-browser-mcp

Wenn Git nicht installiert ist, laden Sie das ZIP auf der GitHub-Seite über Code → Download ZIP herunter, entpacken Sie es und öffnen Sie PowerShell im entpackten Ordner.

Schritt 3. Starten Sie die automatische Installation

powershell -ExecutionPolicy Bypass -File .\install-windows.ps1

Das Skript:

1. erstellt .venv;

2. installiert Python-Abhängigkeiten;

3. lädt Chromium in browser-runtime herunter;

4. startet Tests und den MCP-Handshake;

5. gibt ein fertiges Konfigurationsfragment aus.

Manuelle Installation von venv

Wenn das automatische Skript nicht geeignet ist:

cd "ПОЛНЫЙ\ПУТЬ\К\nik-browser-mcp"
py -3.10 -m venv .venv
.\.venv\Scripts\python.exe -m pip install --upgrade pip
.\.venv\Scripts\python.exe -m pip install -r requirements.txt

Wenn py -3.10 nicht gefunden wird, versuchen Sie py -3.

Chromium kann nach dem Anschluss installiert werden, indem Sie das Modell bitten, Folgendes aufzurufen:

browser_install_runtime с confirm="INSTALL_BROWSER"

Oder installieren Sie es vorab:

$env:PLAYWRIGHT_BROWSERS_PATH = "$PWD\browser-runtime"
.\.venv\Scripts\python.exe -m playwright install chromium

Anschluss an LM Studio

Schritt 1. Ermitteln Sie den vollständigen Pfad

In PowerShell, während Sie sich im Projektordner befinden:

$PWD.Path

Zum Beispiel erhalten Sie:

C:\Users\Ivan\Desktop\nik-browser-mcp

Schritt 2. Öffnen Sie die MCP-Konfiguration

Öffnen Sie in LM Studio den Abschnitt MCP Servers oder die Datei:

C:\Users\ВАШЕ_ИМЯ\.lmstudio\mcp.json

Schritt 3. Fügen Sie den Server hinzu

Ersetzen Sie C:\PATH\TO\nik-browser-mcp durch den tatsächlichen vollständigen Pfad:

{
  "mcpServers": {
    "Nik-Browser": {
      "command": "C:\\PATH\\TO\\nik-browser-mcp\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\PATH\\TO\\nik-browser-mcp\\run_server.py"
      ],
      "env": {
        "MCP_BROWSER_CDP_URL": "http://127.0.0.1:9333",
        "MCP_BROWSER_ALLOWED_ROOTS": "C:\\Users\\ВАШЕ_ИМЯ\\Desktop;C:\\Users\\ВАШЕ_ИМЯ\\Documents;C:\\Users\\ВАШЕ_ИМЯ\\Downloads",
        "PYTHONUTF8": "1"
      }
    }
  }
}

Wenn in mcp.json bereits andere Server vorhanden sind, löschen Sie diese nicht. Fügen Sie nur den Block "Nik-Browser": {...} in das vorhandene mcpServers ein, indem Sie ein Komma zwischen benachbarte Blöcke setzen.

Die fertige Vorlage befindet sich auch in mcp.example.json.

Aktualisieren Sie nach dem Speichern die MCP-Liste, schalten Sie den Server aus und wieder ein oder starten Sie LM Studio neu.

Erster Start

Schreiben Sie dem Modell:

Запусти собственный браузер через browser_launch, открой github.com и покажи список вкладок.

Es öffnet sich ein separates Chromium-Fenster. Melden Sie sich manuell bei den gewünschten Diensten an. Die Anmeldungen werden in browser-profile gespeichert.

Verwendung

Das Modell sollte in dieser Reihenfolge arbeiten:

1. browser_snapshot – Seitentext und Elemente e1, e2 usw. abrufen.

2. browser_click, browser_fill, browser_select_option oder browser_set_checked – Aktion ausführen.

3. Nach dem Wechsel zu einer anderen Seite – erneut browser_snapshot aufrufen.

Die IDs e1, e2 sind temporär. Der Fehler Ref expired bedeutet, dass ein neuer Snapshot benötigt wird.

Beispiel einer Suche

Открой сайт, найди поле поиска, введи запрос и покажи результаты.

Beispiel eines Datei-Uploads

Открой Яндекс Диск, найди загрузку и прикрепи файл C:\Users\Ivan\Desktop\report.pdf. Перед окончательной отправкой покажи выбранный файл.

Zum Anhängen wird browser_upload_files mit confirm_external_upload=true verwendet. Das Anhängen klickt nicht automatisch die finale Senden-Schaltfläche.

Beispiel eines Projekt-Uploads

Открой Google Drive и загрузи папку C:\Users\Ivan\Desktop\MyProject. Не отправляй ничего, пока не покажешь список файлов.

Beim Hochladen eines Ordners werden automatisch .git, .venv, venv, node_modules und __pycache__ übersprungen. Typische Geheimnisse und private Schlüssel werden blockiert.

Veröffentlichung auf GitHub

Kleine Dateien können über die GitHub-Website mit normalen Browser-Tools hochgeladen werden.

Für ein vollwertiges Git-Repository ist ein zusätzlicher Weg über die GitHub CLI praktischer:

1. github_cli_status – Installation und Anmeldung prüfen;

2. github_cli_install(confirm="INSTALL_GH") – gh über winget installieren;

3. einmal gh auth login in einer normalen PowerShell ausführen;

4. git_project_status – Projekt und Geheimnisse prüfen;

5. github_publish_project(..., confirm="PUBLISH") – Repository erstellen und pushen.

Standardmäßig verwenden Sie visibility="private". Für ein öffentliches Projekt geben Sie explizit visibility="public" an.

Installationsprüfung

.\.venv\Scripts\python.exe -m unittest discover -s tests -v
.\.venv\Scripts\python.exe smoke_test.py

Ein erfolgreiches Ergebnis enthält eine Zeile wie:

MCP handshake OK: 19 tools

Häufige Fehler

Not connected

• Überprüfen Sie die absoluten Pfade in command und args;

• Überprüfen Sie das Vorhandensein von .venv\Scripts\python.exe;

• Führen Sie smoke_test.py aus;

• Schalten Sie MCP aus und wieder ein;

• Wenn das nicht hilft – starten Sie LM Studio neu.

Private browser runtime is not installed

Rufen Sie Folgendes auf:

browser_install_runtime(confirm="INSTALL_BROWSER")

Browser did not expose CDP

Port 9333 wird von einem anderen Prozess belegt. Schließen Sie das alte Nik-Browser-Fenster oder geben Sie denselben freien Port in MCP_BROWSER_CDP_URL und browser_launch an.

Path is outside MCP_BROWSER_ALLOWED_ROOTS

Fügen Sie den gewünschten Ordner zu MCP_BROWSER_ALLOWED_ROOTS hinzu. Unter Windows werden Pfade durch Semikolon getrennt. Starten Sie MCP nach der Änderung neu.

Sicherheit

• CDP ist nur über localhost verfügbar.

• Veröffentlichen Sie niemals browser-profile: Es enthält Cookies und Anmeldungen.

• Fügen Sie browser-runtime und .venv nicht zu Git hinzu.

• Erlauben Sie dem Modell nur Zugriff auf die benötigten Verzeichnisse.

• Überprüfen Sie die Website und die Dateiliste vor confirm_external_upload=true.

• Weitere Details: SECURITY.md.

Lizenz

MIT – kann verwendet, geändert und unter Beibehaltung des Lizenztextes weitergegeben werden.