Accessibility Scanner

accessibility-scanner-mcp

Um servidor MCP que permite a um agente de IA escanear uma página da web em busca de problemas de acessibilidade WCAG e obter descobertas sobre as quais pode agir. O agente chama uma ferramenta com uma URL; ele recebe cada violação agrupada por severidade, cada uma com o seletor de elemento exato, o HTML ofensivo, a falha específica, o critério de sucesso WCAG e um link de guia de correção — além dos itens que ainda precisam de revisão humana.

Ele executa o motor real axe-core no seu Chrome local (via playwright-core), então nada sobre as páginas que você escaneia sai da sua máquina. Ele rola a página primeiro para que conteúdo carregado de forma preguiçosa seja realmente verificado em vez de ser silenciosamente ignorado, e resolve o contraste de cores sobre gradientes CSS, o que a maioria das ferramentas deixa como "precisa de revisão."

Atualizando da versão 0.1.x? A 0.2.0 vê mais de cada página e retorna mais descobertas para a mesma URL. Veja CHANGELOG.md.

Parte de accessibilityscanner.app.

Requisitos

• Node.js 18+
• Um navegador baseado em Chromium: Chrome, Chromium ou Edge, encontrados automaticamente nessa ordem. Defina CHROME_PATH para apontar para um binário específico se preferir escolher. Um navegador já instalado pelo Playwright é usado como último recurso; nada é baixado para você.

Ou nenhum navegador

Defina SCANNER_API_URL e a varredura acontece no accessibilityscanner.app em vez de localmente:

{ "env": { "SCANNER_API_URL": "https://accessibilityscanner.app" } }

Nenhuma conta ou chave é necessária — ele usa os mesmos endpoints públicos que o formulário do próprio site usa. Útil em CI, em um contêiner, ou em qualquer lugar onde você não possa instalar um navegador. Varreduras hospedadas também carregam cores de correção sugeridas para falhas de contraste, que o scanner local ainda não calcula.

⚠️ Neste modo, a URL que você escaneia é enviada ao nosso servidor. O caminho local não envia nada para lugar nenhum, e permanece o padrão — o modo hospedado é opcional apenas através dessa variável de ambiente.

Instalação

Adicione-o à configuração do seu cliente MCP. Nenhuma instalação global é necessária — npx o busca na primeira execução.

Claude Desktop (claude_desktop_config.json), Cursor, Claude Code, ou qualquer cliente MCP:

{
  "mcpServers": {
    "accessibility-scanner": {
      "command": "npx",
      "args": ["-y", "accessibility-scanner-mcp"]
    }
  }
}

Se o Chrome não for detectado automaticamente, adicione um bloco de ambiente:

{
  "mcpServers": {
    "accessibility-scanner": {
      "command": "npx",
      "args": ["-y", "accessibility-scanner-mcp"],
      "env": { "CHROME_PATH": "/usr/bin/google-chrome" }
    }
  }
}

A ferramenta

scan_accessibility

Entrada
url (string, obrigatório)	A URL http(s) a ser escaneada.

Retorna um relatório agrupado por severidade. Para cada regra: o critério WCAG, um link de guia de correção, e por elemento o seletor, HTML e falha exata. Exemplo de fluxo com um agente:

Você: Audite https://example.com para acessibilidade e corrija o que puder. Agente: (chama scan_accessibility) → lê as descobertas → edita o código → re-escaneia.

Honesto sobre limites

Testes automatizados cobrem o subconjunto verificável por máquina do WCAG (a maioria dos problemas em uma página típica, mas não todos). Itens que precisam de julgamento humano são retornados sob "Precisa de revisão manual." Ele nunca afirma que uma página está "em conformidade."

Licença

MIT