mcp-shrimp-task-manager

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

🦐 Intelligent task management for AI-powered development - Break down complex projects into manageable tasks, maintain context across sessions, and accelerate your development workflow.

• Node.js 18+
• npm or yarn
• MCP-compatible AI client (Claude Code, etc.)

Windows 11 (with 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

# 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

Create a .mcp.json file in your project directory:

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

Example configuration:

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

Then start Claude Code with your custom MCP configuration:

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

1. Initialize your project: "init project rules"
2. Plan a task: "plan task: implement user authentication"
3. Execute tasks: "execute task" or "continuous mode"

Shrimp Task Manager is an MCP (Model Context Protocol) server that transforms how AI agents approach software development. Instead of losing context or repeating work, Shrimp provides:

• 🧠 Persistent Memory: Tasks and progress persist across sessions
• 📋 Structured Workflows: Guided processes for planning, execution, and verification
• 🔄 Smart Decomposition: Automatically breaks complex tasks into manageable subtasks
• 🎯 Context Preservation: Never lose your place, even with token limits

• Intelligent Planning: Deep analysis of requirements before implementation
• Task Decomposition: Break down large projects into atomic, testable units
• Dependency Tracking: Automatic management of task relationships
• Progress Monitoring: Real-time status tracking and updates

• 🔬 Research Mode: Systematic exploration of technologies and solutions
• 🤖 Agent System: Assign specialized AI agents to specific tasks (Learn more)
• 📏 Project Rules: Define and maintain coding standards across your project
• 💾 Task Memory: Automatic backup and restoration of task history

Modern React interface for visual task management with drag-and-drop, real-time search, and multi-profile support.

Quick Setup:

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

📖 Full Task Viewer Documentation

Optional lightweight web interface for quick task overview.

Enable in .env: ENABLE_GUI=true

• 📖 Full Documentation
• 🛠️ Available Tools
• 🤖 Agent Management
• 🎨 Prompt Customization
• 🔧 API Reference

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

Create a .env file:

# 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.)

We welcome contributions! Please see our Contributing Guide for details.

This project is licensed under the MIT License - see the LICENSE file for details.

Created by cjo4m06 and maintained by the community.

GitHub • Issues • Discussions