브라우저-사용-mcp-서버
AI 에이전트가 브라우저 사용을 통해 웹 브라우저를 제어할 수 있도록 하는 MCP 서버입니다.
🔗 여러 대의 MCP 서버를 관리하시나요? 에이전트 브라우저 로 개발 워크플로를 간소화하세요
필수 조건
지엑스피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로 연락주세요 .
스타 역사