MCP Shrimp Task Manager

★ 2,100

from cjo4m06

An intelligent task management system based on MCP, providing an efficient programming workflow framework for AI Agents with an optional web-based GUI.

🔥🔥🔥🔥✓ VerifiedFreeAdvanced setup

#automation #git #monitoring

MCP Shrimp Task Manager

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

Watch Demo Video • Quick Start • Documentation

💡 What is Shrimp?

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

✨ Core Features

Task Management

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

Advanced Capabilities

🔬 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

Web Interfaces

🖥️ Task Viewer

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

Quick Setup:

Copy & paste — that's it

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

📖 Full Task Viewer Documentation

🌐 Web GUI

Optional lightweight web interface for quick task overview.

Enable in .env: ENABLE_GUI=true

📚 Documentation

🎯 Common Use Cases

Feature Development

Copy & paste — that's it

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

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

Bug Fixing

Copy & paste — that's it

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

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

Research & Learning

Copy & paste — that's it

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

🤝 Contributing

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

📄 License

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

🌟 Credits

Created by cjo4m06 and maintained by the community.

GitHub • Issues • Discussions

Copy & paste — that's it

# 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

Before it works, you'll need: DATA_DIRTEMPLATES_USEENABLE_GUI

🚀 Quick Start

Prerequisites

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

Installation

Installing Claude Code

Windows 11 (with WSL2):

Copy & paste — that's it

# 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:

Copy & paste — that's it

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

# Start Claude Code
claude

Installing Shrimp Task Manager

Copy & paste — that's it

# 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

Configure Claude Code

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

Copy & paste — that's it

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

Copy & paste — that's it

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

Copy & paste — that's it

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

Other AI Clients** Cline (VS Code Extension): A VS Code extension for AI-assisted coding. Add to VS Code settings.json under cline.mcpServers

Claude Desktop: Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

Start Using

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

🛠️ Configuration

Environment Variables

Create a .env file:

Copy & paste — that's it

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

Available Commands

Command Description init project rules Initialize project standards plan task [description] Create a task plan execute task [id] Execute specific task continuous mode Execute all tasks sequentially list tasks Show all tasks research [topic] Enter research mode reflect task [id] Review and improve task