MCP Browser Agent

MCP Browser Agent

Construido en el AGI House MCP Hackathon

Resumen

Este proyecto es un agente de automatización de navegador que utiliza el Protocolo de Contexto de Modelo (MCP) para habilitar interacciones con el navegador. Proporciona una integración perfecta entre Claude y las capacidades de automatización del navegador a través de nuestro servidor MCP.

¡Gracias a Browser-Use por sus capacidades de agente de navegador que ayudan a impulsar nuestro servidor MCP!

Requisitos del sistema

• macOS (darwin 24.2.0)
• Python 3.12 o superior
• uv gestor de paquetes
• Navegador Google Chrome (Asegúrate de que tu navegador esté cerrado antes de ejecutar las tareas).

Instalación

Instalación mediante Smithery

Para instalar Browser Automation Agent para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @ashley-ha/mcp-manus --client claude

Instalación manual

1. Clona el repositorio:

git clone <repository-url>
cd mcp

2. Configura el entorno de Python usando uv:

uv venv
source .venv/bin/activate
uv sync

Configuración

Configuración de Claude Desktop

Crea o modifica tu archivo de configuración de Claude Desktop:

{
  "mcpServers": {
    "browser-use": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/mcp",
        "run",
        "browser-use.py"
      ]
    }
  }
}

Reemplaza /ABSOLUTE/PATH/TO/browser-use con la ruta absoluta a tu directorio de proyecto.

Configuración del navegador

El agente está configurado para usar Google Chrome con los siguientes ajustes predeterminados:

• Modo no headless para desarrollo
• Tamaño de ventana: 1280x1100
• Funciones de seguridad deshabilitadas para pruebas
• Ruta de grabación: ./tmp/recordings

Características

• Automatización del navegador mediante herramientas MCP
• Capacidades de gestión de estado y planificación
• Detección y manipulación de elementos interactivos
• Contextos de navegador configurables
• Soporte de registro y depuración

Uso

El agente proporciona dos herramientas principales:

1. get_planner_state: Recupera el estado actual del navegador y el contexto de planificación
2. execute_actions: Ejecuta acciones planificadas en el navegador

Desarrollo

Registro

El proyecto utiliza el registro integrado de Python con la siguiente configuración:

• Todos los registros se dirigen a stderr
• Formato personalizado: %(levelname)-8s [%(name)s] %(message)s
• Nivel del registrador raíz: INFO
• Nivel de registradores de terceros: WARNING

Estructura del proyecto

• browser-use.py: Punto de entrada principal e implementación del servidor
• tmp/recordings: Directorio para grabaciones de sesiones del navegador
• Dependencias gestionadas mediante uv

Contribuciones

Este proyecto fue construido durante el AGI House MCP Hackathon. ¡Las contribuciones son bienvenidas!

Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENSE para más detalles.

Copyright (c) 2025 Jaeyun Ha, Ashley Ha

Por la presente se concede permiso, de forma gratuita, a cualquier persona que obtenga una copia de este software y de los archivos de documentación asociados (el "Software"), para tratar con el Software sin restricción, incluidos, sin limitación, los derechos de usar, copiar, modificar, fusionar, publicar, distribuir, sublicenciar y/o vender copias del Software, y para permitir a las personas a quienes se les proporcione el Software hacer lo mismo, sujeto a las siguientes condiciones:

El aviso de copyright anterior y este aviso de permiso deberán incluirse en todas las copias o partes sustanciales del Software.

EL SOFTWARE SE PROPORCIONA "TAL CUAL", SIN GARANTÍA DE NINGÚN TIPO, EXPRESA O IMPLÍCITA, INCLUYENDO PERO NO LIMITADO A LAS GARANTÍAS DE COMERCIABILIDAD, IDONEIDAD PARA UN FIN PARTICULAR Y NO INFRACCIÓN. EN NINGÚN CASO LOS AUTORES O TITULARES DEL COPYRIGHT SERÁN RESPONSABLES DE CUALQUIER RECLAMO, DAÑO U OTRA RESPONSABILIDAD, YA SEA EN UNA ACCIÓN DE CONTRATO, AGRAVIO O DE OTRO MODO, QUE SURJA DE, O EN CONEXIÓN CON, EL SOFTWARE O EL USO U OTROS ACUERDOS EN EL SOFTWARE.