Browser Control MCP

Permite que agentes de IA controlen un navegador local, gestionen pestañas y realicen investigaciones a través de una extensión de navegador.

GitHub
326
Prueba este MCPPatrocinado

Documentación

Browser Control MCP

Firefox Add-on

Un servidor MCP emparejado con una extensión de Firefox que proporciona a los asistentes de IA acceso a la gestión de pestañas, el historial de navegación y el contenido de texto de las páginas web.

Características

El servidor MCP admite las siguientes herramientas:

  • Abrir o cerrar pestañas
  • Obtener la lista de pestañas abiertas
  • Crear grupos de pestañas con nombre y color
  • Reordenar pestañas abiertas
  • Leer y buscar en el historial del navegador
  • Leer el contenido de texto y los enlaces de una página web (requiere consentimiento del usuario)
  • Buscar y resaltar texto en una pestaña del navegador (requiere consentimiento del usuario)
  • Capturar una captura de pantalla del área visible de una pestaña (requiere consentimiento del usuario por pestaña)

Ejemplos de casos de uso:

Gestión de pestañas

  • "Cierra todas las pestañas no relacionadas con el trabajo en mi navegador."
  • "Agrupa todas las pestañas relacionadas con desarrollo en mi navegador en un nuevo grupo llamado 'Desarrollo'."
  • "Reorganiza las pestañas de mi navegador en un orden que tenga sentido."
  • "Cierra todas las pestañas de mi navegador que no hayan sido accedidas en las últimas 24 horas."

Búsqueda en el historial del navegador

  • "Ayúdame a encontrar un artículo en mi historial de navegación sobre el sendero Milford en Nueva Zelanda."
  • "Abre todos los artículos sobre IA que visité durante la última semana, hasta 10 artículos, evita duplicados."

Navegación e investigación

  • "Abre hackernews en mi navegador, luego abre la historia principal, léela y también lee los comentarios. ¿Están de acuerdo los comentarios con la historia?"
  • "En mi navegador, usa Google Scholar para buscar artículos sobre L-teanina en los últimos 3 años. Abre los 3 artículos más citados. Léelos y resúmelos para mí."
  • "Usa la búsqueda de Google en mi navegador para buscar floristerías. Abre los 10 resultados más relevantes. Muéstrame una tabla de cada floristería con ubicación y horario de apertura."

Comparación con servidores MCP de automatización web

La combinación del servidor MCP y la extensión de Firefox está diseñada para ser más segura que los servidores MCP de automatización web, permitiendo un uso más seguro con el navegador personal del usuario.

  • No admite modificación de páginas web, interacciones con la página ni scripting arbitrario.
  • Leer el contenido de una página web requiere el consentimiento explícito del usuario en el navegador para cada dominio. Esto se aplica a nivel del manifiesto de la extensión.
  • Las capturas de pantalla requieren que el usuario autorice cada pestaña individual haciendo clic en el botón de la barra de herramientas de la extensión. La extensión depende del permiso activeTab para esto, por lo que la autorización es aplicada por el propio Firefox y expira cuando la pestaña navega o se cierra. La extensión nunca solicita permisos amplios de host para capturas de pantalla.
  • Utiliza una conexión solo local con un secreto compartido entre el servidor MCP y la extensión.
  • Sin recopilación de datos remota ni seguimiento.
  • Proporciona un registro de auditoría en la extensión para las llamadas a herramientas y la configuración de habilitación/deshabilitación de herramientas.
  • La extensión no incluye dependencias de terceros en tiempo de ejecución.

Nota importante: Browser Control MCP aún es experimental. Úsalo bajo tu propio riesgo. Debes tener precaución como con cualquier otro servidor MCP y autorizar/monitorear las llamadas a herramientas con cuidado.

Instalación

Opción 1: Instalar las extensiones de Firefox y Claude Desktop

La extensión / complemento de Firefox está disponible en addons.mozilla.org. También puedes descargar y abrir la última versión precompilada desde este repositorio de GitHub: browser-control-mcp-1.5.0.xpi. Completa la instalación según las instrucciones en la página "Administrar extensión", que se abrirá automáticamente después de la instalación.

La página "Administrar extensión" del complemento incluirá un enlace al archivo DXT de Claude Desktop. También puedes descargarlo aquí: mcp-server-v1.5.2.dxt. Después de descargar el archivo, ábrelo o arrástralo a la ventana de configuración de Claude Desktop. Asegúrate de habilitar la extensión DXT después de instalarla. Esto solo funcionará con las últimas versiones de Claude Desktop. Si deseas instalar el servidor MCP localmente, consulta la configuración de MCP a continuación.

Opción 2: Compilar desde el código

Para compilar desde el código, clona este repositorio y luego ejecuta los siguientes comandos en el directorio principal del repositorio para compilar tanto el servidor MCP como la extensión del navegador.

npm install
npm run build

Instalar un complemento temporal en Firefox

Para instalar la extensión en Firefox como complemento temporal:

  1. Escribe about:debugging en la barra de URL de Firefox
  2. Haz clic en "Este Firefox"
  3. Haz clic en "Cargar complemento temporal..."
  4. Selecciona el archivo manifest.json dentro de la carpeta firefox-extension en este proyecto
  5. Se abrirá la página de preferencias de la extensión. Copia la clave secreta en tu portapapeles. Se usará para configurar el servidor MCP.

Alternativamente, para instalar un complemento permanente, puedes instalar Browser Control MCP en addons.mozilla.org y luego configurar el servidor MCP como se detalla a continuación.

Si prefieres no ejecutar la extensión en tu navegador Firefox personal, una alternativa es descargar una instancia separada de Firefox (como Firefox Developer Edition, disponible en https://www.mozilla.org/en-US/firefox/developer/).

Configuración del servidor MCP

Después de instalar la extensión del navegador, agrega la siguiente configuración a tu configuración de mcpServers (por ejemplo, claude_desktop_config.json para Claude Desktop):

{
    "mcpServers": {
        "browser-control": {
            "command": "node",
            "args": [
                "/path/to/repo/mcp-server/dist/server.js"
            ],
            "env": {
                "EXTENSION_SECRET": "<secret_on_firefox_extension_options_page>",
                "EXTENSION_PORT": "8089" 
            }
        }
    }
}

Reemplaza /path/to/repo con la ruta correcta.

Establece EXTENSION_SECRET con el valor que se muestra en la página de preferencias de la extensión en Firefox (puedes acceder a ella en about:addons). También puedes establecer la variable de entorno EXTENSION_PORT para especificar el puerto que el servidor MCP usará para comunicarse con la extensión (el valor predeterminado es 8089).

Puede tomar unos segundos para que el servidor MCP se conecte a la extensión.

Configurar el servidor MCP con Docker

Alternativamente, puedes usar una configuración basada en Docker. Para hacerlo, compila la imagen Docker del servidor MCP:

docker build -t browser-control-mcp .

y usa la siguiente configuración de mcpServers:

{
    "mcpServers": {
        "browser-control": {
            "command": "docker",
            "args": [
                "run",
                "--rm",
                "-i",
                "-p", "127.0.0.1:8089:8089",
                "-e", "EXTENSION_SECRET=<secret_from_extension>",
                "-e", "CONTAINERIZED=true",
                "browser-control-mcp"
            ]
        }
    }
}