mcp-shrimp-task-manager
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.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/cjo4m06--mcp-shrimp-task-manager)HTML
<a href="/listings/cjo4m06--mcp-shrimp-task-manager"><img src="/api/listings/cjo4m06--mcp-shrimp-task-manager/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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
<details> <summary><b>Other AI Clients</b></summary>
**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) </details>
Start Using
1. **Initialize your project**: `"init project rules"` 2. **Plan a task**: `"plan task: implement user authentication"` 3. **Execute tasks**: `"execute task"` or `"continuous mode"`
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 261 lines · 1 finding marked
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- [🇺🇸 English](README.md) | [🇩🇪 Deutsch](docs/de/README.md) | [🇪🇸 Español](docs/es/README.md) | [🇫🇷 Français](docs/fr/README.md) | [🇮🇹 Italiano](docs/it/README.md) | [🇮🇳 हिन्दी](docs/hi/README.md) | [🇰🇷 한국어](docs/ko/README.md) | [🇧🇷 Português](docs/pt/README.md) | [🇷🇺 Русский](docs/ru/README.md) | [🇨🇳 中文](docs/zh/README.md)
- # 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.
- <div align="center">
- [](https://www.youtube.com/watch?v=Arzu0lV09so)
- **[Watch Demo Video](https://www.youtube.com/watch?v=Arzu0lV09so)** • **[Quick Start](#-quick-start)** • **[Documentation](#-documentation)**
- [](https://smithery.ai/server/@cjo4m06/mcp-shrimp-task-manager)
- <a href="https://glama.ai/mcp/servers/@cjo4m06/mcp-shrimp-task-manager"><img width="380" height="200" src="https://glama.ai/mcp/servers/@cjo4m06/mcp-shrimp-task-manager/badge" alt="Shrimp Task Manager MCP server" /></a>
- </div>
- ## 🚀 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:
- ```bash
- claude --dangerously-skip-permissions --mcp-config .mcp.json
- Note: Starts a coding agent with its permission prompts off
- Line 107 on GitHub
- ```
- <details>
- <summary><b>Other AI Clients</b></summary>
- **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)
- </details>
- ### Start Using
- 1. **Initialize your project**: `"init project rules"`
- 2. **Plan a task**: `"plan task: implement user authentication"`
- 3. **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](docs/agents.md))
- - **📏 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:**
- ```bash
- cd tools/task-viewer
- npm install
- npm run start:all
- # Access at http://localhost:5173
- ```
- [📖 Full Task Viewer Documentation](tools/task-viewer/README.md)
- <kbd><img src="tools/task-viewer/task-viewer-interface.png" alt="Task Viewer Interface" width="600"/></kbd>
- #### 🌐 Web GUI
- Optional lightweight web interface for quick task overview.
- Enable in `.env`: `ENABLE_GUI=true`
- ## 📚 Documentation
- - [📖 Full Documentation](docs/README.md)
- - [🛠️ Available Tools](docs/tools.md)
- - [🤖 Agent Management](docs/agents.md)
- - [🎨 Prompt Customization](docs/en/prompt-customization.md)
- - [🔧 API Reference](docs/api.md)
- ## 🎯 Common Use Cases
- <details>
- <summary><b>Feature Development</b></summary>
- ```
- Agent: "plan task: add user authentication with JWT"
- # Agent analyzes codebase, creates subtasks
- Agent: "execute task"
- # Implements authentication step by step
- ```
- </details>
- <details>
- <summary><b>Bug Fixing</b></summary>
- ```
- Agent: "plan task: fix memory leak in data processing"
- # Agent researches issue, creates fix plan
- Agent: "continuous mode"
- # Executes all fix tasks automatically
- ```
- </details>
- <details>
- <summary><b>Research & Learning</b></summary>
- ```
- 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
- ```
- </details>
- ## 🛠️ 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](CONTRIBUTING.md) for details.
- ## 📄 License
- This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
- ## 🌟 Credits
- Created by [cjo4m06](https://github.com/cjo4m06) and maintained by the community.
- ---
- <p align="center">
- <a href="https://github.com/cjo4m06/mcp-shrimp-task-manager">GitHub</a> •
- <a href="https://github.com/cjo4m06/mcp-shrimp-task-manager/issues">Issues</a> •
- <a href="https://github.com/cjo4m06/mcp-shrimp-task-manager/discussions">Discussions</a>
- </p>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.