Multilogin Browser MCP

CDP를 통해 Multilogin X 안티-디텍트 브라우저 프로필을 구동하고, 스트리밍 가능한 HTTP MCP 서버를 통해 AI 에이전트에 노출하는 FastAPI 서비스입니다.

기능

• 프로필 관리 — Multilogin 프로필 목록 조회, 검색, 생성, 삭제 (인위적인 제한 없이 일괄 생성 지원).

• 브라우저 세션 — 프로필 시작, CDP를 통한 Playwright 연결, 세션 수명 주기 관리.

• 브라우저 액션 카탈로그 — 이동, 클릭, 입력, JS 실행, 스크린샷, 탭, 쿠키, 스크롤, 호버 등.

• 이중 인터페이스 — 통합용 REST API 및 에이전트 프레임워크용 MCP.

• 세션 워치독 — 15분 최대 TTL 및 유휴 타임아웃 정리.

• 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 install은 필요하지 않습니다 — Multilogin이 실행하는 브라우저에 CDP로 연결합니다.

설정

예제를 복사하고 값을 입력하세요:

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. Railway에서 .env의 환경 변수를 설정합니다.

3. 시작 명령을 python main.py(또는 uvicorn app.main:app --host 0.0.0.0 --port $PORT)로 설정합니다.

런처 참고 사항

Multilogin 데스크톱 런처는 현재 127.0.0.1로 해석됩니다. 원격 호스트(예: Railway)의 경우 런처가 동일한 호스트에서 실행되거나 터널/VPN을 통해 접근 가능해야 합니다.

라이선스

MIT