uso del navegador mcp-servidor
Un servidor MCP que permite a los agentes de IA controlar los navegadores web mediante el uso del navegador .
¿Administras varios servidores MCP? Simplifica tu flujo de trabajo de desarrollo con el agente-navegador.
Prerrequisitos
- uv - Gestor rápido de paquetes de Python
- Dramaturgo - Automatización del navegador
- mcp-proxy : necesario para el modo stdio
# Install prerequisites
curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install mcp-proxy
uv tool update-shell
Ambiente
Crea un archivo .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
Instalación
# Install dependencies
uv sync
uv pip install playwright
uv run playwright install --with-deps --no-shell chromium
Uso
Modo SSE
# Run directly from source
uv run server --port 8000
Modo 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
Configuración del cliente
Configuración del cliente en modo SSE
{
"mcpServers": {
"browser-use-mcp-server": {
"url": "http://localhost:8000/sse"
}
}
}
Configuración del cliente en modo 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"
}
}
}
}
Ubicaciones de configuración
| Cliente | Ruta de configuración |
|---|
| Cursor | ./.cursor/mcp.json |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| Claude (Mac) | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Claude (Windows) | %APPDATA%\Claude\claude_desktop_config.json |
Características
- [x] Automatización del navegador : controle los navegadores mediante agentes de IA
- [x] Transporte dual : compatibilidad con los protocolos SSE y stdio
- [x] Transmisión VNC : vea la automatización del navegador en tiempo real
- [x] Tareas asincrónicas : ejecuta operaciones del navegador de forma asincrónica
Desarrollo local
Para desarrollar y probar el paquete localmente:
- Construir una rueda distribuible:
# From the project root directory
uv build
- Instalarlo como herramienta global:
uv tool uninstall browser-use-mcp-server 2>/dev/null || true
uv tool install dist/browser_use_mcp_server-*.whl
- Ejecutar desde cualquier directorio:
# 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
- Después de realizar los cambios, reconstruya y reinstale:
uv build
uv tool uninstall browser-use-mcp-server
uv tool install dist/browser_use_mcp_server-*.whl
Estibador
El uso de Docker proporciona un entorno consistente y aislado para ejecutar el servidor.
# 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
Nota: La bandera :ro en el montaje del volumen ( -v ) hace que el archivo de contraseña sea de sólo lectura dentro del contenedor para mayor seguridad.
Visor VNC
# Browser-based viewer
git clone https://github.com/novnc/noVNC
cd noVNC
./utils/novnc_proxy --vnc localhost:5900
Contraseña predeterminada: browser-use (a menos que se anule mediante el método de contraseña personalizada)
Ejemplo
Intenta preguntarle a tu IA:
open https://news.ycombinator.com and return the top ranked article
Apoyo
Para problemas o consultas: cobrowser.xyz
Historia de las estrellas