Multilogin Browser MCP

Ein FastAPI-Dienst, der Multilogin-X-Anti-Detect-Browserprofile über CDP steuert und sie KI-Agenten über einen streambaren HTTP-MCP-Server bereitstellt.

Funktionen

• Profilverwaltung — Multilogin-Profile auflisten, suchen, erstellen und entfernen (Stapelerstellung wird ohne künstliche Begrenzung unterstützt).

• Browser-Sitzungen — Ein Profil starten, Playwright über CDP verbinden und den Sitzungslebenszyklus verwalten.

• Browser-Aktionskatalog — Navigieren, Klicken, Tippen, JS ausführen, Screenshots, Tabs, Cookies, Scrollen, Hover und mehr.

• Doppelte Schnittstelle — REST-API für Integrationen und MCP für Agent-Frameworks.

• Sitzungs-Watchdog — Maximale TTL von 15 Minuten und Bereinigung bei Leerlauf-Timeout.

• Railway-bereit — Über PORT und .env gesteuert.

Related MCP server: BrowserPilot

Anforderungen

• Python 3.12+

• Lokal laufende Multilogin-Desktop-App / Agent (stellt den Launcher unter https://launcher.mlx.yt:45001 bereit, der auf 127.0.0.1 aufgelöst wird)

• Ein Multilogin-Automatisierungstoken oder Benutzername + Passwort

Installation

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Kein playwright install erforderlich — wir verbinden uns über CDP mit dem Browser, den Multilogin startet.

Konfiguration

Kopieren Sie das Beispiel und füllen Sie die Werte aus:

cp .env.example .env

# Option A: automation token (recommended for servers)
MULTILOGIN_AUTOMATION_TOKEN=your_token

# Option B: username + password
# MULTILOGIN_USERNAME=you@example.com
# MULTILOGIN_PASSWORD=your_password

# Optional overrides
# MULTILOGIN_API_URL=https://api.multilogin.com
# MULTILOGIN_LAUNCHER_URL=https://launcher.mlx.yt:45001
# PORT=8000
# SESSION_MAX_TTL_SECONDS=900
# SESSION_IDLE_TIMEOUT_SECONDS=300

Ausführen

python main.py
# or
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

• REST-Dokumentation: http://localhost:8000/docs

• MCP-Endpunkt: http://localhost:8000/mcp/ (POST; GET /mcp leitet hierher weiter)

REST-API

Beispielablauf

# 1. list profiles
curl http://localhost:8000/api/v1/profiles/

# 2. launch a session
curl -X POST http://localhost:8000/api/v1/sessions/ \
  -H 'content-type: application/json' \
  -d '{"profile_id":"<pid>","folder_id":"<fid>"}'

# 3. drive it
curl -X POST http://localhost:8000/api/v1/browser/sessions/<sid>/action \
  -H 'content-type: application/json' \
  -d '{"action":"navigate","params":{"url":"https://example.com"}}'

# 4. close (auto-closes after 15 min anyway)
curl -X DELETE http://localhost:8000/api/v1/sessions/<sid>

MCP-Tools

Richten Sie einen beliebigen streamable-HTTP-MCP-Client auf http://localhost:8000/mcp/ aus.

Erkennung

• list_profiles

• search_profiles

Profilverwaltung

• create_profile — ein Profil erstellen

• create_profiles — beliebig viele Profile in einem Aufruf erstellen (keine künstliche Begrenzung)

• remove_profiles

Sitzungen

• launch_session

• session_status

• list_sessions

• close_session

Browser

• browser_action — jede Aktion nach Namen ausführen

• list_browser_actions — den vollständigen Katalog ansehen

Der vollständige Aktionskatalog umfasst: navigate, click, type_text, press_key, get_text, get_html, get_url, screenshot, wait_for, evaluate_js, list_tabs, switch_tab, new_tab, close_tab, go_back, go_forward, reload, scroll, hover, select_option, set_checked, upload_file, cookies.

Beispiel-Client-Konfiguration

{
  "mcpServers": {
    "multilogin-browser": {
      "url": "http://localhost:8000/mcp/"
    }
  }
}

Bereitstellung

Railway

1. Repository pushen.

2. Umgebungsvariablen aus .env in Railway festlegen.

3. Startbefehl auf python main.py setzen (oder uvicorn app.main:app --host 0.0.0.0 --port $PORT).

Hinweis zum Launcher

Der Multilogin-Desktop-Launcher wird derzeit auf 127.0.0.1 aufgelöst. Für entfernte Hosts (z. B. Railway) muss der Launcher entweder auf demselben Host laufen oder über einen Tunnel / VPN erreichbar sein.

Lizenz

MIT