Multilogin Browser MCP

{"type": "text"}# Multilogin Browser MCP

Сервис на FastAPI, который управляет профилями антидетект-браузера Multilogin X через CDP и предоставляет их ИИ-агентам через потоковый HTTP MCP-сервер.

Возможности

• Управление профилями — список, поиск, создание и удаление профилей Multilogin (поддерживается массовое создание без искусственных ограничений).

• Сессии браузера — запуск профиля, подключение Playwright через CDP и управление жизненным циклом сессии.

• Каталог действий браузера — переход по URL, клики, ввод текста, выполнение JavaScript, скриншоты, вкладки, куки, прокрутка, наведение и многое другое.

• Двойной интерфейс — REST API для интеграций и MCP для агентских фреймворков.

• Сторожевой таймер сессий — максимальное время жизни 15 минут и очистка по таймауту бездействия.

• Готовность к Railway — управление через PORT и .env.

Related MCP server: BrowserPilot

Требования

• Python 3.12+

• Десктопное приложение / агент Multilogin, запущенный локально (предоставляет лаунчер по адресу https://launcher.mlx.yt:45001, разрешающемуся в 127.0.0.1)

• Токен автоматизации Multilogin или имя пользователя + пароль

Установка

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

Установка playwright не требуется — мы подключаемся через CDP к браузеру, который запускает Multilogin.

Конфигурация

Скопируйте пример и заполните значения:

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

Запуск

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

• REST-документация: http://localhost:8000/docs

• MCP-эндпоинт: http://localhost:8000/mcp/ (POST; GET /mcp перенаправляет сюда)

REST API

Пример потока

# 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-инструменты

Укажите любой потоковый HTTP MCP-клиент на http://localhost:8000/mcp/.

Обнаружение

• list_profiles

• search_profiles

Управление профилями

• create_profile — создать один профиль

• create_profiles — создать любое количество профилей одним вызовом (без искусственных ограничений)

• remove_profiles

Сессии

• launch_session

• session_status

• list_sessions

• close_session

Браузер

• browser_action — выполнить любое действие по имени

• list_browser_actions — просмотреть полный каталог

Полный каталог действий включает: 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.

Пример конфигурации клиента

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

Развертывание

Railway

1. Запушьте репозиторий.

2. Установите переменные окружения из .env в Railway.

3. Установите команду запуска python main.py (или uvicorn app.main:app --host 0.0.0.0 --port $PORT).

Примечание о лаунчере

Десктопный лаунчер Multilogin в настоящее время разрешается в 127.0.0.1. Для удалённых хостов (например, Railway) лаунчер должен либо работать на том же хосте, либо быть доступен через туннель / VPN.

Лицензия

MIT