a11y-toolkit MCP

Una suite de accesibilidad WCAG 2.2 como servidor MCP (Model Context Protocol) para agentes de IA — además de un CLI unificado. Cero dependencias en su núcleo; toda la matemática es local y exacta (la fórmula oficial de luminancia relativa).

El ciclo completo auditar → corregir → documentar → vigilar regresiones, en un solo toolkit:

1. Auditar: auditoría WCAG exprés de cualquier URL (hallazgos ordenados por severidad)

2. Corregir: comprobaciones exactas de contraste — pares de color y texto sobre imágenes (muestreo a nivel de píxel del fondo real) — con sugerencias del color aprobado más cercano

3. Documentar: declaraciones legales de accesibilidad (UE), generadas como HTML accesible

4. Vigilar: snapshots + diffs entre builds para detectar regresiones de accesibilidad antes de producción

Multilenguaje es/en en todas las herramientas (las declaraciones EN usan la redacción de la Directiva (UE) 2016/2102 y la Directiva (UE) 2019/882 — European Accessibility Act —, útil en toda la UE).

Herramientas MCP (9)

Related MCP server: Accessibility MCP Server

Instalar como MCP

{
  "mcpServers": {
    "a11y-toolkit": {
      "command": "python3",
      "args": ["/path/to/a11y-toolkit/server.py"]
    }
  }
}

O con uv, sin necesidad de clonar:

{
  "mcpServers": {
    "a11y-toolkit": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/kinti/a11y-toolkit", "a11y-toolkit-mcp"]
    }
  }
}

Añade "timeoutMs": 60000 si planeas usar a11y_snapshot (arranque del navegador).

CLI unificado — un comando para todo

a11y pair "#1f2328" "#fbfaf7"                     # contrast, per-criterion verdicts
a11y image hero.jpg --text "#ffffff" --region 120,40,420,90
a11y audit --url https://example.com              # express WCAG audit
a11y declaration --entidad "Acme" --url https://acme.example \
       --estado parcial --marco eaa --lang en --output decl.html
a11y snapshot https://mysite --out before.json    # before deploy (needs Playwright)
a11y diff before.json after.json                  # after deploy

Ejecuta desde el repositorio: python3 a11y.py <subcomando>.

Interpretando el modo de imagen

• ratio_peor (peor) — el punto más hostil para el color de tu texto.

• area_pasa_aa_texto_normal_4_5 — % de superficie segura. Si < 100% donde se asienta el texto: scrim/overlay, recorta o mueve el texto.

• zona_peor — la celda de la cuadrícula 3×3 que falla más, con coordenadas exactas.

Seguridad y alcance

Una herramienta local: se ejecuta en tu máquina como tu usuario. Los argumentos path (imagen) y output_path (declaración) leen/escriben rutas locales — úsala en clientes MCP de confianza. Nada se envía por la red (excepto la obtención de la URL que audites explícitamente).

Notas técnicas

• Decodificación de imágenes: Pillow si está disponible, si no sips (macOS); PPM siempre (por eso CI no necesita dependencias).

• El monitor aria-live lleva una lección de diseño documentada: su panel NO es deliberadamente una región viva y se autoexcluye del observador — un panel role="log" coincidiría con su propio selector y crearía un bucle infinito de auto-observación. Lo sabemos porque nos pasó.

• Probado contra sitios de producción reales (los del propio autor, que deben pasar su propia auditoría).

• Versiones web para humanos (misma matemática): jquin.net/lab — contraste (pares + imagen), generador de declaraciones, monitor aria-live, diff de builds.

Español

Suite de accesibilidad WCAG 2.2 como servidor MCP + CLI unificado. Cero dependencias en el núcleo (Pillow opcional; sips en macOS; PPM siempre). Todo el ciclo en un toolkit: auditar (a11y_audit_url) → corregir (contraste de pares y texto sobre imagen con muestreo píxel a píxel y detección de zona hostil; sugerencia de color accesible) → documentar (declaración legal RD 1112/2018 art. 10 o Ley 11/2023/EAA, en HTML accesible) → vigilar (snapshots y diff entre builds: añadidos/eliminados/renombrados y orden de foco).

9 herramientas MCP (ver tabla superior) · multilenguaje es/en (la declaración EN usa la terminología de las Directivas (UE) 2016/2102 y 2019/882) · CLI unificado a11y con subcomandos pair, image, audit, declaration, snapshot, diff.

{ "mcpServers": { "a11y-toolkit": {
    "command": "python3", "args": ["/ruta/al/repo/server.py"] } } }

Herramienta local: los argumentos path y output_path leen/escriben rutas locales; nada sale a la red salvo la URL que audites explícitamente. El monitor aria-live documenta su lección de diseño: el panel NO es una región viva y se autoexcluye del observador (un role="log" casaría con su propio selector y crearía un bucle infinito de auto-observación — lo sabemos porque nos pasó). Versiones web para humanos: jquin.net/lab.

Autor / Author

Jesús Quintana Fernández (jquin.net) — consultor SEO/GEO y profesional de accesibilidad web desde 2003. MIT © 2026.