MCP Browser Agent

Um agente de automação de navegador que utiliza o Model Context Protocol (MCP) para permitir interações com o navegador.

GitHub

Documentação

MCP Browser Agent

Construído no AGI House MCP Hackathon

Visão Geral

Este projeto é um agente de automação de navegador que utiliza o Model Context Protocol (MCP) para permitir interações com o navegador. Ele fornece uma integração perfeita entre o Claude e os recursos de automação de navegador por meio do nosso servidor MCP.

Agradecemos ao Browser-Use pelos recursos de agente de navegador que ajudam a alimentar nosso servidor MCP!

Requisitos do Sistema

macOS (darwin 24.2.0)
Python 3.12 ou superior
Gerenciador de pacotes uv
Google Chrome (Certifique-se de que o navegador esteja fechado antes de executar as tarefas.)

Instalação

Instalando via Smithery

Para instalar o Browser Automation Agent para Claude Desktop automaticamente via Smithery:

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

Instalação Manual

Clone o repositório:

git clone <repository-url>
cd mcp

Configure o ambiente Python usando uv:

uv venv
source .venv/bin/activate
uv sync

Configuração

Configuração do Claude Desktop

Crie ou modifique o arquivo de configuração do Claude Desktop:

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

Substitua /ABSOLUTE/PATH/TO/browser-use pelo caminho absoluto para o diretório do seu projeto.

Configuração do Navegador

O agente está configurado para usar o Google Chrome com as seguintes configurações padrão:

Modo não-headless para desenvolvimento
Tamanho da janela: 1280x1100
Recursos de segurança desabilitados para testes
Caminho de gravação: ./tmp/recordings

Recursos

Automação de navegador por meio de ferramentas MCP
Gerenciamento de estado e recursos de planejamento
Detecção e manipulação de elementos interativos
Contextos de navegador configuráveis
Suporte a registro de logs e depuração

Uso

O agente fornece duas ferramentas principais:

get_planner_state: Recupera o estado atual do navegador e o contexto de planejamento
execute_actions: Executa ações planejadas no navegador

Desenvolvimento

Registro de Logs

O projeto usa o sistema de registro de logs integrado do Python com a seguinte configuração:

Todos os logs são direcionados para stderr
Formatação personalizada: %(levelname)-8s [%(name)s] %(message)s
Nível do logger raiz: INFO
Nível dos loggers de terceiros: WARNING

Estrutura do Projeto

browser-use.py: Ponto de entrada principal e implementação do servidor
tmp/recordings: Diretório para gravações de sessões do navegador
Dependências gerenciadas por meio de uv

Contribuições

Este projeto foi construído durante o AGI House MCP Hackathon. Contribuições são bem-vindas!

Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

A permissão é concedida, gratuitamente, a qualquer pessoa que obtenha uma cópia deste software e dos arquivos de documentação associados (o "Software"), para lidar com o Software sem restrições, incluindo, sem limitação, os direitos de usar, copiar, modificar, mesclar, publicar, distribuir, sublicenciar e/ou vender cópias do Software, e permitir que as pessoas a quem o Software for fornecido o façam, sujeito às seguintes condições:

O aviso de direitos autorais acima e este aviso de permissão deverão ser incluídos em todas as cópias ou partes substanciais do Software.

O SOFTWARE É FORNECIDO "NO ESTADO EM QUE SE ENCONTRA", SEM GARANTIA DE QUALQUER TIPO, EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS NÃO SE LIMITANDO ÀS GARANTIAS DE COMERCIALIZAÇÃO, ADEQUAÇÃO A UM DETERMINADO FIM E NÃO VIOLAÇÃO. EM NENHUM CASO OS AUTORES OU DETENTORES DOS DIREITOS AUTORAIS SERÃO RESPONSÁVEIS POR QUALQUER RECLAMAÇÃO, DANOS OU OUTRA RESPONSABILIDADE, SEJA EM AÇÃO DE CONTRATO, ATO ILÍCITO OU DE OUTRA FORMA, DECORRENTE DE, OU EM CONEXÃO COM O SOFTWARE OU O USO OU OUTRAS NEGOCIAÇÕES NO SOFTWARE.