a11y-toolkit MCP

WCAG 2.2 접근성 스위트로, AI 에이전트를 위한 MCP 서버(Model Context Protocol) — 그리고 통합 CLI를 제공합니다. 핵심은 의존성 제로입니다. 모든 계산은 로컬에서 정확하게 수행됩니다(공식 상대 휘도 공식).

전체 감사 → 수정 → 문서화 → 회귀 감시 주기가 하나의 툴킷에 담겨 있습니다:

1. 감사(Audit): 모든 URL에 대한 신속한 WCAG 감사(심각도 순 결과)

2. 수정(Fix): 정확한 대비 검사 — 색상 쌍 및 이미지 위 텍스트(실제 배경의 픽셀 단위 샘플링) — 가장 가까운 통과 색상 제안 포함

3. 문서화(Document): 접근 가능한 HTML로 생성된 법적 접근성 선언(EU)

4. 감시(Watch): 빌드 간 스냅샷 및 diff로 프로덕션 출시 전 접근성 회귀를 발견

모든 도구에서 다중 언어 es/en 지원(EN 선언은 Directive (EU) 2016/2102 및 Directive (EU) 2019/882 — European Accessibility Act — 문구를 사용하며, EU 전역에서 유용합니다).

MCP 도구 (9)

Related MCP server: Accessibility MCP Server

MCP로 설치

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

또는 uv를 사용하면 클론이 필요 없습니다:

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

a11y_snapshot(브라우저 시작)을 사용할 계획이라면 "timeoutMs": 60000을 추가하세요.

통합 CLI — 모든 것을 하나의 명령으로

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

저장소에서 실행: python3 a11y.py <subcommand>.

이미지 모드 해석

• ratio_peor(최악) — 텍스트 색상에 가장 적대적인 지점.

• area_pasa_aa_texto_normal_4_5 — 안전한 표면의 %. 텍스트가 있는 곳에서 100% 미만이면: 스크림/오버레이, 크롭, 또는 텍스트 이동.

• zona_peor — 가장 심하게 실패하는 3×3 격자 셀과 정확한 좌표.

보안 및 범위

로컬 도구: 사용자 권한으로 내 컴퓨터에서 실행됩니다. path(이미지) 및 output_path(선언) 인자는 로컬 경로를 읽고/씁니다. 신뢰하는 MCP 클라이언트에서 사용하세요. 명시적으로 감사하는 URL을 가져오는 것 외에는 네트워크로 전송되는 것이 없습니다.

기술 참고 사항

• 이미지 디코딩: Pillow가 있으면 사용, 없으면 sips(macOS); PPM은 항상 사용(그래서 CI에 의존성이 필요 없습니다).

• aria-live 모니터에는 문서화된 설계 교훈이 담겨 있습니다. 패널이 의도적으로 라이브 영역이 아니며 관찰자에서 자신을 제외합니다. role="log" 패널은 자신의 선택자와 일치하여 무한 자기 관찰 루프를 만들기 때문입니다. 우리가 실제로 겪었기에 알고 있습니다.

• 실제 운영 사이트(저자의 사이트로, 자체 감사를 통과해야 함)에서 테스트했습니다.

• 인간을 위한 웹 버전(동일한 수학): jquin.net/lab — 대비(쌍 + 이미지), 선언 생성기, aria-live 모니터, 빌드 diff.

스페인어

MCP 서버 + 통합 CLI로 제공되는 WCAG 2.2 접근성 스위트. 핵심은 의존성 제로(Pillow 선택 사항, macOS의 sips, PPM은 항상). 전체 주기가 하나의 툴킷에 포함됩니다: 감사(a11y_audit_url) → 수정(픽셀 단위 샘플링 및 취약 영역 감지를 포함한 쌍 대비 및 이미지 위 텍스트 대비; 접근 가능한 색상 제안) → 문서화(접근 가능한 HTML 형식의 법적 선언 RD 1112/2018 art. 10 또는 Ley 11/2023/EAA) → 감시(빌드 간 스냅샷 및 diff: 추가/제거/이름 변경 및 포커스 순서).

MCP 도구 9개(위 표 참조) · 다중 언어 es/en(EN 선언은 Directive (EU) 2016/2102 및 Directive (EU) 2019/882의 용어를 사용) · 통합 CLI a11y와 하위 명령 pair, image, audit, declaration, snapshot, diff.

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

로컬 도구: path 및 output_path 인자는 로컬 경로를 읽고/씁니다. 명시적으로 감사하는 URL 외에는 네트워크로 전송되지 않습니다. aria-live 모니터는 설계 교훈을 문서화합니다: 패널은 의도적으로 라이브 영역이 아니며 관찰자에서 자신을 제외합니다(role="log" 패널은 자신의 선택자와 일치하여 무한 자기 관찰 루프를 만들 것입니다 — 실제로 겪었기 때문에 알고 있습니다). 인간을 위한 웹 버전: jquin.net/lab.

저자

Jesús Quintana Fernández (jquin.net) — 2003년부터 SEO/GEO 컨설턴트이자 웹 접근성 실무자. MIT © 2026.