MCP Shrimp Task Manager

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

MCP Shrimp Task Manager

🦐 Gerenciamento inteligente de tarefas para desenvolvimento com IA - Divida projetos complexos em tarefas gerenciáveis, mantenha o contexto entre sessões e acelere seu fluxo de trabalho de desenvolvimento.

🚀 Início Rápido

Pré-requisitos

• Node.js 18+
• npm ou yarn
• Cliente de IA compatível com MCP (Claude Code, etc.)

Instalação

Instalando o Claude Code

Windows 11 (com 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 o 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 o Claude Code

Crie um arquivo .mcp.json no diretório do seu projeto:

{
  "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"
      }
    }
  }
}

Exemplo de configuração:

{
  "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"
      }
    }
  }
}

Em seguida, inicie o Claude Code com sua configuração MCP personalizada:

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

Começar a Usar

1. Inicialize seu projeto: "init project rules"
2. Planeje uma tarefa: "plan task: implement user authentication"
3. Execute tarefas: "execute task" ou "continuous mode"

💡 O que é o Shrimp?

O Shrimp Task Manager é um servidor MCP (Model Context Protocol) que transforma a forma como agentes de IA abordam o desenvolvimento de software. Em vez de perder contexto ou repetir trabalho, o Shrimp oferece:

• 🧠 Memória Persistente: Tarefas e progresso persistem entre sessões
• 📋 Fluxos de Trabalho Estruturados: Processos guiados para planejamento, execução e verificação
• 🔄 Decomposição Inteligente: Divide automaticamente tarefas complexas em subtarefas gerenciáveis
• 🎯 Preservação de Contexto: Nunca perca seu lugar, mesmo com limites de tokens

✨ Recursos Principais

Gerenciamento de Tarefas

• Planejamento Inteligente: Análise profunda dos requisitos antes da implementação
• Decomposição de Tarefas: Divida grandes projetos em unidades atômicas e testáveis
• Rastreamento de Dependências: Gerenciamento automático de relacionamentos entre tarefas
• Monitoramento de Progresso: Acompanhamento e atualizações de status em tempo real

Capacidades Avançadas

• 🔬 Modo de Pesquisa: Exploração sistemática de tecnologias e soluções
• 🤖 Sistema de Agentes: Atribua agentes de IA especializados a tarefas específicas (Saiba mais)
• 📏 Regras do Projeto: Defina e mantenha padrões de codificação em todo o seu projeto
• 💾 Memória de Tarefas: Backup e restauração automáticos do histórico de tarefas

Interfaces Web

🖥️ Visualizador de Tarefas

Interface React moderna para gerenciamento visual de tarefas com arrastar e soltar, pesquisa em tempo real e suporte a múltiplos perfis.

Configuração rápida:

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

📖 Documentação completa do Visualizador de Tarefas

🌐 GUI Web

Interface web leve e opcional para uma visão geral rápida das tarefas.

Ative em .env: ENABLE_GUI=true

📚 Documentação

• 📖 Documentação completa
• 🛠️ Ferramentas disponíveis
• 🤖 Gerenciamento de agentes
• 🎨 Personalização de prompts
• 🔧 Referência da API

🎯 Casos de Uso Comuns

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

🛠️ Configuração

Variáveis de Ambiente

Crie um arquivo .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 Disponíveis

🤝 Contribuindo

Aceitamos contribuições! Consulte nosso Guia de Contribuição para detalhes.

📄 Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para detalhes.

🌟 Créditos

Criado por cjo4m06 e mantido pela comunidade.

GitHub • Issues • Discussions