MCP Shrimp Task Manager

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

MCP Shrimp Task Manager

🦐 Gestión inteligente de tareas para desarrollo impulsado por IA - Descompón proyectos complejos en tareas manejables, mantén el contexto entre sesiones y acelera tu flujo de trabajo de desarrollo.

🚀 Inicio rápido

Requisitos previos

• Node.js 18+
• npm o yarn
• Cliente de IA compatible con MCP (Claude Code, etc.)

Instalación

Instalando Claude Code

Windows 11 (con WSL2):

# First, ensure WSL2 is installed (in PowerShell as Administrator)
wsl --install

# Enter Ubuntu/WSL environment
wsl -d Ubuntu

# Install Claude Code globally
npm install -g @anthropic-ai/claude-code

# Start Claude Code
claude

macOS/Linux:

# Install Claude Code globally
npm install -g @anthropic-ai/claude-code

# Start Claude Code
claude

Instalando Shrimp Task Manager

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

# Install dependencies
npm install

# Build the project
npm run build

Configurar Claude Code

Crea un archivo .mcp.json en el directorio de tu proyecto:

{
  "mcpServers": {
    "shrimp-task-manager": {
      "command": "node",
      "args": ["/path/to/mcp-shrimp-task-manager/dist/index.js"],
      "env": {
        "DATA_DIR": "/path/to/your/shrimp_data",
        "TEMPLATES_USE": "en",
        "ENABLE_GUI": "false"
      }
    }
  }
}

Configuración de ejemplo:

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

Luego inicia Claude Code con tu configuración personalizada de MCP:

claude --dangerously-skip-permissions --mcp-config .mcp.json

Empezar a usar

1. Inicializa tu proyecto: "init project rules"
2. Planifica una tarea: "plan task: implement user authentication"
3. Ejecuta tareas: "execute task" o "continuous mode"

💡 ¿Qué es Shrimp?

Shrimp Task Manager es un servidor MCP (Model Context Protocol) que transforma la forma en que los agentes de IA abordan el desarrollo de software. En lugar de perder contexto o repetir trabajo, Shrimp ofrece:

• 🧠 Memoria persistente: Las tareas y el progreso persisten entre sesiones
• 📋 Flujos de trabajo estructurados: Procesos guiados para planificación, ejecución y verificación
• 🔄 Descomposición inteligente: Descompone automáticamente tareas complejas en subtareas manejables
• 🎯 Preservación del contexto: Nunca pierdas tu lugar, incluso con límites de tokens

✨ Funciones principales

Gestión de tareas

• Planificación inteligente: Análisis profundo de requisitos antes de la implementación
• Descomposición de tareas: Divide proyectos grandes en unidades atómicas y comprobables
• Seguimiento de dependencias: Gestión automática de relaciones entre tareas
• Monitoreo de progreso: Seguimiento y actualizaciones de estado en tiempo real

Capacidades avanzadas

• 🔬 Modo de investigación: Exploración sistemática de tecnologías y soluciones
• 🤖 Sistema de agentes: Asigna agentes de IA especializados a tareas específicas (Más información)
• 📏 Reglas del proyecto: Define y mantén estándares de codificación en todo tu proyecto
• 💾 Memoria de tareas: Copia de seguridad y restauración automática del historial de tareas

Interfaces web

🖥️ Visor de tareas

Interfaz React moderna para gestión visual de tareas con arrastrar y soltar, búsqueda en tiempo real y soporte multiperfil.

Configuración rápida:

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

📖 Documentación completa del visor de tareas

🌐 Interfaz web

Interfaz web ligera opcional para una vista rápida de tareas.

Habilítala en .env: ENABLE_GUI=true

📚 Documentación

• 📖 Documentación completa
• 🛠️ Herramientas disponibles
• 🤖 Gestión de agentes
• 🎨 Personalización de prompts
• 🔧 Referencia de API

🎯 Casos de uso comunes

Agent: "plan task: add user authentication with JWT"
# Agent analyzes codebase, creates subtasks

Agent: "execute task"
# Implements authentication step by step

Agent: "plan task: fix memory leak in data processing"
# Agent researches issue, creates fix plan

Agent: "continuous mode"
# Executes all fix tasks automatically

Agent: "research: compare React vs Vue for this project"
# Systematic analysis with pros/cons

Agent: "plan task: migrate component to chosen framework"
# Creates migration plan based on research

🛠️ Configuración

Variables de entorno

Crea un archivo .env:

# Required
DATA_DIR=/path/to/data/storage

# Optional
ENABLE_GUI=true          # Enable web GUI
WEB_PORT=3000           # Custom web port
PROMPT_LANGUAGE=en      # Prompt language (en, zh, etc.)

Comandos disponibles

🤝 Contribuciones

¡Agradecemos las contribuciones! Consulta nuestra Guía de contribución para más detalles.

📄 Licencia

Este proyecto está bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.

🌟 Créditos

Creado por cjo4m06 y mantenido por la comunidad.

GitHub • Issues • Discussions