obscura-mcp

Un adaptador de servidor MCP para Obscura, un navegador headless ligero en Rust para scraping y automatización de agentes de IA.

Expone las capacidades CDP nativas de Obscura a través de una interfaz MCP limpia: sin dependencia de Chrome, sin automatización de navegador pesada.

Instalación

npm install -g obscura-mcp

La instalación es instantánea: el binario del navegador (~80 MB) se descarga de forma diferida en el primer uso.

Después de la instalación, puedes:

• Ejecutar obscura-mcp install para descargar el binario con una barra de progreso visible, o

• Simplemente ejecutar obscura-mcp: descarga el binario automáticamente e inicia el servidor.

El binario se almacena en caché en ~/.obscura/bin/ y persiste tras las actualizaciones de npm.

Para usar una ruta de binario personalizada:

export OBSCURA_PATH=/path/to/obscura

Related MCP server: Algonius Browser

Inicio rápido

# Install
npm install -g obscura-mcp

# Verify
obscura-mcp --version

# Download browser binary
obscura-mcp install

# Start MCP server
obscura-mcp --transport stdio

Herramientas

browse_url

Obtiene una URL utilizando el motor CDP de Obscura. Devuelve el contenido de la página.

Parámetros:

• url (string, requerido): URL HTTP o HTTPS a visitar.

• dump (string, opcional): html, text o links. Por defecto es html.

• cookies (array, opcional): Cookies a inyectar antes de la navegación. Acepta el mismo formato que devuelve browse_cookies: pasa cookies exportadas desde un navegador real para acceder a páginas autenticadas.

• stealth (boolean, opcional): Aceptado por compatibilidad. El comportamiento de sigilo (stealth) es controlado por el servidor Obscura.

browse_evaluate

Navega a una URL y ejecuta JavaScript en el contexto de la página. Devuelve el resultado evaluado.

Parámetros:

• url (string, requerido): La URL a visitar.

• expression (string, requerido): Expresión JavaScript a evaluar. Ejemplos: document.title, navigator.userAgent, document.querySelector('h1').textContent.

• stealth (boolean, opcional): Aceptado por compatibilidad.

browse_cookies

Navega a una URL y recupera todas las cookies establecidas por la página. Devuelve el nombre, valor, dominio, ruta y caducidad de cada cookie.

Parámetros:

• url (string, requerido): La URL a visitar.

• stealth (boolean, opcional): Aceptado por compatibilidad.

Configuración

Claude Desktop / Cline / Continue / Cualquier cliente MCP

{
  "mcpServers": {
    "obscura-mcp": {
      "command": "obscura-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}

VS Code (extensión Cline)

{
  "servers": {
    "obscura-mcp": {
      "command": "obscura-mcp",
      "args": ["--transport", "stdio"]
    }
  }
}

Después de la instalación global de npm, obscura-mcp está en tu PATH; no se necesitan rutas absolutas.

Variables de entorno

¿Por qué Obscura?

• Sin Chrome — Rust puro, sin paquetes de navegador de 200 MB

• Nativo de CDP — expone el protocolo Chrome DevTools directamente

• Antidetección — sigilo integrado para sitios resistentes al scraping

• Tamaño minúsculo — binario de ~15 MB, inicia en milisegundos

Licencia

MIT