Skip to content

README.md

Latest commit

 

History

History
261 lines (189 loc) · 8.36 KB

README.md

File metadata and controls

261 lines (189 loc) · 8.36 KB

🇺🇸 English | 🇩🇪 Deutsch | 🇪🇸 Español | 🇫🇷 Français | 🇮🇹 Italiano | 🇮🇳 हिन्दी | 🇰🇷 한국어 | 🇧🇷 Português | 🇷🇺 Русский | 🇨🇳 中文

MCP Shrimp Task Manager

🦐 Gestion intelligente des tâches pour le développement assisté par IA - Décomposez les projets complexes en tâches gérables, maintenez le contexte entre les sessions et accélérez votre flux de travail de développement.

🚀 Démarrage rapide

Prérequis

  • Node.js 18+
  • npm ou yarn
  • Client IA compatible MCP (Claude Code, etc.)

Installation

Installer Claude Code

Windows 11 (avec WSL2) :

# D'abord, assurez-vous que WSL2 est installé (dans PowerShell en tant qu'administrateur)
wsl --install

# Entrer dans l'environnement Ubuntu/WSL
wsl -d Ubuntu

# Installer Claude Code globalement
npm install -g @anthropic-ai/claude-code

# Démarrer Claude Code
claude

macOS/Linux :

# Installer Claude Code globalement
npm install -g @anthropic-ai/claude-code

# Démarrer Claude Code
claude

Installer Shrimp Task Manager

# Cloner le dépôt
git clone https://github.com/cjo4m06/mcp-shrimp-task-manager.git
cd mcp-shrimp-task-manager

# Installer les dépendances
npm install

# Construire le projet
npm run build

Configurer Claude Code

Créez un fichier .mcp.json dans votre répertoire de projet :

{
  "mcpServers": {
    "shrimp-task-manager": {
      "command": "node",
      "args": ["/chemin/vers/mcp-shrimp-task-manager/dist/index.js"],
      "env": {
        "DATA_DIR": "/chemin/vers/vos/donnees_shrimp",
        "TEMPLATES_USE": "fr",
        "ENABLE_GUI": "false"
      }
    }
  }
}

Exemple de configuration :

{
  "mcpServers": {
    "shrimp-task-manager": {
      "command": "node",
      "args": ["/home/fire/claude/mcp-shrimp-task-manager/dist/index.js"],
      "env": {
        "DATA_DIR": "/home/fire/claude/projet/donnees_shrimp",
        "TEMPLATES_USE": "fr",
        "ENABLE_GUI": "false"
      }
    }
  }
}

Ensuite, démarrez Claude Code avec votre configuration MCP personnalisée :

claude --dangerously-skip-permissions --mcp-config .mcp.json
Autres clients IA

Cline (Extension VS Code) : Une extension VS Code pour le codage assisté par IA. Ajouter à VS Code settings.json sous cline.mcpServers

Claude Desktop : Ajouter à ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows)

Commencer à utiliser

  1. Initialiser votre projet : "init project rules"
  2. Planifier une tâche : "plan task: implémenter l'authentification utilisateur"
  3. Exécuter les tâches : "execute task" ou "continuous mode"

💡 Qu'est-ce que Shrimp ?

Shrimp Task Manager est un serveur MCP (Model Context Protocol) qui transforme la façon dont les agents IA abordent le développement logiciel. Au lieu de perdre le contexte ou de répéter le travail, Shrimp fournit :

  • 🧠 Mémoire persistante : Les tâches et le progrès persistent entre les sessions
  • 📋 Flux de travail structurés : Processus guidés pour la planification, l'exécution et la vérification
  • 🔄 Décomposition intelligente : Décompose automatiquement les tâches complexes en sous-tâches gérables
  • 🎯 Préservation du contexte : Ne perdez jamais votre place, même avec les limites de tokens

✨ Fonctionnalités principales

Gestion des tâches

  • Planification intelligente : Analyse approfondie des exigences avant l'implémentation
  • Décomposition des tâches : Divise les grands projets en unités atomiques et testables
  • Suivi des dépendances : Gestion automatique des relations entre tâches
  • Surveillance du progrès : Suivi et mises à jour du statut en temps réel

Capacités avancées

  • 🔬 Mode recherche : Exploration systématique des technologies et solutions
  • 🤖 Système d'agents : Assigner des agents IA spécialisés à des tâches spécifiques (En savoir plus)
  • 📏 Règles de projet : Définir et maintenir les standards de codage dans votre projet
  • 💾 Mémoire des tâches : Sauvegarde et restauration automatiques de l'historique des tâches

Interfaces web

🖥️ Visualiseur de tâches

Interface React moderne pour la gestion visuelle des tâches avec glisser-déposer, recherche en temps réel et support multi-profils.

Configuration rapide :

cd tools/task-viewer
npm install
npm run start:all
# Accès sur http://localhost:5173

📖 Documentation complète du visualiseur de tâches

Interface du visualiseur de tâches

🌐 Interface Web

Interface web légère optionnelle pour un aperçu rapide des tâches.

Activer dans .env : ENABLE_GUI=true

📚 Documentation

🎯 Cas d'usage courants

Développement de fonctionnalités 
Agent: "plan task: ajouter l'authentification utilisateur avec JWT"
# L'agent analyse la base de code, crée des sous-tâches

Agent: "execute task"
# Implémente l'authentification étape par étape
Correction de bugs 
Agent: "plan task: corriger la fuite mémoire dans le traitement des données"
# L'agent recherche le problème, crée un plan de correction

Agent: "continuous mode"
# Exécute toutes les tâches de correction automatiquement
Recherche et apprentissage 
Agent: "research: comparer React vs Vue pour ce projet"
# Analyse systématique avec avantages/inconvénients

Agent: "plan task: migrer le composant vers le framework choisi"
# Crée un plan de migration basé sur la recherche

🛠️ Configuration

Variables d'environnement

Créez un fichier .env :

# Requis
DATA_DIR=/chemin/vers/stockage/donnees

# Optionnel
ENABLE_GUI=true          # Activer l'interface web
WEB_PORT=3000           # Port web personnalisé
PROMPT_LANGUAGE=fr      # Langue des prompts (fr, en, zh, etc.)

Commandes disponibles

Commande Description
init project rules Initialiser les standards du projet
plan task [description] Créer un plan de tâche
execute task [id] Exécuter une tâche spécifique
continuous mode Exécuter toutes les tâches séquentiellement
list tasks Afficher toutes les tâches
research [sujet] Entrer en mode recherche
reflect task [id] Examiner et améliorer une tâche

🤝 Contribuer

Nous accueillons les contributions ! Veuillez consulter notre Guide de contribution pour plus de détails.

📄 Licence

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

🌟 Crédits

Créé par cjo4m06 et maintenu par la communauté.

GitHub • Issues • Discussions