Skip to content

README.md

Latest commit

 

History

History
261 lines (189 loc) · 8.13 KB

README.md

File metadata and controls

261 lines (189 loc) · 8.13 KB

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

MCP Shrimp Task Manager

🦐 Gestione intelligente delle attività per lo sviluppo assistito da IA - Scomponi progetti complessi in attività gestibili, mantieni il contesto tra le sessioni e accelera il tuo flusso di lavoro di sviluppo.

🚀 Avvio rapido

Prerequisiti

  • Node.js 18+
  • npm o yarn
  • Client IA compatibile MCP (Claude Code, ecc.)

Installazione

Installare Claude Code

Windows 11 (con WSL2):

# Prima, assicurati che WSL2 sia installato (in PowerShell come amministratore)
wsl --install

# Entra nell'ambiente Ubuntu/WSL
wsl -d Ubuntu

# Installa Claude Code globalmente
npm install -g @anthropic-ai/claude-code

# Avvia Claude Code
claude

macOS/Linux:

# Installa Claude Code globalmente
npm install -g @anthropic-ai/claude-code

# Avvia Claude Code
claude

Installare Shrimp Task Manager

# Clona il repository
git clone https://github.com/cjo4m06/mcp-shrimp-task-manager.git
cd mcp-shrimp-task-manager

# Installa le dipendenze
npm install

# Costruisci il progetto
npm run build

Configurare Claude Code

Crea un file .mcp.json nella tua directory del progetto:

{
  "mcpServers": {
    "shrimp-task-manager": {
      "command": "node",
      "args": ["/percorso/a/mcp-shrimp-task-manager/dist/index.js"],
      "env": {
        "DATA_DIR": "/percorso/ai/tuoi/dati_shrimp",
        "TEMPLATES_USE": "it",
        "ENABLE_GUI": "false"
      }
    }
  }
}

Esempio di configurazione:

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

Poi avvia Claude Code con la tua configurazione MCP personalizzata:

claude --dangerously-skip-permissions --mcp-config .mcp.json
Altri client IA

Cline (Estensione VS Code): Un'estensione VS Code per la codifica assistita da IA. Aggiungi a VS Code settings.json sotto cline.mcpServers

Claude Desktop: Aggiungi a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows)

Iniziare a usare

  1. Inizializza il tuo progetto: "init project rules"
  2. Pianifica un'attività: "plan task: implementare autenticazione utente"
  3. Esegui attività: "execute task" o "continuous mode"

💡 Cos'è Shrimp?

Shrimp Task Manager è un server MCP (Model Context Protocol) che trasforma il modo in cui gli agenti IA affrontano lo sviluppo software. Invece di perdere contesto o ripetere lavoro, Shrimp fornisce:

  • 🧠 Memoria persistente: Le attività e il progresso persistono tra le sessioni
  • 📋 Flussi di lavoro strutturati: Processi guidati per pianificazione, esecuzione e verifica
  • 🔄 Scomposizione intelligente: Scompone automaticamente attività complesse in sottoattività gestibili
  • 🎯 Preservazione del contesto: Non perdere mai la tua posizione, anche con limiti di token

✨ Caratteristiche principali

Gestione delle attività

  • Pianificazione intelligente: Analisi approfondita dei requisiti prima dell'implementazione
  • Scomposizione delle attività: Divide grandi progetti in unità atomiche e testabili
  • Tracciamento delle dipendenze: Gestione automatica delle relazioni tra attività
  • Monitoraggio del progresso: Tracciamento e aggiornamenti dello stato in tempo reale

Capacità avanzate

  • 🔬 Modalità ricerca: Esplorazione sistematica di tecnologie e soluzioni
  • 🤖 Sistema di agenti: Assegna agenti IA specializzati ad attività specifiche (Scopri di più)
  • 📏 Regole del progetto: Definisci e mantieni standard di codifica nel tuo progetto
  • 💾 Memoria delle attività: Backup e ripristino automatici della cronologia delle attività

Interfacce web

🖥️ Visualizzatore attività

Interfaccia React moderna per la gestione visuale delle attività con drag-and-drop, ricerca in tempo reale e supporto multi-profilo.

Configurazione rapida:

cd tools/task-viewer
npm install
npm run start:all
# Accesso su http://localhost:5173

📖 Documentazione completa del visualizzatore attività

Interfaccia visualizzatore attività

🌐 GUI web

Interfaccia web leggera opzionale per panoramica rapida delle attività.

Abilita in .env: ENABLE_GUI=true

📚 Documentazione

🎯 Casi d'uso comuni

Sviluppo funzionalità 
Agente: "plan task: aggiungere autenticazione utente con JWT"
# L'agente analizza il codebase, crea sottoattività

Agente: "execute task"
# Implementa l'autenticazione passo dopo passo
Correzione bug 
Agente: "plan task: correggere memory leak nell'elaborazione dati"
# L'agente ricerca il problema, crea piano di correzione

Agente: "continuous mode"
# Esegue tutte le attività di correzione automaticamente
Ricerca e apprendimento 
Agente: "research: confrontare React vs Vue per questo progetto"
# Analisi sistematica con pro/contro

Agente: "plan task: migrare componente al framework scelto"
# Crea piano di migrazione basato sulla ricerca

🛠️ Configurazione

Variabili di ambiente

Crea un file .env:

# Richiesto
DATA_DIR=/percorso/all/archiviazione/dati

# Opzionale
ENABLE_GUI=true          # Abilita GUI web
WEB_PORT=3000           # Porta web personalizzata
PROMPT_LANGUAGE=it      # Lingua dei prompt (it, en, zh, ecc.)

Comandi disponibili

Comando Descrizione
init project rules Inizializzare standard del progetto
plan task [descrizione] Creare un piano di attività
execute task [id] Eseguire attività specifica
continuous mode Eseguire tutte le attività sequenzialmente
list tasks Mostrare tutte le attività
research [argomento] Entrare in modalità ricerca
reflect task [id] Rivedere e migliorare attività

🤝 Contribuire

Accogliamo i contributi! Si prega di consultare la nostra Guida ai contributi per i dettagli.

📄 Licenza

Questo progetto è concesso in licenza sotto la Licenza MIT - vedere il file LICENSE per i dettagli.

🌟 Crediti

Creato da cjo4m06 e mantenuto dalla community.

GitHub • Issues • Discussioni