๐บ๐ธ English | ๐ฉ๐ช Deutsch | ๐ช๐ธ Espaรฑol | ๐ซ๐ท Franรงais | ๐ฎ๐น Italiano | ๐ฎ๐ณ เคนเคฟเคจเฅเคฆเฅ | ๐ฐ๐ท ํ๊ตญ์ด | ๐ง๐ท Portuguรชs | ๐ท๐บ ะ ัััะบะธะน | ๐จ๐ณ ไธญๆ
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):
bash# 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:
bash# Install Claude Code globally npm install -g @anthropic-ai/claude-code # Start Claude Code claude
Installing Shrimp Task Manager
bash# 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:
json{ "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:
json{ "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:
bashclaude --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:
bashcd 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
- ๐ Full Documentation
- ๐ ๏ธ Available Tools
- ๐ค Agent Management
- ๐จ Prompt Customization
- ๐ง API Reference
๐ฏ 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:
bash# 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.




