Shrimp Task Manager

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

🚀 Quick Start

Prerequisites

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

Installation

Installing Claude Code

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

Installing 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

Configure Claude Code

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

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"

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

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

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

🛠️ Configuration

Environment Variables

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

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

🤝 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.

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

MCP Shrimp Task Manager is a task tool built for AI Agents, emphasizing chain-of-thought, reflection, and style consistency. It converts natural language into structured dev tasks with dependency tracking and iterative refinement, enabling agent-like developer behavior in reasoning AI systems.

MCP Shrimp Task Manager

Related MCP Servers

TaskMateAI
NewAITees
-
security
A
license
-
quality
AI-driven task management application that operates via MCP, enabling autonomous creation, organization, and execution of tasks with support for subtasks, priorities, and progress tracking.
Last updated -
2
MIT License
Vibe Coder MCP
freshtechbro
A
security
F
license
A
quality
An MCP server that supercharges AI assistants with powerful tools for software development, enabling research, planning, code generation, and project scaffolding through natural language interaction.
Last updated -
11
142
72
TickTick MCP Server
jen6
-
security
F
license
-
quality
An MCP server that enhances TickTick workflow by providing comprehensive task management tools with improved filtering capabilities, allowing AI assistants and MCP-compatible applications to interact with TickTick tasks with greater precision.
Last updated -
30
Kiro MCP Memory
cbunting99
-
security
A
license
-
quality
An enhanced MCP server that provides intelligent memory and task management for AI assistants, featuring semantic search, automatic task extraction, and knowledge graphs to help manage development workflows.
Last updated -
13
MIT License

View all related MCP servers

Shrimp Task Manager

MCP Shrimp Task Manager

🚀 Quick Start

Prerequisites

Installation

Installing Claude Code

Installing Shrimp Task Manager

Configure Claude Code

Start Using

�� What is Shrimp?

✨ Core Features

Task Management

Advanced Capabilities

Web Interfaces

🖥️ Task Viewer

🌐 Web GUI

📚 Documentation

🎯 Common Use Cases

🛠️ Configuration

Environment Variables

Available Commands

🤝 Contributing

📄 License

🌟 Credits

Related MCP Servers

TaskMateAI

Vibe Coder MCP

TickTick MCP Server

Kiro MCP Memory

Appeared in Searches

New MCP Servers

MCP directory API

MCP Shrimp Task Manager

🚀 Quick Start

Prerequisites

Installation

Installing Claude Code

Installing Shrimp Task Manager

Configure Claude Code

Start Using

��� What is Shrimp?

✨ Core Features

Task Management

Advanced Capabilities

Web Interfaces

🖥️ Task Viewer

🌐 Web GUI

📚 Documentation

🎯 Common Use Cases

🛠️ Configuration

Environment Variables

Available Commands

🤝 Contributing

📄 License

🌟 Credits

Related MCP Servers

TaskMateAI

Vibe Coder MCP

TickTick MCP Server

Kiro MCP Memory

Appeared in Searches

New MCP Servers

MCP directory API

�� What is Shrimp?