À propos du projet

Spec Workflow MCP est un serveur Model Context Protocol (MCP) qui ajoute un flux de travail de développement structuré et piloté par les spécifications au codage assisté par IA. Au lieu de laisser un assistant passer directement au code, il guide le travail à travers des documents de spécification séquentiels : exigences, puis conception, puis tâches. Il est distribué sous forme de package npm (@pimzino/spec-workflow-mcp) et est configuré comme serveur MCP dans des outils tels que Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Continue, Augment Code, OpenCode et Codex. Capacités principales décrites dans le README : - Flux de travail structuré : les spécifications sont créées dans l'ordre (Exigences → Conception → Tâches), et les tâches individuelles peuvent être exécutées par nom ou numéro via des invites de conversation. - Tableau de bord web en temps réel : un processus de tableau de bord (port par défaut 5000) affiche les spécifications, les tâches, les barres de progression et les statuts, avec des mises à jour en direct. Une instance de tableau de bord peut servir plusieurs projets. - Extension VSCode : un tableau de bord latéral intégré pour les utilisateurs de VSCode, publié sur le Visual Studio Marketplace. - Flux d'approbation : les documents peuvent être soumis pour approbation via le tableau de bord, avec suivi des retours et des révisions. - Suivi de progression des tâches : indicateurs de progression visuels et statut détaillé des tâches. - Journaux d'implémentation : journaux consultables des implémentations de tâches, y compris les statistiques de code. - Support multilingue : le projet fournit une documentation en 11 langues (anglais, japonais, chinois, espagnol, portugais, allemand, français, russe, italien, coréen et arabe). L'utilisation est pilotée par des invites : les utilisateurs mentionnent spec-workflow dans la conversation pour créer une spécification, lister les spécifications ou exécuter une tâche spécifique. L'état du projet réside dans un répertoire .spec-workflow contenant les approbations, les archives, les spécifications, la direction, les modèles et les modèles utilisateur. Déploiement et opérations : le tableau de bord peut être exécuté dans Docker via le Dockerfile et la configuration docker-compose fournis, avec un montage de volume pour l'espace de travail .spec-workflow. Les notes de sécurité dans le README indiquent que le serveur se lie à 127.0.0.1 par défaut, applique une limitation de débit (120 requêtes/minute par client), écrit des journaux d'audit JSON structurés, définit des en-têtes de sécurité, restreint CORS à localhost et durcit l'image Docker avec un utilisateur non root, un système de fichiers en lecture seule, des capacités supprimées et des limites de ressources. HTTPS/TLS et l'authentification utilisateur sont explicitement listés comme non encore implémentés, avec des proxys inverses (nginx/Apache) recommandés pour l'accès externe. Pour les environnements sandbox où $HOME est en lecture seule, la variable d'environnement SPEC_WORKFLOW_HOME redirige l'état global vers un emplacement accessible en écriture. Le développement se fait avec npm (scripts install, build, dev), et le projet est sous licence GPL-3.0. Le README note également que le mainteneur a pris une pause temporaire du dépôt.