@rgaaudit/mcp-server 0.2.0

package/README.md

@@ -0,0 +1,73 @@
+# @rgaaudit/mcp-server
+
+Serveur MCP (Model Context Protocol) pour auditer l'accessibilite web selon le referentiel francais **RGAA 4.1**, directement depuis votre IDE.
+
+Compatible **Claude Code**, **Cursor**, **Copilot**, **Windsurf**.
+
+## Installation rapide
+
+```bash
+npx @rgaaudit/mcp-server
+```
+
+## Configuration
+
+### 1. Obtenir une cle API
+
+1. Creez un compte sur [rgaaudit.fr](https://rgaaudit.fr)
+2. Allez dans **Parametres > API**
+3. Generez une cle API (plan Freelance ou superieur)
+
+### 2. Configurer Claude Code
+
+Ajoutez dans `.mcp.json` a 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 meme configuration dans les parametres MCP de votre IDE.
+
+## Outils disponibles
+
+| Outil | Description |
+|-------|-------------|
+| `rgaa_audit` | Audit complet RGAA 4.1 avec violations, patterns et suggestions |
+| `rgaa_score` | Score de conformite rapide (0-100%) |
+| `rgaa_check` | Verifier un critere RGAA specifique (ex: 1.1, 3.2, 11.1) |
+| `rgaa_explain` | Expliquer un critere RGAA avec exemples de code |
+| `rgaa_report` | Rapport JSON structure pour CI/CD |
+
+## Exemples d'utilisation
+
+Dans Claude Code, demandez simplement :
+
+```
+> Audite l'accessibilite de https://monsite.fr
+> Quel est le score RGAA de https://monsite.fr ?
+> Verifie le critere 3.2 (contrastes) sur https://monsite.fr
+> Explique le critere RGAA 11.1
+```
+
+## Variables d'environnement
+
+| Variable | Requis | Description |
+|----------|--------|-------------|
+| `RGAA_API_KEY` | Oui | Cle API RGAAudit (format `rga_...`) |
+| `RGAA_API_URL` | Non | URL de l'API (defaut: `https://app.rgaaudit.fr`) |
+
+## Licence
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * RGAAudit MCP Server — Audit d'accessibilité RGAA 4.1
+ *
+ * Se connecte à l'API RGAAudit pour auditer l'accessibilité web selon le
+ * référentiel français RGAA 4.1, directement depuis Claude Code, Cursor, Copilot.
+ *
+ * Configuration requise :
+ *   RGAA_API_KEY  — Clé API (générée dans Paramètres > API)
+ *   RGAA_API_URL  — URL de l'API (optionnel, défaut: https://app.rgaaudit.fr)
+ *
+ * Outils disponibles :
+ * - rgaa_audit    : Lancer un audit complet sur une URL
+ * - rgaa_score    : Score de conformité rapide
+ * - rgaa_check    : Vérifier un critère RGAA spécifique
+ * - rgaa_explain  : Expliquer un critère RGAA avec exemples
+ * - rgaa_report   : Rapport structuré JSON
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,196 @@
+#!/usr/bin/env node
+/**
+ * RGAAudit MCP Server — Audit d'accessibilité RGAA 4.1
+ *
+ * Se connecte à l'API RGAAudit pour auditer l'accessibilité web selon le
+ * référentiel français RGAA 4.1, directement depuis Claude Code, Cursor, Copilot.
+ *
+ * Configuration requise :
+ *   RGAA_API_KEY  — Clé API (générée dans Paramètres > API)
+ *   RGAA_API_URL  — URL de l'API (optionnel, défaut: https://app.rgaaudit.fr)
+ *
+ * Outils disponibles :
+ * - rgaa_audit    : Lancer un audit complet sur une URL
+ * - rgaa_score    : Score de conformité rapide
+ * - rgaa_check    : Vérifier un critère RGAA spécifique
+ * - rgaa_explain  : Expliquer un critère RGAA avec exemples
+ * - rgaa_report   : Rapport structuré JSON
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+const API_URL = process.env.RGAA_API_URL || 'https://app.rgaaudit.fr';
+const API_KEY = process.env.RGAA_API_KEY || '';
+const server = new McpServer({
+    name: 'rgaaudit',
+    version: '0.2.0',
+});
+/**
+ * Appelle POST /api/ci/scan
+ */
+async function callScan(url, options) {
+    if (!API_KEY) {
+        throw new Error('RGAA_API_KEY non configurée.\n\n' +
+            '1. Créez un compte sur https://app.rgaaudit.fr\n' +
+            '2. Allez dans Paramètres > API\n' +
+            '3. Générez une clé API\n' +
+            '4. Configurez : RGAA_API_KEY=rga_...');
+    }
+    const res = await fetch(`${API_URL}/api/ci/scan`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'X-API-Key': API_KEY,
+        },
+        body: JSON.stringify({
+            url,
+            details: options?.details ?? false,
+            threshold: options?.threshold ?? 0,
+        }),
+    });
+    if (!res.ok) {
+        const body = await res.json().catch(() => ({}));
+        throw new Error(`API erreur ${res.status}: ${body.message || res.statusText}`);
+    }
+    return res.json();
+}
+// ── Outil 1 : rgaa_audit ──
+server.tool('rgaa_audit', 'Lancer un audit d\'accessibilité RGAA 4.1 complet sur une URL. Retourne les violations avec critères RGAA, impact, et suggestions de correction.', {
+    url: z.string().url().describe('URL du site web à auditer'),
+}, async ({ url }) => {
+    try {
+        const result = await callScan(url, { details: true });
+        const violations = result.violationDetails || [];
+        const critique = violations.filter(v => v.impact === 'critical').length;
+        const serieux = violations.filter(v => v.impact === 'serious').length;
+        const modere = violations.filter(v => v.impact === 'moderate').length;
+        let text = `# Audit RGAA 4.1 — ${url}\n\n` +
+            `**Score** : ${result.score}% — ${result.conformity}\n` +
+            `**${result.violations} non-conformités** sur ${result.pages} pages\n` +
+            `- ${critique} critique(s), ${serieux} sérieuse(s), ${modere} modérée(s)\n\n`;
+        if (result.patterns && result.patterns.length > 0) {
+            text += `## Patterns de correction (${result.patterns.length})\n\n`;
+            for (const p of result.patterns) {
+                text += `- **${p.title}** (${p.type}) — ${p.violationsCount} violations, ${p.pagesAffected} pages\n`;
+            }
+            text += '\n';
+        }
+        if (violations.length > 0) {
+            text += `## Détail des violations\n\n`;
+            for (const [i, v] of violations.entries()) {
+                text += `### ${i + 1}. ${v.criteriaTitle || v.description}\n`;
+                text += `- **Critère RGAA** : ${v.criteria || 'N/A'}${v.theme ? ` (${v.theme})` : ''}\n`;
+                text += `- **Impact** : ${v.impact}\n`;
+                text += `- **Éléments** : ${v.nodesCount} nœuds sur ${v.pagesCount} pages\n`;
+                if (v.zone)
+                    text += `- **Zone** : ${v.zone}\n`;
+                if (v.suggestion)
+                    text += `- **Suggestion** : ${v.suggestion}\n`;
+                if (v.nodes.length > 0) {
+                    text += `- **Exemple** : \`${v.nodes[0].target}\`\n`;
+                }
+                text += '\n';
+            }
+        }
+        text += `\n🔗 Rapport complet : ${result.auditUrl}`;
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (error) {
+        return { content: [{ type: 'text', text: `Erreur : ${error instanceof Error ? error.message : String(error)}` }], isError: true };
+    }
+});
+// ── Outil 2 : rgaa_score ──
+server.tool('rgaa_score', 'Score de conformité RGAA rapide pour une URL. Retourne le score (0-100%), le nombre de violations, et le niveau de conformité.', {
+    url: z.string().url().describe('URL du site web'),
+}, async ({ url }) => {
+    try {
+        const result = await callScan(url);
+        const text = `**Score RGAA** : ${result.score}%\n` +
+            `**Conformité** : ${result.conformity}\n` +
+            `**Violations** : ${result.violations}\n` +
+            `**Pages analysées** : ${result.pages}\n` +
+            `**URL** : ${url}\n\n` +
+            `🔗 Détails : ${result.auditUrl}`;
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (error) {
+        return { content: [{ type: 'text', text: `Erreur : ${error instanceof Error ? error.message : String(error)}` }], isError: true };
+    }
+});
+// ── Outil 3 : rgaa_check ──
+server.tool('rgaa_check', 'Vérifier un critère RGAA spécifique sur une URL. Par exemple : critère 1.1 (images), 3.1 (couleurs), 8.1 (langue).', {
+    url: z.string().url().describe('URL du site web'),
+    criteria: z.string().describe('Code du critère RGAA (ex: 1.1, 3.1, 8.1, 11.1)'),
+}, async ({ url, criteria }) => {
+    try {
+        const result = await callScan(url, { details: true });
+        const matching = (result.violationDetails || []).filter(v => v.criteria && v.criteria.startsWith(criteria));
+        if (matching.length === 0) {
+            return { content: [{ type: 'text', text: `✅ Critère RGAA ${criteria} : **Aucune violation détectée** sur ${url}\n\nScore global : ${result.score}%` }] };
+        }
+        const text = `❌ Critère RGAA ${criteria} : **${matching.length} violation(s)** sur ${url}\n\n` +
+            matching.map(v => `- **${v.criteriaTitle || v.description}** (${v.impact})\n` +
+                `  ${v.nodesCount} nœuds sur ${v.pagesCount} pages\n` +
+                (v.suggestion ? `  💡 ${v.suggestion}\n` : '')).join('\n') +
+            `\n🔗 Détails : ${result.auditUrl}`;
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (error) {
+        return { content: [{ type: 'text', text: `Erreur : ${error instanceof Error ? error.message : String(error)}` }], isError: true };
+    }
+});
+// ── Outil 4 : rgaa_explain (local, pas d'API) ──
+const RGAA_CRITERES = {
+    '1.1': { numero: '1.1', thematique: 'Images', titre: 'Chaque image porteuse d\'information a-t-elle une alternative textuelle ?', niveau: 'A', description: 'Toute image qui apporte une information doit avoir un attribut alt décrivant cette information.', exemple: '```html\n<!-- Conforme -->\n<img src="logo.png" alt="Logo de l\'entreprise">\n\n<!-- Non conforme -->\n<img src="logo.png">\n```' },
+    '3.1': { numero: '3.1', thematique: 'Couleurs', titre: 'L\'information ne doit pas être donnée uniquement par la couleur.', niveau: 'A', description: 'Utiliser un second indicateur visuel (icône, texte, forme) en plus de la couleur.' },
+    '3.2': { numero: '3.2', thematique: 'Couleurs', titre: 'Le contraste entre le texte et le fond est-il suffisamment élevé ?', niveau: 'AA', description: 'Ratio minimum de 4.5:1 pour le texte normal, 3:1 pour le texte agrandi.', exemple: '```css\n/* Conforme — ratio 7.4:1 */\ncolor: #333; background: #fff;\n\n/* Non conforme — ratio 2.1:1 */\ncolor: #999; background: #fff;\n```' },
+    '6.1': { numero: '6.1', thematique: 'Liens', titre: 'Chaque lien est-il explicite ?', niveau: 'A', description: 'Le texte du lien doit permettre de comprendre sa destination.', exemple: '```html\n<!-- Conforme -->\n<a href="/tarifs">Voir nos tarifs</a>\n\n<!-- Non conforme -->\n<a href="/tarifs">Cliquez ici</a>\n```' },
+    '8.1': { numero: '8.1', thematique: 'Éléments obligatoires', titre: 'Chaque page est-elle définie par un type de document ?', niveau: 'A', description: 'La page doit commencer par <!DOCTYPE html>.' },
+    '8.3': { numero: '8.3', thematique: 'Éléments obligatoires', titre: 'La langue par défaut est-elle indiquée ?', niveau: 'A', description: 'L\'attribut lang doit être présent sur <html>.', exemple: '```html\n<html lang="fr">\n```' },
+    '8.5': { numero: '8.5', thematique: 'Éléments obligatoires', titre: 'Chaque page a-t-elle un titre ?', niveau: 'A', description: 'L\'élément <title> doit être présent et pertinent.' },
+    '9.1': { numero: '9.1', thematique: 'Structuration', titre: 'La hiérarchie de titres est-elle pertinente ?', niveau: 'A', description: 'Les titres h1-h6 doivent suivre une hiérarchie logique.' },
+    '9.2': { numero: '9.2', thematique: 'Structuration', titre: 'La structure utilise-t-elle des landmarks ?', niveau: 'A', description: 'Utiliser header, nav, main, footer.' },
+    '11.1': { numero: '11.1', thematique: 'Formulaires', titre: 'Chaque champ de formulaire a-t-il une étiquette ?', niveau: 'A', description: 'Chaque input doit être associé à un label.', exemple: '```html\n<!-- Conforme -->\n<label for="email">Email</label>\n<input id="email" type="email">\n\n<!-- Non conforme -->\n<input type="email" placeholder="Email">\n```' },
+    '11.2': { numero: '11.2', thematique: 'Formulaires', titre: 'Chaque étiquette est-elle pertinente ?', niveau: 'A', description: 'Le label doit décrire clairement la finalité du champ.' },
+    '12.7': { numero: '12.7', thematique: 'Navigation', titre: 'Un lien d\'accès rapide au contenu principal est-il présent ?', niveau: 'A', description: 'Un skip-link doit être le premier élément focusable.' },
+    '12.8': { numero: '12.8', thematique: 'Navigation', titre: 'L\'ordre de tabulation est-il cohérent ?', niveau: 'A', description: 'L\'ordre de focus doit suivre l\'ordre logique du contenu.' },
+    '13.1': { numero: '13.1', thematique: 'Consultation', titre: 'L\'utilisateur est-il averti de l\'ouverture d\'une nouvelle fenêtre ?', niveau: 'A', description: 'Indiquer visuellement ou textuellement quand un lien ouvre un nouvel onglet.' },
+};
+server.tool('rgaa_explain', 'Explique un critère RGAA 4.1 avec sa description, son niveau WCAG, et des exemples de code.', {
+    criteria: z.string().describe('Code du critère RGAA (ex: 1.1, 3.1, 8.1, 11.1)'),
+}, async ({ criteria }) => {
+    const info = RGAA_CRITERES[criteria];
+    if (!info) {
+        return { content: [{ type: 'text', text: `Critère RGAA ${criteria} non trouvé dans la base locale. Les critères vont de 1.1 à 13.12.\n\nCritères disponibles : ${Object.keys(RGAA_CRITERES).join(', ')}` }] };
+    }
+    const text = `# Critère RGAA ${info.numero}\n\n` +
+        `**Thématique** : ${info.thematique}\n` +
+        `**Titre** : ${info.titre}\n` +
+        `**Niveau** : ${info.niveau}\n\n` +
+        (info.description ? `## Description\n${info.description}\n\n` : '') +
+        (info.exemple ? `## Exemple\n${info.exemple}\n` : '');
+    return { content: [{ type: 'text', text }] };
+});
+// ── Outil 5 : rgaa_report ──
+server.tool('rgaa_report', 'Génère un rapport d\'audit RGAA structuré en JSON pour intégration CI/CD ou export.', {
+    url: z.string().url().describe('URL du site web'),
+    threshold: z.number().min(0).max(100).default(0).describe('Score minimum pour pass/fail (0 = pas de seuil)'),
+}, async ({ url, threshold }) => {
+    try {
+        const result = await callScan(url, { details: true, threshold });
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    }
+    catch (error) {
+        return { content: [{ type: 'text', text: `Erreur : ${error instanceof Error ? error.message : String(error)}` }], isError: true };
+    }
+});
+// ── Démarrage ──
+async function main() {
+    if (!API_KEY) {
+        console.error('⚠️  RGAA_API_KEY non configurée. Les outils d\'audit ne fonctionneront pas.');
+        console.error('   Générez une clé sur https://app.rgaaudit.fr > Paramètres > API');
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch(console.error);

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@rgaaudit/mcp-server",
+  "version": "0.2.0",
+  "description": "MCP Server RGAA 4.1 — Audit d'accessibilité pour Claude Code, Cursor, Copilot",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "rgaaudit-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.25.3"
+  },
+  "devDependencies": {
+    "tsx": "^4.19.4",
+    "typescript": "^5.8.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": ["mcp", "rgaa", "accessibility", "a11y", "wcag", "audit", "france", "rgaa4"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rgaaudit/mcp-server"
+  },
+  "homepage": "https://rgaaudit.fr/docs/mcp",
+  "publishConfig": {
+    "access": "public"
+  }
+}