Anchor Browser

Anchor Browser (https://anchorbrowser.io) es una infraestructura segura para agentes de uso informático: navegadores en la nube sigilosos, autenticación, bypass de captchas y un servidor MCP alojado para Cursor, Claude y Windsurf.

Documentación

MCP Logo

Servidor MCP de Navegador

Un servidor de Model Context Protocol (MCP) que proporciona capacidades de automatización de navegador utilizando el servicio de navegador remoto de Anchor Browser con Playwright. Este servidor permite a los LLM interactuar con páginas web a través de los navegadores basados en la nube de Anchor con proxies integrados, funciones de sigilo y capacidades avanzadas.

Características principales

  • Ejecución de navegador remoto: Utiliza la infraestructura en la nube de Anchor Browser en lugar de navegadores locales
  • Proxies integrados: Rotación automática de proxies residenciales y segmentación geográfica
  • Sigilo y anti-detección: Huellas digitales avanzadas del navegador y detección anti-bot
  • Rápido y ligero: Utiliza el árbol de accesibilidad de Playwright, no entrada basada en píxeles
  • Amigable con LLM: No se necesitan modelos de visión, opera puramente con datos estructurados
  • Aplicación determinista de herramientas: Evita la ambigüedad común con los enfoques basados en capturas de pantalla

Requisitos

  • Node.js 18 o superior
  • Clave de API de Anchor Browser (Obtén una aquí)
  • VS Code, Cursor, Windsurf, Claude Desktop, Goose o cualquier otro cliente MCP

Primeros pasos

1. Clonar y compilar

Dado que este es un servidor MCP de navegador personalizado, debes compilarlo localmente:

# Clone the repository
git clone https://github.com/anchorbrowser/anchor-mcp.git
cd anchor-mcp

# Install dependencies and build
npm install
npm run build

2. Obtén tu clave de API de Anchor

  1. Regístrate en anchorbrowser.io
  2. Obtén tu clave de API desde el panel de control
  3. Copia tu clave de API (comienza con sk-)

3. Configurar el cliente MCP

Cursor

Añade a tu ~/.cursor/mcp.json:

{
  "mcpServers": {
    "anchor-browser": {
      "command": "node",
      "args": [
        "/path/to/anchor-mcp/cli.js"
      ],
      "env": {
        "ANCHOR_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

VS Code

Añade a tu configuración de MCP:

{
  "mcpServers": {
    "anchor-browser": {
      "command": "node",
      "args": [
        "/path/to/anchor-mcp/cli.js"
      ],
      "env": {
        "ANCHOR_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

Claude Desktop

Añade a tu claude_desktop_config.json:

{
  "mcpServers": {
    "anchor-browser": {
      "command": "node",
      "args": [
        "/path/to/anchor-mcp/cli.js"
      ],
      "env": {
        "ANCHOR_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

4. Reinicia tu cliente MCP

Después de actualizar la configuración, reinicia tu cliente MCP (Cursor, VS Code, etc.) para cargar el nuevo servidor.

Opciones de configuración

El servidor MCP de navegador solo admite opciones de configuración esenciales:

node cli.js --help

Opciones disponibles:

  • --host <host> - Host al que vincular el servidor (predeterminado: localhost, usa 0.0.0.0 para todas las interfaces)
  • --port <port> - Puerto para escuchar en el transporte HTTP (modo Docker/servidor)

Ejemplo con opciones:

{
  "mcpServers": {
    "anchor-browser": {
      "command": "node",
      "args": [
        "/path/to/anchor-mcp/cli.js",
      ],
      "env": {
        "ANCHOR_API_KEY": "sk-your-api-key-here"
      }
    }
  }
}

Modo servidor HTTP (Docker):

Para entornos Docker o servidores sin interfaz gráfica:

# Run as HTTP server
ANCHOR_API_KEY="sk-your-key" node cli.js --port 8931 --host 0.0.0.0

Luego configura tu cliente MCP para usar el endpoint HTTP:

{
  "mcpServers": {
    "anchor-browser": {
      "url": "http://localhost:8931/mcp"
    }
  }
}

¿Por qué tan pocas opciones?

Dado que Anchor Browser gestiona toda la compleja administración del navegador de forma remota, la mayoría de las opciones tradicionales del navegador son innecesarias:

  • Sin selección de navegador - Anchor utiliza navegadores remotos optimizados
  • Sin configuración de proxy - Anchor proporciona rotación de proxy integrada
  • Sin gestión de perfiles de navegador - Gestionado por la infraestructura de Anchor
  • Sin filtrado de red - Usa el panel de control de Anchor para controles avanzados
  • Sin opciones de viewport/dispositivo - Configúralas a través de la API de Anchor Browser

Esto mantiene el servidor MCP simple y enfocado en lo que importa: conectarse al servicio de navegador remoto de Anchor.

Cómo funciona

  1. Creación de sesión de navegador: Cuando usas las herramientas del navegador, el servidor MCP llama a la API de Anchor para crear una sesión de navegador remota
  2. Conexión remota: Se conecta al navegador remoto a través de WebSocket usando el Protocolo Chrome DevTools (CDP)
  3. Ejecución de herramientas: Toda la automatización del navegador ocurre en la infraestructura en la nube de Anchor
  4. Proxy y sigilo: Rotación automática de proxies residenciales y funciones avanzadas de anti-detección
  5. Gestión de sesiones: Cada sesión está aislada y se puede ver en vivo a través del panel de control de Anchor

Beneficios frente a los navegadores locales

🌐 Red global de proxies

  • Rotación automática de proxies residenciales
  • Segmentación geográfica para diferentes regiones
  • No se necesita configuración de proxy

🛡️ Sigilo avanzado

  • Protección de huellas digitales del navegador
  • Evasión de detección anti-bot
  • Entornos de navegador reales

☁️ Infraestructura en la nube

  • Sin dependencias de navegador local
  • Versiones de navegador consistentes
  • Ejecución escalable

📊 Monitoreo y depuración

  • Vista en vivo de las sesiones del navegador
  • Grabaciones y trazas de sesiones
  • Registro de solicitudes de red

Herramientas disponibles

El servidor MCP de navegador proporciona todas las herramientas estándar de automatización de navegador:

Automatización principal

  • anchor_navigate - Navegar a URLs
  • anchor_click - Hacer clic en elementos
  • browser_type - Escribir texto en campos de entrada
  • browser_snapshot - Obtener el árbol de accesibilidad de la página
  • browser_take_screenshot - Tomar capturas de pantalla
  • browser_evaluate - Ejecutar JavaScript
  • browser_wait_for - Esperar condiciones

Gestión de pestañas

  • browser_tab_new - Abrir nuevas pestañas
  • browser_tab_list - Listar pestañas abiertas
  • browser_tab_select - Cambiar entre pestañas
  • browser_tab_close - Cerrar pestañas

Funciones avanzadas

  • browser_file_upload - Subir archivos
  • browser_handle_dialog - Gestionar alertas/confirmaciones
  • browser_network_requests - Ver tráfico de red
  • browser_pdf_save - Generar PDFs (con --caps=pdf)

Solución de problemas

Clave de API no válida

Error: Missing ANCHOR_API_KEY environment variable

Solución: Asegúrate de que tu clave de API esté configurada correctamente en la configuración de MCP.

Errores de compilación

npm run build

Solución: Asegúrate de tener Node.js 18+ y ejecuta npm install primero.

Problemas de conexión

Revisa los registros de MCP para ver las respuestas de la API de Anchor y el estado de la conexión WebSocket.

Límites de sesión

Cada clave de API de Anchor tiene límites de sesión. Revisa tu panel de control en anchorbrowser.io para ver el uso.

Desarrollo

Para modificar o ampliar el servidor MCP de navegador:

# Make changes to TypeScript files in src/
# Then rebuild
npm run build

# Test your changes
node cli.js --help

El servidor utilizará automáticamente los navegadores remotos de Anchor para todas las operaciones, proporcionando los beneficios de la automatización de navegador basada en la nube con capacidades avanzadas de proxy y sigilo.

Licencia

Este proyecto está licenciado bajo la Apache License 2.0 - consulta el archivo LICENSE para más detalles.

Soporte