Spec Workflow MCP — Installer & Démo en direct

Name: Spec Workflow MCP Server
Author: Pimzino

Pourquoi l'utiliser

Fonctionnalités clés

Séquence Exigences → Design → Tâches avec validation entre chaque étape
Tableau de bord web sur localhost:5000 avec mises à jour en temps réel
Extension VSCode avec panneau latéral intégré à l'IDE
Interface en 11 langues
Journaux d'implémentation consultables avec statistiques de code

Démo en direct

Aperçu en pratique

spec-workflow-mcp.replay ▶ prêt

0/0

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "spec-workflow-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pimzino/spec-workflow-mcp@latest",
        "/path/to/project"
      ]
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "spec-workflow-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pimzino/spec-workflow-mcp@latest",
        "/path/to/project"
      ]
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "spec-workflow-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pimzino/spec-workflow-mcp@latest",
        "/path/to/project"
      ]
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "spec-workflow-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pimzino/spec-workflow-mcp@latest",
        "/path/to/project"
      ]
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "spec-workflow-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@pimzino/spec-workflow-mcp@latest",
        "/path/to/project"
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

{
  "context_servers": {
    "spec-workflow-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@pimzino/spec-workflow-mcp@latest",
          "/path/to/project"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add spec-workflow-mcp -- npx -y @pimzino/spec-workflow-mcp@latest /path/to/project

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : Spec Workflow

Développer une fonctionnalité avec une spec, pas une vague instruction

👤 Devs livrant des fonctionnalités de complexité moyenne ⏱ ~90 min intermediate

Quand l'utiliser : Vous êtes sur le point de demander à Claude « d'ajouter OAuth » et redoutez le diff de 500 lignes qui va arriver d'un coup.

Prérequis

Chemin du projet connu — Le MCP est lancé avec /path/to/project comme argument

Déroulement

Exigences

Utilise spec-workflow. Crée une spec nommée oauth-login. Commence par les exigences — qu'est-ce qu'on ajoute, pour qui, quels sont les non-objectifs ?✓ Copié

→ Document d'exigences rédigé, lien vers le tableau de bord pour validation
Valider + Design

J'ai validé dans le tableau de bord. Rédige maintenant le design : composants, modèle de données, diagramme de séquence, cas d'erreur.✓ Copié

→ Document de design avec architecture concrète
Tâches + Exécution

J'ai validé. Décompose en tâches. Puis exécute la tâche 1.1 — uniquement celle-là, arrête après.✓ Copié

→ Liste de tâches créée ; seule la tâche 1.1 est implémentée avec entrée dans le journal

Résultat : Une fonctionnalité livrée avec des artefacts intermédiaires vérifiables — pas un diff mystérieux.

Pièges

Claude essaie de passer directement au code — Le MCP le bloque — mais soyez explicite dans vos prompts quand même : « n'implémentez pas encore »

Combiner avec : github · filesystem

Faire valider une spec par un stakeholder non-technique avant de coder

👤 Équipes avec boucles de validation PM/design ⏱ ~60 min intermediate

Quand l'utiliser : Vous avez besoin de l'approbation du PM avant l'implémentation et le PM ne lit pas les PR GitHub.

Prérequis

URL du tableau de bord partageable — Faites un port-forward ou exposez localhost:5000 via ngrok pour les PM en remote

Déroulement

Spec

Rédige le document d'exigences pour checkout-v2 et partage l'URL du tableau de bord.✓ Copié

→ Document + lien partageable
Itérer sur les retours

Le PM a laissé 3 commentaires de révision dans le tableau de bord. Récupère-les et révise le document.✓ Copié

→ Document mis à jour avec historique des révisions visible
Exécuter après validation

La validation vient d'être accordée — passe au design.✓ Copié

→ L'étape suivante démarre ; horodatage de validation enregistré

Résultat : Chaîne de validation traçable depuis des stakeholders non-techniques.

Pièges

Tableau de bord inaccessible pour les utilisateurs distants — Utilisez Tailscale ou ngrok avec authentification

Combiner avec : github

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

spec-workflow-mcp + github

Ouvrir une PR par tâche validée

Après avoir exécuté la tâche 2.1, ouvre une PR GitHub intitulée « feat(oauth): task 2.1 » avec le diff.✓ Copié

spec-workflow-mcp + filesystem

Stocker les specs dans le dépôt aux côtés du code

Sauvegarde la spec validée dans /docs/specs/oauth-login.md et commit.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
create_spec	name: str	Démarrer une nouvelle fonctionnalité	free
write_requirements	spec_id, content: markdown	Première phase de toute spec	free
write_design	spec_id, content: markdown	Après validation des exigences	free
create_tasks	spec_id, tasks: []	Après validation du design	free
execute_task	spec_id, task_id	Implémenter une tâche à la fois	free
get_approval_status	spec_id, stage	Conditionner le passage à l'étape suivante	free

Coût et limites

Coût d'exécution

Quota d'API: Local
Tokens par appel: Proportionnel à la taille du document/des tâches
Monétaire: Gratuit
Astuce: Gardez les exigences concises — le coût des validations est du temps humain, pas des tokens

Sécurité

Permissions, secrets, portée

Portées minimales : filesystem-write (for spec docs)

Stockage des identifiants : Aucun

Sortie de données : Aucune — tableau de bord local

N'exposez pas localhost:5000 à internet sans authentification

Dépannage

Erreurs courantes et correctifs

Le tableau de bord ne se charge pas

Lancez-le explicitement : npx -y @pimzino/spec-workflow-mcp@latest --dashboard

Vérifier : Visit localhost:5000

Port 5000 déjà utilisé (AirPlay macOS)

Passez --port 5050 ou désactivez AirPlay Receiver dans les Réglages Système

Vérifier : Check with `lsof -i :5000`

Les tâches restent en attente après validation

Le client MCP met peut-être en cache d'anciens résultats — redémarrez le client

Alternatives

Spec Workflow vs autres

Alternative	Quand l'utiliser	Compromis
Plain Markdown in /docs	Développeur solo sans boucle de validation requise	Aucune structure imposée, pas de tableau de bord
Linear MCP	Vous utilisez déjà Linear pour les tâches et voulez que Claude touche directement aux issues	Pas de couche document de spec

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills