Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/cjo4m06--mcp-shrimp-task-manager/badge.svg)](/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

i

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)

  1. [🇺🇸 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)
  2. # MCP Shrimp Task Manager
  3. > 🦐 **Intelligent task management for AI-powered development** - Break down complex projects into manageable tasks, maintain context across sessions, and accelerate your development workflow.
  4. <div align="center">
  5. [![Shrimp Task Manager Demo](docs/yt.png)](https://www.youtube.com/watch?v=Arzu0lV09so)
  6. **[Watch Demo Video](https://www.youtube.com/watch?v=Arzu0lV09so)** • **[Quick Start](#-quick-start)** • **[Documentation](#-documentation)**
  7. [![smithery badge](https://smithery.ai/badge/@cjo4m06/mcp-shrimp-task-manager)](https://smithery.ai/server/@cjo4m06/mcp-shrimp-task-manager)
  8. <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>
  9. </div>
  10. ## 🚀 Quick Start
  11. ### Prerequisites
  12. - Node.js 18+
  13. - npm or yarn
  14. - MCP-compatible AI client (Claude Code, etc.)
  15. ### Installation
  16. #### Installing Claude Code
  17. **Windows 11 (with WSL2):**
  18. ```bash
  19. # First, ensure WSL2 is installed (in PowerShell as Administrator)
  20. wsl --install
  21. # Enter Ubuntu/WSL environment
  22. wsl -d Ubuntu
  23. # Install Claude Code globally
  24. npm install -g @anthropic-ai/claude-code
  25. # Start Claude Code
  26. claude
  27. ```
  28. **macOS/Linux:**
  29. ```bash
  30. # Install Claude Code globally
  31. npm install -g @anthropic-ai/claude-code
  32. # Start Claude Code
  33. claude
  34. ```
  35. #### Installing Shrimp Task Manager
  36. ```bash
  37. # Clone the repository
  38. git clone https://github.com/cjo4m06/mcp-shrimp-task-manager.git
  39. cd mcp-shrimp-task-manager
  40. # Install dependencies
  41. npm install
  42. # Build the project
  43. npm run build
  44. ```
  45. ### Configure Claude Code
  46. Create a `.mcp.json` file in your project directory:
  47. ```json
  48. {
  49. "mcpServers": {
  50. "shrimp-task-manager": {
  51. "command": "node",
  52. "args": ["/path/to/mcp-shrimp-task-manager/dist/index.js"],
  53. "env": {
  54. "DATA_DIR": "/path/to/your/shrimp_data",
  55. "TEMPLATES_USE": "en",
  56. "ENABLE_GUI": "false"
  57. }
  58. }
  59. }
  60. }
  61. ```
  62. Example configuration:
  63. ```json
  64. {
  65. "mcpServers": {
  66. "shrimp-task-manager": {
  67. "command": "node",
  68. "args": ["/home/fire/claude/mcp-shrimp-task-manager/dist/index.js"],
  69. "env": {
  70. "DATA_DIR": "/home/fire/claude/project/shrimp_data",
  71. "TEMPLATES_USE": "en",
  72. "ENABLE_GUI": "false"
  73. }
  74. }
  75. }
  76. }
  77. ```
  78. Then start Claude Code with your custom MCP configuration:
  79. ```bash
  80. claude --dangerously-skip-permissions --mcp-config .mcp.json
  81. ```
  82. <details>
  83. <summary><b>Other AI Clients</b></summary>
  84. **Cline (VS Code Extension)**: A VS Code extension for AI-assisted coding. Add to VS Code settings.json under `cline.mcpServers`
  85. **Claude Desktop**: Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows)
  86. </details>
  87. ### Start Using
  88. 1. **Initialize your project**: `"init project rules"`
  89. 2. **Plan a task**: `"plan task: implement user authentication"`
  90. 3. **Execute tasks**: `"execute task"` or `"continuous mode"`
  91. ## 💡 What is Shrimp?
  92. 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:
  93. - **🧠 Persistent Memory**: Tasks and progress persist across sessions
  94. - **📋 Structured Workflows**: Guided processes for planning, execution, and verification
  95. - **🔄 Smart Decomposition**: Automatically breaks complex tasks into manageable subtasks
  96. - **🎯 Context Preservation**: Never lose your place, even with token limits
  97. ## ✨ Core Features
  98. ### Task Management
  99. - **Intelligent Planning**: Deep analysis of requirements before implementation
  100. - **Task Decomposition**: Break down large projects into atomic, testable units
  101. - **Dependency Tracking**: Automatic management of task relationships
  102. - **Progress Monitoring**: Real-time status tracking and updates
  103. ### Advanced Capabilities
  104. - **🔬 Research Mode**: Systematic exploration of technologies and solutions
  105. - **🤖 Agent System**: Assign specialized AI agents to specific tasks ([Learn more](docs/agents.md))
  106. - **📏 Project Rules**: Define and maintain coding standards across your project
  107. - **💾 Task Memory**: Automatic backup and restoration of task history
  108. ### Web Interfaces
  109. #### 🖥️ Task Viewer
  110. Modern React interface for visual task management with drag-and-drop, real-time search, and multi-profile support.
  111. **Quick Setup:**
  112. ```bash
  113. cd tools/task-viewer
  114. npm install
  115. npm run start:all
  116. # Access at http://localhost:5173
  117. ```
  118. [📖 Full Task Viewer Documentation](tools/task-viewer/README.md)
  119. <kbd><img src="tools/task-viewer/task-viewer-interface.png" alt="Task Viewer Interface" width="600"/></kbd>
  120. #### 🌐 Web GUI
  121. Optional lightweight web interface for quick task overview.
  122. Enable in `.env`: `ENABLE_GUI=true`
  123. ## 📚 Documentation
  124. - [📖 Full Documentation](docs/README.md)
  125. - [🛠️ Available Tools](docs/tools.md)
  126. - [🤖 Agent Management](docs/agents.md)
  127. - [🎨 Prompt Customization](docs/en/prompt-customization.md)
  128. - [🔧 API Reference](docs/api.md)
  129. ## 🎯 Common Use Cases
  130. <details>
  131. <summary><b>Feature Development</b></summary>
  132. ```
  133. Agent: "plan task: add user authentication with JWT"
  134. # Agent analyzes codebase, creates subtasks
  135. Agent: "execute task"
  136. # Implements authentication step by step
  137. ```
  138. </details>
  139. <details>
  140. <summary><b>Bug Fixing</b></summary>
  141. ```
  142. Agent: "plan task: fix memory leak in data processing"
  143. # Agent researches issue, creates fix plan
  144. Agent: "continuous mode"
  145. # Executes all fix tasks automatically
  146. ```
  147. </details>
  148. <details>
  149. <summary><b>Research & Learning</b></summary>
  150. ```
  151. Agent: "research: compare React vs Vue for this project"
  152. # Systematic analysis with pros/cons
  153. Agent: "plan task: migrate component to chosen framework"
  154. # Creates migration plan based on research
  155. ```
  156. </details>
  157. ## 🛠️ Configuration
  158. ### Environment Variables
  159. Create a `.env` file:
  160. ```bash
  161. # Required
  162. DATA_DIR=/path/to/data/storage
  163. # Optional
  164. ENABLE_GUI=true # Enable web GUI
  165. WEB_PORT=3000 # Custom web port
  166. PROMPT_LANGUAGE=en # Prompt language (en, zh, etc.)
  167. ```
  168. ### Available Commands
  169. | Command | Description |
  170. |---------|-------------|
  171. | `init project rules` | Initialize project standards |
  172. | `plan task [description]` | Create a task plan |
  173. | `execute task [id]` | Execute specific task |
  174. | `continuous mode` | Execute all tasks sequentially |
  175. | `list tasks` | Show all tasks |
  176. | `research [topic]` | Enter research mode |
  177. | `reflect task [id]` | Review and improve task |
  178. ## 🤝 Contributing
  179. We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
  180. ## 📄 License
  181. This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
  182. ## 🌟 Credits
  183. Created by [cjo4m06](https://github.com/cjo4m06) and maintained by the community.
  184. ---
  185. <p align="center">
  186. <a href="https://github.com/cjo4m06/mcp-shrimp-task-manager">GitHub</a> •
  187. <a href="https://github.com/cjo4m06/mcp-shrimp-task-manager/issues">Issues</a> •
  188. <a href="https://github.com/cjo4m06/mcp-shrimp-task-manager/discussions">Discussions</a>
  189. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.