브라우저-사용-mcp-서버

AI 에이전트가 브라우저 사용을 통해 웹 브라우저를 제어할 수 있도록 하는 MCP 서버입니다.

🔗 여러 대의 MCP 서버를 관리하시나요? 에이전트 브라우저 로 개발 워크플로를 간소화하세요

필수 조건

uv - 빠른 Python 패키지 관리자
극작가 - 브라우저 자동화
mcp-proxy - stdio 모드에 필요함

지엑스피1

환경

.env 파일을 만듭니다.

OPENAI_API_KEY=your-api-key
CHROME_PATH=optional/path/to/chrome
PATIENT=false  # Set to true if API calls should wait for task completion

설치

# Install dependencies
uv sync
uv pip install playwright
uv run playwright install --with-deps --no-shell chromium

용법

SSE 모드

# Run directly from source
uv run server --port 8000

stdio 모드

# 1. Build and install globally
uv build
uv tool uninstall browser-use-mcp-server 2>/dev/null || true
uv tool install dist/browser_use_mcp_server-*.whl

# 2. Run with stdio transport
browser-use-mcp-server run server --port 8000 --stdio --proxy-port 9000

클라이언트 구성

SSE 모드 클라이언트 구성

{
  "mcpServers": {
    "browser-use-mcp-server": {
      "url": "http://localhost:8000/sse"
    }
  }
}

stdio 모드 클라이언트 구성

{
  "mcpServers": {
    "browser-server": {
      "command": "browser-use-mcp-server",
      "args": [
        "run",
        "server",
        "--port",
        "8000",
        "--stdio",
        "--proxy-port",
        "9000"
      ],
      "env": {
        "OPENAI_API_KEY": "your-api-key"
      }
    }
  }
}

구성 위치

고객	구성 경로
커서	`./.cursor/mcp.json`
윈드서핑	`~/.codeium/windsurf/mcp_config.json`
클로드(맥)	`~/Library/Application Support/Claude/claude_desktop_config.json`
클로드(Windows)	`%APPDATA%\Claude\claude_desktop_config.json`

특징

[x] 브라우저 자동화 : AI 에이전트를 통한 브라우저 제어
[x] 이중 전송 : SSE 및 stdio 프로토콜 모두 지원
[x] VNC 스트리밍 : 브라우저 자동화를 실시간으로 시청하세요
[x] 비동기 작업 : 브라우저 작업을 비동기적으로 실행합니다.

지역 개발

패키지를 로컬로 개발하고 테스트하려면:

분배 가능한 바퀴 만들기:
# From the project root directory uv build
글로벌 도구로 설치하세요:
uv tool uninstall browser-use-mcp-server 2>/dev/null || true uv tool install dist/browser_use_mcp_server-*.whl
모든 디렉토리에서 실행:
# Set your OpenAI API key for the current session export OPENAI_API_KEY=your-api-key-here # Or provide it inline for a one-time run OPENAI_API_KEY=your-api-key-here browser-use-mcp-server run server --port 8000 --stdio --proxy-port 9000
변경 사항을 적용한 후 다시 빌드하고 다시 설치하세요.
uv build uv tool uninstall browser-use-mcp-server uv tool install dist/browser_use_mcp_server-*.whl

도커

Docker를 사용하면 서버를 실행하기 위한 일관되고 격리된 환경이 제공됩니다.

# Build the Docker image
docker build -t browser-use-mcp-server .

# Run the container with the default VNC password ("browser-use")
# --rm ensures the container is automatically removed when it stops
# -p 8000:8000 maps the server port
# -p 5900:5900 maps the VNC port
docker run --rm -p8000:8000 -p5900:5900 browser-use-mcp-server

# Run with a custom VNC password read from a file
# Create a file (e.g., vnc_password.txt) containing only your desired password
echo "your-secure-password" > vnc_password.txt
# Mount the password file as a secret inside the container
docker run --rm -p8000:8000 -p5900:5900 \
  -v $(pwd)/vnc_password.txt:/run/secrets/vnc_password:ro \
  browser-use-mcp-server

참고: 볼륨 마운트( -v )의 :ro 플래그는 보안을 강화하기 위해 컨테이너 내부에서 암호 파일을 읽기 전용으로 만듭니다.

VNC 뷰어

# Browser-based viewer
git clone https://github.com/novnc/noVNC
cd noVNC
./utils/novnc_proxy --vnc localhost:5900

기본 비밀번호: browser-use (사용자 정의 비밀번호 방식을 사용하여 재정의하지 않는 한)

예

AI에게 다음과 같이 질문해 보세요.

open https://news.ycombinator.com and return the top ranked article

지원하다

문의사항이나 문의사항은 cobrowser.xyz로 연락주세요 .

browser-use MCP Server

Integrations