Serveur Model Context Protocol intégrant le Design System de l'État français (DSFR) dans Claude Desktop. Génération, validation et audit de composants DSFR conformes RGAA 4.1.

Optimisé pour la production : 7 dépendances essentielles, performances >1.5M ops/sec, logging simplifié.

• Installation
• Démarrage rapide
• Fonctionnalités
• Documentation
• Architecture
• Tests
• Contribution
• Support
• Licence

• Python 3.9 ou supérieur
• Claude Desktop installé
• macOS, Linux ou Windows
• 100MB d'espace disque (7 dépendances production)

git clone https://github.com/yourusername/mcp-playbook-dsfr.git
cd mcp-playbook-dsfr
./install.sh

Le script d'installation :

1. Vérifie la version Python
2. Crée l'environnement virtuel
3. Installe les dépendances de production (7 packages essentiels)
4. Teste le serveur
5. Génère la configuration Claude Desktop

# Lancer tous les tests automatiquement
./run_tests.sh

Le script run_tests.sh active l'environnement virtuel et exécute les 13 tests de validation (incluant test_non_regression.py).

# Cloner le repository
git clone https://github.com/yourusername/mcp-playbook-dsfr.git
cd mcp-playbook-dsfr

# Créer l'environnement virtuel
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Installer les dépendances de production
pip install -r requirements.txt

# OU pour le développement (inclut tests et outils)
pip install -r requirements-dev.txt

# Tester l'installation
python3 -c "from mcp_local.server import app; print('Installation réussie')"

1. Localiser le fichier de configuration :

   • macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows : %APPDATA%\Claude\claude_desktop_config.json
   • Linux : ~/.config/Claude/claude_desktop_config.json

2. Ajouter la configuration MCP (remplacer /chemin/absolu/vers/ par votre chemin réel) :

{
  "mcpServers": {
    "mcp-playbook-dsfr": {
      "command": "/chemin/absolu/vers/venv/bin/python3",
      "args": ["/chemin/absolu/vers/mcp_local/server.py"],
      "env": {
        "PYTHONPATH": "/chemin/absolu/vers/mcp-playbook-dsfr",
        "ENV": "production",
        "LOG_LEVEL": "INFO",
        "DEFAULT_RGAA_LEVEL": "AA",
        "ENABLE_HTML_SANITIZATION": "true"
      }
    }
  }
}

3. Redémarrer Claude Desktop
4. Vérifier la présence de l'icône de connexion MCP

Une fois installé, utilisez ces commandes dans Claude Desktop :

# Générer un composant
"Génère un bouton DSFR primaire"

# Valider du HTML
"Valide ce code : <button class='fr-btn'>Cliquer</button>"

# Audit d'accessibilité
"Fais un audit RGAA de mon formulaire"

# Lister les composants
"Liste tous les composants DSFR disponibles"

48 composants DSFR répartis en catégories :

• Navigation : header, footer, breadcrumb, navigation, sidemenu, pagination
• Formulaires : form, input, select, checkbox, radio, toggle, upload, password
• Actions : button, button-group, link, download, share
• Contenu : accordion, alert, badge, card, table, quote, callout, summary
• Feedback : modal, notice, tag, stepper, highlight
• Layout : grid, container, tile, tabs
• Autres : logo, consent, connect, translate, follow, tooltip, transcription

• Guide Utilisateur - Comment utiliser les outils MCP dans Claude
• CLAUDE.md - Guide technique pour Claude Code
• Guide de déploiement - Déploiement production
• Roadmap - Évolutions futures

docs/
├── deployment/         # Guides de déploiement
├── tests/             # Documentation des tests
└── roadmap/           # Évolutions planifiées

