npm package: @rgaaudit/mcp-server
Description: MCP Server RGAA 4.1 — Audit d'accessibilité pour Claude Code, Cursor, Copilot
Latest version: 0.5.0

# @rgaaudit/mcp-server

Serveur MCP (Model Context Protocol) pour auditer l'accessibilité web selon le référentiel français **RGAA 4.1**, directement depuis votre IDE.

Compatible **Claude Code**, **Cursor**, **Copilot**, **Windsurf**.

## Installation rapide

```bash
npx @rgaaudit/mcp-server
```

## Configuration

### 1. Obtenir une clé API

1. Créez un compte sur [rgaaudit.fr](https://rgaaudit.fr)
2. Choisissez un plan **Freelance** ou supérieur (le plan Découverte ne donne pas accès à l'API)
3. Allez dans **Paramètres > API**
4. Générez une clé API (préfixe `rga_`)

### 2. Configurer Claude Code

Ajoutez dans `.mcp.json` à la racine de votre projet :

```json
{
  "mcpServers": {
    "rgaaudit": {
      "command": "npx",
      "args": ["-y", "@rgaaudit/mcp-server"],
      "env": {
        "RGAA_API_KEY": "rga_votre_cle_ici"
      }
    }
  }
}
```

### 3. Configurer Cursor / Copilot

Ajoutez la même configuration dans les paramètres MCP de votre IDE.

## Outils disponibles

| Outil | Description |
|-------|-------------|
| `rgaa_audit` | Audit complet RGAA 4.1 avec violations, patterns et suggestions. Options `authenticated` et `diagnostics` |
| `rgaa_score` | Score de conformité rapide (0-100%) |
| `rgaa_check` | Vérifier un critère RGAA spécifique (ex: 1.1, 3.2, 11.1) |
| `rgaa_explain` | Expliquer un critère RGAA avec exemples de code |
| `rgaa_report` | Rapport JSON structuré pour CI/CD (diagnostics inclus par défaut) |
| `rgaa_diagnostics` | Santé du site : liens cassés (404), pages en erreur, zones partagées, corrections |

### Paramètres `rgaa_audit`

| Paramètre | Type | Défaut | Description |
|-----------|------|--------|-------------|
| `url` | string | — | URL du site web à auditer |
| `authenticated` | boolean | `false` | Inclure les pages protégées par authentification |
| `diagnostics` | boolean | `false` | Inclure les diagnostics : liens cassés, pages en erreur, zones partagées, corrections |

### Diagnostics

Le champ `diagnostics` retourne des données de santé du site :

- **Liens cassés (404)** — URLs qui retournent une erreur 404, avec la raison et la profondeur de crawl
- **Pages en erreur** — Pages bloquées (Cloudflare, captcha, timeout, rate-limit) avec le détail de l'erreur
- **Zones partagées** — Détail des violations par zone (header, nav, footer) avec les critères RGAA concernés
- **Corrections** — Nombre de corrections appliquées/en attente et date de dernière correction

> Dans `rgaa_report` (CI/CD), les diagnostics sont inclus **par défaut**.
> Dans `rgaa_audit`, ajoutez `diagnostics: true` pour les activer.

## Exemples d'utilisation

Dans Claude Code, demandez simplement :

```
> Audite l'accessibilité de https://monsite.fr
> Audite https://monsite.fr avec les pages authentifiées
> Quel est le score RGAA de https://monsite.fr ?
> Vérifie le critère 3.2 (contrastes) sur https://monsite.fr
> Explique le critère RGAA 11.1
> Montre les liens cassés et erreurs de https://monsite.fr
> Diagnostique la santé de https://monsite.fr
```

## Variables d'environnement

| Variable | Requis | Description |
|----------|--------|-------------|
| `RGAA_API_KEY` | Oui | Clé API RGAAudit (format `rga_...`) |
| `RGAA_API_URL` | Non | URL de l'API (défaut: `https://rgaaudit.fr`) |

## Licence

MIT