Auto Browser

AI 에이전트에게 사람이 개입할 수 있는 실제 브라우저를 제공하세요.

Auto Browser는 승인된 워크플로우를 위한 MCP 네이티브 브라우저 제어 평면입니다. MCP 클라이언트, LLM 에이전트 및 운영자에게 사람의 개입(takeover), 재사용 가능한 인증 프로필, 승인, 감사 추적 및 로컬 우선 배포 기능을 갖춘 공유 Playwright 브라우저를 제공합니다.

지원 대상:

• Claude Desktop

• Cursor

• HTTP 또는 stdio 통신이 가능한 모든 MCP 클라이언트

• curl 우선 제어를 원하는 경우 직접 REST 호출

Auto Browser를 사용하는 이유

• 처음부터 MCP 네이티브. 브라우저 인터페이스가 나중에 추가된 것이 아니라 MCP 서버로 패키징되어 있습니다.

• 웹이 불안정할 때 사람의 개입 가능. noVNC를 통해 사람이 직접 개입해야 할 때 동일한 라이브 세션을 사용할 수 있습니다.

• 한 번 로그인하고 나중에 재사용. 명명된 인증 프로필을 저장하고 이미 로그인된 상태의 새로운 세션을 다시 열 수 있습니다.

• 기본적으로 로컬 우선. Docker Compose를 사용하여 자신의 컴퓨터에서 전체 스택을 실행하거나, 빠른 호스팅 데모를 위해 Codespaces를 사용하세요.

• 안전 장치 내장. 승인, 운영자 식별, PII(개인식별정보) 스크러빙, Witness 영수증 및 규정 준수 템플릿이 제품의 일부로 포함되어 있습니다.

Related MCP server: Browser-Use MCP Server

릴리스 하이라이트 (v1.0.2)

• 프레임워크 보안 업데이트: FastAPI 및 Starlette을 현재 패치된 라인으로 고정

• 더 안전한 오류 경계: 브라우저 작업, CDP, OCR, 메시, 워크플로우, 터널, 소셜 및 공유 토큰 인터페이스 전반에 걸쳐 적용

• 속도 제한 강화: 제한된 버킷 및 해시된 운영자 식별자 사용

• 호스트 및 경로 정책 강화: 프로덕션 ALLOWED_HOSTS, 인증 프로필 경로 및 업로드 루트에 대해 적용

• 1.0 플랫폼 인터페이스: 서명된 메시 위임, 워크플로우 경로, /dashboard, noVNC 개입, MCP 전송, 감사 추적 및 준비 상태 확인 포함

전체 릴리스 기록은 CHANGELOG.md를 참조하세요.

적합한 용도

• 내부 대시보드 및 관리 도구

• 운영자 지원 QA 및 브라우저 디버깅

• 한 번 로그인하고 나중에 재사용하는 계정 워크플로우

• 사람이 흐름을 복구해야 할 수 있는 불안정한 사이트

• 단순 HTML 가져오기가 아닌 실제 브라우저가 필요한 MCP 기반 에이전트 워크플로우

목표가 아닌 것

• 스텔스 또는 봇 방지 우회 작업

• CAPTCHA 해결

• 무단 스크래핑 또는 계정 자동화

• 기만적인 신원 형성 또는 우회 도구

제공 기능

퀵스타트

git clone https://github.com/LvcidPsyche/auto-browser.git
cd auto-browser
docker compose up --build

기본 설정으로 로컬 개발을 시작하기에 충분합니다.

선택 사항:

cp .env.example .env
make doctor

로컬 Docker 액세스 권한과 localhost 소켓을 열 수 있는 권한이 있는 일반 터미널에서 make doctor를 실행하세요.

열기:

• API 문서: http://127.0.0.1:8000/docs

• 운영자 대시보드: http://127.0.0.1:8000/dashboard

• 시각적 개입: http://127.0.0.1:6080/vnc.html?autoconnect=true&resize=scale

모든 게시된 포트는 기본적으로 127.0.0.1에 바인딩됩니다.

Codespaces에서 사용해 보기

Codespaces는 스택을 자동으로 프로비저닝합니다. 대시보드와 noVNC 탭은 일반적으로 약 90초 내에 준비됩니다.

첫 번째 유용한 데모

