WebAbility
Encontre e corrija problemas de acessibilidade web (WCAG 2.2, ADA, Section 508, EAA, AODA) diretamente do seu agente de codificação — escaneie qualquer URL/HTML com 3 mecanismos, correções com reconhecimento de framework, verificação, auditoria visual e relatórios prontos para auditores.
Documentação
@webability/mcp
Servidor MCP de testes de acessibilidade para Cursor, VS Code Copilot, Claude Code e qualquer outro IDE compatível com MCP.
O que é WebAbility?
WebAbility.io é uma plataforma de acessibilidade web com inteligência artificial — widget de acessibilidade, scanner automatizado e agentes de IA para conformidade com WCAG 2.1 / 2.2 AA, ADA, Seção 508, EAA (Lei Europeia de Acessibilidade) e AODA. Este MCP expõe o mesmo mecanismo de testes de acessibilidade que alimenta o widget WebAbility e o painel, para que você possa escanear, auditar e corrigir problemas de acessibilidade web (contraste de cores, ARIA, texto alternativo, navegação por teclado, visibilidade de foco, tamanho de alvo e muito mais) diretamente do seu IDE enquanto desenvolve.
Novo em conformidade de acessibilidade? Comece com o verificador gratuito de acessibilidade WCAG e ADA ou leia a documentação do MCP WebAbility e o guia de introdução.
O servidor registra um bloco instructions na inicialização, para que qualquer cliente compatível com MCP capture automaticamente o contexto de negócios (qual ferramenta chamar e quando, a convenção de saída em três níveis, etc.) — sem configuração adicional além da instalação abaixo.
Por que este em vez de outros MCPs de acessibilidade
A maioria dos servidores MCP de acessibilidade para em encontrar e sugerir. O WebAbility fecha todo o ciclo no seu editor e começa gratuito:
- Escaneamento local gratuito — sem conta, sem Docker.
scan_pageroda inteiramente na sua máquina. (O axe MCP da Deque exige assinatura paga, chave de API e instalação do Docker apenas para analisar uma página.) - Correções que se encaixam na sua stack.
generate_ai_fixretorna código pronto para colar no framework que você realmente usa — Tailwind, MUI, Bootstrap, WordPress, Next.js — não orientações genéricas. - Uma passada visual que scanners de DOM não conseguem fazer.
visual_auditdetecta visibilidade de foco, contraste de ícones e "parece um botão, mas não é" — problemas que o axe-core estruturalmente não consegue ver. - Verificação, não apenas detecção.
verify_fixrevalida se a sua correção realmente foi aplicada e retornaverified: true/false. Toda comparação de MCPs de acessibilidade de 2026 aponta esta como a maior lacuna da categoria — a maioria das ferramentas nunca a fecha. - Evidência para conformidade.
start_auditgera um relatório persistente com registro de data e hora e uma pasta de trabalho Excel que você pode entregar a um auditor — não um resultado que desaparece com a sua sessão.
O ciclo completo, sem sair do editor: scan_page → generate_ai_fix → verify_fix, e depois start_audit quando você precisar do registro documental.
Instalação
npm install -g @webability/mcp
Configuração
Adicione ao arquivo de configuração MCP do seu IDE:
{
"mcpServers": {
"webability": {
"command": "webability-mcp"
}
}
}
Variável de ambiente opcional: WEBABILITY_API_URL (padrão https://api.webability.io) para backends auto-hospedados.
Mecanismos de escaneamento
scan_page executa três mecanismos em paralelo e remove duplicatas dos resultados:
| Mecanismo | Regras | O que cobre |
|---|---|---|
| Detectores WebAbility | 60+ | Contraste com consciência de gradiente, nomes fracos, ícones decorativos, hierarquia de landmarks, correção de ARIA, consistência de links, tamanho de alvo, armadilhas de teclado |
| axe-core | 104 | Base padrão da indústria WCAG 2.2 |
| HTML_CodeSniffer | 200+ | Referência cruzada de técnicas da Seção 508 + WCAG |
Saída em três níveis (desde v1.2.1)
Cada escaneamento retorna:
issues— violações de alta confiança, seguras para reportar como bugsincomplete— descobertas que precisam de revisão humana (contraste em gradientes, imagens de marketing, estados pré-animação do framer-motion, axe-incomplete). Nunca corrija estas automaticamente.summary— contagens por severidade + uma contagem deincomplete
Isso espelha a divisão violations / incomplete / passes do axe-core e impede que agentes "corrijam" falsos positivos de maneiras destrutivas.
Ferramentas
| Ferramenta | O que faz |
|---|---|
scan_page | Escaneia uma URL em busca de problemas de acessibilidade WCAG (3 mecanismos) |
flow_scan | Escaneamento de jornada em várias páginas com problemas deduplicados entre páginas |
scan_html | Escaneia um trecho de HTML bruto (sem necessidade de URL) |
detect_framework | Detecta Tailwind / MUI / Bootstrap / Next.js / WP / CSS puro |
generate_ai_fix | Alternativas de correção com consciência de framework. Extrai automaticamente a paleta da marca da URL ativa em problemas de contraste. |
verify_fix | Reescaneia um elemento corrigido e confirma que a violação desapareceu — verified: true/false. Fecha o ciclo encontrar → corrigir → verificar. |
visual_audit | Auditoria em nível de pixel via visão (contraste de ícones, visibilidade de foco, parece-um-botão-mas-não-é) |
start_audit | Inicia a entrega completa da auditoria no servidor (relatório + pasta de trabalho Excel). Retorna um id para consulta. Requer uma conta. |
get_audit | Verifica o progresso de uma auditoria e, quando concluída, obtém o resumo de severidade + URLs de download do relatório/pasta de trabalho. |
check_color_contrast | Verificação de contraste WCAG em um par de cores; passe url para obter sugestões alinhadas à marca da página ativa |
check_aria | Valida atributos ARIA em um trecho de HTML |
get_rules | Lista regras do axe-core com filtro opcional por tag WCAG |
find_source | Mapeia um seletor CSS de volta para arquivos de código-fonte locais |
Quando usar este MCP
- Ao construir um novo componente e querer que ele seja acessível desde o primeiro dia
- Ao auditar uma build localhost / staging antes de publicar
- Ao fazer triagem de um relatório Lighthouse / axe —
scan_pageconsolida os três mecanismos - Ao gerar sugestões de correção que correspondem ao framework que você já usa
- Ao verificar contraste de cores com a paleta real da marca do usuário (não sugestões genéricas)
Exemplos
No Cursor / Claude Code:
"Escaneie localhost:3000 em busca de problemas de acessibilidade"
"Percorra login → painel → checkout e relate problemas únicos em todo o fluxo"
"Sugira uma correção para o problema de contraste em
.btn-primaryem https://example.com — use as cores da marca deles"
"O que a WCAG 1.4.11 verifica?"
Privacidade, registros de escaneamento e telemetria
Cada escaneamento é registrado localmente em ~/.webability/scans/ — um registro index.jsonl de uma linha por escaneamento, além do resultado completo dos seus últimos 500 escaneamentos. Navegue por eles com a ferramenta scan_history ("o que escaneamos antes?") ou com jq simples. Defina WEBABILITY_SCAN_LOG=off para desativar, WEBABILITY_SCAN_LOG_DIR para realocar.
O servidor também envia um pequeno evento de telemetria por chamada de ferramenta (todas as ferramentas, não apenas escaneamentos) para a API WebAbility: nome da ferramenta, um rótulo curto de alvo (URL, seletor, tipo de problema — nunca conteúdo da página), aprovação/reprovação, duração, contagens de problemas e um ID de instalação anônimo persistente. Resultados completos de escaneamento, HTML e código de correção gerado nunca saem da sua máquina via telemetria. Defina WEBABILITY_SCAN_TELEMETRY=off para optar por não participar.
Duas ferramentas — generate_ai_fix e visual_audit — também enviam conteúdo da página (um trecho de HTML ou uma captura de tela) para a API WebAbility para que ela possa chamar um LLM de terceiros em seu nome; a WebAbility não armazena esse conteúdo, mas o provedor de LLM o vê em trânsito. Consulte PRIVACY.md para a análise completa por ferramenta e a política de privacidade da WebAbility.
Saiba mais
Plataforma e documentação WebAbility
- WebAbility.io — a plataforma de acessibilidade (widget, scanner, agentes de IA, painel)
- Documentação do servidor MCP · toda a documentação
- Widget de acessibilidade — instalação em uma linha, remediação compatível com WCAG para sites ativos
- Auditoria profissional de acessibilidade · acessibilidade gerenciada
- Verificador gratuito de acessibilidade WCAG e ADA — escaneie qualquer URL em segundos
- Preços · oferta vitalícia
Guias de conformidade de acessibilidade
- WCAG 2.1 / 2.2 AA — Diretrizes de Acessibilidade para Conteúdo Web
- Conformidade ADA — Lei dos Americanos com Deficiências
- Seção 508 — requisitos federais de acessibilidade dos EUA
- EAA — Lei Europeia de Acessibilidade · AODA — Ontário (Canadá)
Acessibilidade por setor
Instale o widget na sua stack
Pacote
- npm:
@webability/mcp· Código-fonte: github.com/snayyar00/webability-mcp
Palavras-chave: acessibilidade web, testes de acessibilidade, WCAG 2.2 AA, conformidade ADA, Seção 508, EAA, AODA, a11y, scanner de acessibilidade, verificador de contraste de cores, validação ARIA, texto alternativo, navegação por teclado, leitor de tela, servidor MCP, acessibilidade para agentes de codificação com IA.
Licença
MIT © WebAbility.io