Autoconsent MCP

Autoconsent MCP

Um servidor Model Context Protocol que fornece capacidades de automação de navegador especificamente projetadas para criar e testar regras do Autoconsent. Este servidor permite que LLMs interajam com páginas web, inspecionem plataformas de gerenciamento de consentimento (CMPs) e testem regras do Autoconsent em um ambiente de navegador real.

[!CAUTION] Este servidor pode acessar arquivos locais e endereços IP locais/internos, pois executa um navegador na sua máquina. Tenha cuidado ao usar este servidor MCP para garantir que isso não exponha dados sensíveis.

Componentes

Ferramentas

• navigate

  • Navegar para qualquer URL no navegador
  • Entradas:
    • url (string, obrigatório): URL para navegar

• screenshot

  • Tirar capturas de tela da página inteira ou de elementos específicos
  • Entradas:
    • name (string, obrigatório): Nome para a captura de tela
    • width (number, opcional, padrão: 1280): Largura da captura de tela
    • height (number, opcional, padrão: 720): Altura da captura de tela
    • encoded (boolean, opcional): Se verdadeiro, captura a captura de tela como um data URI codificado em base64 (como texto) em vez de conteúdo de imagem binário. Padrão falso.

• click

  • Clicar em elementos na página
  • Entrada: selector (string): Seletor CSS para o elemento a ser clicado

• select

  • Selecionar um elemento com a tag SELECT
  • Entradas:
    • selector (string): Seletor CSS para o elemento a ser selecionado
    • value (string): Valor a ser selecionado

• evaluate

  • Executar JavaScript no console do navegador
  • Entrada: script (string): Código JavaScript a ser executado

• search_html

  • Exibe o HTML dos elementos que contêm profundamente a consulta de pesquisa fornecida. Elementos que não contêm a consulta fornecida são omitidos usando um espaço reservado [...].
  • Entrada: query (string): Consulta de pesquisa

• print_element

  • Exibe o HTML completo do elemento fornecido
  • Entrada: selector (string): Seletor CSS

• test_rule

  • Testa a regra do Autoconsent fornecida na URL fornecida
  • Entradas:
    • url (string, obrigatório): URL para navegar
    • rule (object, obrigatório): Regra do Autoconsent (AutoConsentCMPRule)

Recursos

O servidor fornece acesso a dois tipos de recursos:

1. Console Logs (console://logs)

   • Saída do console do navegador em formato de texto
   • Inclui todas as mensagens do console do navegador

2. Screenshots (screenshot://)

   • Imagens PNG das capturas de tela
   • Acessíveis pelo nome da captura de tela especificado durante a captura

Instalação e Configuração

Pré-requisitos

• Node.js (versão 18 ou superior)
• npm

Configuração

npm install
npm run build

Executando o Servidor

Para desenvolvimento:

npm run dev

Para produção:

npm start

Site de Teste

npm run serve-test-site

Isso inicia um servidor HTTP local na porta 8080 servindo o diretório test-site.

Testes

npm run test:unit
npm run test:integration

Observe que os testes de integração exigem que o site de teste esteja em execução (veja acima).

Configuração para Claude Desktop

Adicione o seguinte à sua configuração do Claude Desktop:

{
  "mcpServers": {
    "autoconsent-mcp": {
      "command": "node",
      "args": ["path/to/autoconsent-mcp/dist/index.js"]
    }
  }
}

Atribuição e licença

Este projeto é baseado no servidor MCP Puppeteer de https://github.com/modelcontextprotocol/servers-archived/tree/main/src/puppeteer.

Este servidor MCP é licenciado sob a Licença MIT. Isso significa que você é livre para usar, modificar e distribuir o software, sujeito aos termos e condições da Licença MIT.