convez.ai
MCP ServerDesenvolvimento WebAvançado
DavidPivert

Ara RGAA MCP — Auditor de Acessibilidade Assistido por IA

DavidPivert/ara-rgaa-mcp

Automate audits RGAA 4.1 via IA com protocolo MCP

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que expõe operações CRUD sobre audits de acessibilidade RGAA 4.1 da plataforma Ara do governo francês. Permite pilotar audits de acessibilidade completamente via Claude ou qualquer cliente MCP compatível, sem necessidade de login manual. Integração completa com fluxos de trabalho assistidos por IA para conformidade WCAG/RGAA.

Instalação

$npx convez-ai DavidPivert/ara-rgaa-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
5
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Auditar acessibilidade web em fluxo automatizado via Claude
  • Gerar relatórios de conformidade RGAA sem interface web manual
  • Integrar avaliações WCAG em pipelines de CI/CD e automação

Veredito

Ferramenta especializada e bem estruturada para automação de audits RGAA via MCP. Excelente para equipes que já usam Ara e querem integrar avaliações de acessibilidade em workflows assistidos. Requer conta Ara ativa e Node.js ≥18; nicho técnico legítimo mas público-alvo limitado.

README

A tradução para o português deste README ainda está na fila.

Ara MCP Server — Audits RGAA via IA

Serveur MCP (Model Context Protocol) qui expose les opérations CRUD sur les audits d'accessibilité RGAA de la plateforme Ara. Permet de piloter un audit Ara entièrement depuis Claude Code, Codex ou tout client MCP compatible — sans login manuel dans le navigateur.

Cartographie des routes Ara

Audits (/audits)

MéthodeRouteOutil MCPDescription
POST/auditscreate_auditCréer un nouvel audit
GET/audits/:uniqueIdget_auditRécupérer un audit complet
PUT/audits/:uniqueIdupdate_auditMise à jour complète d'un audit
PATCH/audits/:uniqueIdpatch_audit_notesMettre à jour les notes uniquement
DELETE/audits/:uniqueIddelete_auditSupprimer un audit (soft delete)
POST/audits/:uniqueId/duplicateduplicate_auditDupliquer un audit
PUT/audits/:uniqueId/publishpublish_auditPublier un audit terminé
GET/audits/:uniqueId/resultsget_audit_resultsRécupérer tous les résultats de critères
PATCH/audits/:uniqueId/resultsupdate_audit_resultsMettre à jour les résultats de critères (batch)
GET/audits/:uniqueId/pages/:slugget_page_resultsRésultats par page
GET/audits/:uniqueId/exports/csvexport_csvExport CSV des résultats
PUT/audits/:editUniqueId/statementupdate_statementMettre à jour la déclaration d'accessibilité

Rapports (/reports) — lecture seule

MéthodeRouteOutil MCPDescription
GET/reports/:consultUniqueIdget_reportRapport complet avec taux de conformité

Authentification (/auth)

MéthodeRouteOutil MCPDescription
POST/auth/signinauth_signinAuthentification par email/mot de passe

Routes non exposées (hors périmètre MCP)

RouteRaison
POST /audits/:id/results/examplesUpload d'image (deprecated)
POST /audits/:id/notes/filesUpload de fichier
POST /audits/editor/imagesUpload d'image éditeur
DELETE /audits/:id/results/examples/:idSuppression image
DELETE /audits/:id/notes/files/:idSuppression fichier
GET /auditsListe d'audits (nécessite auth account)
POST /auth/signupCréation de compte
POST /auth/verifyVérification de compte
PATCH /profileProfil utilisateur
POST /feedbackRetour utilisateur

Installation

git clone https://github.com/DavidPivert/ara-rgaa-mcp.git
cd ara-rgaa-mcp
npm install
npm run build

Prérequis : Node.js ≥ 18 et un compte sur ara.numerique.gouv.fr.

Configuration

Variables d'environnement

VariableDéfautDescription
ARA_BASE_URLhttps://ara.numerique.gouv.fr/apiURL de base de l'API Ara
ARA_AUTH_TOKEN—Token JWT pré-configuré (évite le login)
ARA_USERNAME—Email pour auto-login au démarrage
ARA_PASSWORD—Mot de passe pour auto-login au démarrage

Config Claude Code (recommandé)

Ajouter dans ~/.claude/claude_desktop_config.json :

{
  "mcpServers": {
    "ara-rgaa": {
      "command": "bash",
      "args": ["/absolute/path/to/ara-rgaa-mcp/run.sh"],
      "env": {
        "ARA_BASE_URL": "https://ara.numerique.gouv.fr/api",
        "ARA_USERNAME": "votre-email@example.com",
        "ARA_PASSWORD": "votre-mot-de-passe"
      }
    }
  }
}

Important : Le script run.sh fait un cd dans le dossier du projet avant de lancer Node, ce qui garantit la résolution correcte des node_modules. Ne pas appeler node build/index.js directement depuis un autre répertoire.

Config alternative (mode dev avec npx tsx)

{
  "mcpServers": {
    "ara-rgaa": {
      "command": "npx",
      "args": ["--prefix", "/absolute/path/to/ara-rgaa-mcp", "tsx", "src/index.ts"],
      "env": {
        "ARA_BASE_URL": "https://ara.numerique.gouv.fr/api",
        "ARA_AUTH_TOKEN": "votre-jwt-token"
      }
    }
  }
}

Config Codex / Cursor

Même format — ajuster dans les réglages MCP de l'outil.

Workflow typique

1. auth_signin(username, password)          # Ou auto-login via env vars
2. create_audit(FULL, "MonSite", pages...)  # Créer l'audit
3. get_audit(editUniqueId)                  # Vérifier les pages et IDs
4. update_audit_results(editUniqueId, [...]) # Remplir les critères RGAA
5. get_audit_results(editUniqueId)          # Vérifier les résultats
6. update_statement(editUniqueId, ...)      # Remplir la déclaration
7. publish_audit(editUniqueId)              # Publier l'audit terminé
8. get_report(consultUniqueId)              # Consulter le rapport final

Enums RGAA

Types d'audit

  • FULL — 106 critères (audit complet)
  • FAST — 25 critères (audit rapide)
  • COMPLEMENTARY — 50 critères (audit complémentaire)

Statuts de critère

  • COMPLIANT — Conforme
  • NOT_COMPLIANT — Non conforme
  • NOT_APPLICABLE — Non applicable
  • NOT_TESTED — Non testé

Impact utilisateur

  • MINOR — Mineur
  • MAJOR — Majeur
  • BLOCKING — Bloquant

Thématiques RGAA (topics 1-13)

  1. Images
  2. Cadres
  3. Couleurs
  4. Multimédia
  5. Tableaux
  6. Liens
  7. Scripts
  8. Éléments obligatoires
  9. Structuration de l'information
  10. Présentation de l'information
  11. Formulaires
  12. Navigation
  13. Consultation

Licence

Même licence que le projet Ara (EUPL).

Ver o original no GitHub

Bom para

Relacionados