mcp-playbook-dsfr/
├── mcp_local/         # Serveur MCP FastMCP
│   ├── server.py      # Point d'entrée principal
│   └── __init__.py    # Module Python
├── src/
│   ├── services/      # Services métier (SOLID)
│   ├── data/         # Registre des composants
│   ├── errors/       # Gestion des erreurs
│   └── utils/        # Utilitaires
├── gabarits/         # Templates HTML (48 composants)
├── tests/            # Suite de tests (100% de réussite)
├── docs/             # Documentation
│   ├── deployment/   # Guide de déploiement
│   └── roadmap/      # Feuille de route
├── tools/             # Outils de maintenance
│   └── check_dsfr_version.py  # Vérification des mises à jour DSFR
├── requirements.txt  # Dépendances production (7 packages)
├── requirements-dev.txt  # Dépendances développement
├── install.sh        # Script d'installation
└── run_tests.sh      # Script d'exécution des tests

• SOLID : Chaque service a une responsabilité unique
• DRY : Pas de duplication de code
• KISS : Solutions simples et directes
• YAGNI : Uniquement les fonctionnalités nécessaires

• GeneratorService : Génération de composants via Factory Pattern
• ValidatorService : Validation HTML avec détection de balises croisées
• AuditService : Audit RGAA multi-niveaux
• CognitiveService : Analyse Known-Unknown de Rumsfeld
• DesignService : Gestion des tokens de design
• TestGeneratorService : Génération de tests automatiques
• AssistantService : Aide contextuelle intelligente

100% des tests passent (13/13 tests fonctionnels)

# Script recommandé (active l'environnement virtuel automatiquement)
./run_tests.sh

# OU manuellement avec l'environnement virtuel
source venv/bin/activate
python3 tests/test-mcp-dsfr-all-components.py
# ... autres tests
deactivate

• 13 tests réussis sur 13 (100%)
• 48 composants DSFR testés
• Tous les services fonctionnels
• Génération automatique de tests (Cypress, Playwright, Jest)

# Test rapide après modifications
python3 tests/test_non_regression.py

Vérifie : imports, services, sécurité, performance (>1.5M ops/sec)

# Tester le serveur
python3 -c "
from mcp_local.server import app
from src.services import get_generator
html = get_generator().generate('button', label='Test')
print('OK' if 'fr-btn' in html else 'Erreur')
"

# Environnement de développement
cp .env.example .env
# Éditer .env selon vos besoins

1. Créer une branche : git checkout -b feature/nouvelle-fonctionnalite
2. Développer avec tests : pytest tests/ --watch
3. Vérifier le code : black . && ruff check . && mypy .
4. Commiter : git commit -m "feat: description"
5. Push : git push origin feature/nouvelle-fonctionnalite
6. Créer une Pull Request

Format : <type>(<scope>): <description>

Types :

• feat : Nouvelle fonctionnalité
• fix : Correction de bug
• docs : Documentation
• style : Formatage
• refactor : Refactoring
• test : Ajout de tests
• chore : Maintenance

# Construction
docker-compose build

# Lancement
docker-compose up -d

# Logs
docker-compose logs -f

# Arrêt
docker-compose down

Voir le guide de déploiement complet pour :

• Configuration systemd
• Reverse proxy nginx
• Monitoring Prometheus
• Backup et restauration

Les contributions sont les bienvenues ! Voir CONTRIBUTING.md pour :

1. Standards de code
2. Process de review
3. Guidelines de test
4. Documentation requise

1. Fork le projet
2. Créer votre branche (git checkout -b feature/AmazingFeature)
3. Commiter vos changements (git commit -m 'feat: Add AmazingFeature')
4. Push sur la branche (git push origin feature/AmazingFeature)
5. Ouvrir une Pull Request

• Issues GitHub - Rapporter des bugs
• Discussions - Questions et idées
• Wiki - Documentation étendue

• Auteur principal - Alexandra Guiderdoni
• Co-auteur - Claude (Assistant IA d'Anthropic)

Voir la liste des contributeurs.

Ce projet est sous licence MIT - voir le fichier LICENSE pour plus de détails.

• Équipe DSFR pour le Design System
• Anthropic pour le Model Context Protocol
• Communauté open source française
• Contributeurs et testeurs

• Documentation DSFR officielle
• Référentiel RGAA 4.1
• Claude Desktop
• Model Context Protocol

Développé pour l'accessibilité et la conformité DSFR des services publics numériques français.