이 저장소에서 가장 신호가 강한 흐름은 다음과 같습니다:

1. 세션 생성

2. 사이트에 사람의 개입이 필요한 경우 수동으로 로그인

3. 세션을 명명된 인증 프로필로 저장

4. 해당 인증 프로필에서 새 세션 열기

5. 재인증 없이 작업 계속

여기서 시작하세요:

• examples/login-and-save-profile.md

• examples/README.md

최소 세션 생성:

curl -s http://127.0.0.1:8000/sessions \
  -X POST \
  -H 'content-type: application/json' \
  -d '{"name":"demo","start_url":"https://example.com"}' | jq

최소 관찰:

curl -s http://127.0.0.1:8000/sessions/<session-id>/observe | jq

MCP 클라이언트

Auto Browser는 다음을 노출합니다:

• http://127.0.0.1:8000/mcp의 HTTP MCP 엔드포인트

• http://127.0.0.1:8000/mcp/tools 및 http://127.0.0.1:8000/mcp/tools/call의 편의 엔드포인트

• scripts/mcp_stdio_bridge.py의 번들 stdio 브리지

기본 MCP 도구 프로필은 curated이며, 더 나은 도구 선택을 위해 브라우저 인터페이스를 간결하게 유지합니다. 전체 내부 도구 인터페이스를 원하면 다음을 설정하세요:

MCP_TOOL_PROFILE=full

원시 도구 호출 예시:

curl -s http://127.0.0.1:8000/mcp/tools/call \
  -X POST \
  -H 'content-type: application/json' \
  -d '{
    "name":"browser.create_session",
    "arguments":{
      "name":"demo",
      "start_url":"https://example.com"
    }
  }' | jq

클라이언트 설정 가이드:

• docs/mcp-clients.md

• examples/claude-desktop-setup.md

• examples/cursor-mcp-setup.md

• examples/claude_desktop_config.json

보안 및 규정 준수

실제 비공개 배포를 위해서는 최소한 다음을 설정하세요:

APP_ENV=production
API_BEARER_TOKEN=<strong-random-secret>
REQUIRE_OPERATOR_ID=true
AUTH_STATE_ENCRYPTION_KEY=<44-char-fernet-key>
REQUIRE_AUTH_STATE_ENCRYPTION=true
REQUEST_RATE_LIMIT_ENABLED=true
METRICS_ENABLED=true

COMPLIANCE_TEMPLATE은 시작 시 미리 구성된 상태를 적용할 수 있습니다:

모든 템플릿은 업로드 승인이 필요합니다. HIPAA, SOC2 및 PCI-DSS는 Witness 영수증도 활성화합니다. 시작 시 적용된 정책을 /data/compliance-manifest.json에 기록합니다.

예시:

COMPLIANCE_TEMPLATE=HIPAA docker compose up

배포 세부 정보, 호스팅된 Witness 노트, CLI 인증 모드 및 역방향 SSH 지침은 다음을 참조하세요:

• docs/deployment.md

• docs/production-hardening.md

아키텍처 요약

flowchart LR
    User[Human operator] -->|watch / takeover| noVNC[noVNC]
    LLM[OpenAI / Claude / Gemini] -->|shared tools| Controller[Controller API]
    Controller -->|Playwright protocol| Browser[Browser node]
    noVNC --> Browser
    Browser --> Artifacts[(screenshots / traces / auth state)]
    Controller --> Artifacts
    Controller --> Policy[Allowlist + approval gates]

핵심 구성 요소:

• browser-node/: Chromium, Xvfb, x11vnc 및 noVNC 실행

• controller/: FastAPI 컨트롤러, MCP 전송, 정책 레일 및 오케스트레이션 엔드포인트 노출

• data/: 런타임 아티팩트, 인증 상태, 승인, 감사 로그 및 선택적 CLI 캐시 보관

• scripts/: doctor, 스모크 테스트, 브리지 및 릴리스 확인을 위한 로컬 도우미 포함

저장소 가이드

공통 명령어

문서 맵

기여

도움을 주고 싶다면 다음에서 시작하세요:

• CONTRIBUTING.md

• docs/good-first-issues.md

• CODE_OF_CONDUCT.md

Auto Browser가 유용하다면, 별표(star)를 눌러 다른 사람들이 찾을 수 있도록 도와주세요.