🇺🇸 English | 🇩🇪 Deutsch | 🇪🇸 Español | 🇫🇷 Français | 🇮🇹 Italiano | 🇮🇳 हिन्दी | 🇰🇷 한국어 | 🇧🇷 Português | 🇷🇺 Русский | 🇨🇳 中文

MCP Shrimp Task Manager

🦐 面向 AI 辅助开发的智能任务管理工具 - 将复杂的项目拆解为可管理的任务，在不同会话间保持上下文，并加速你的开发工作流。

观看演示视频 • 快速开始 • 文档

🚀 快速开始

前置条件

• Node.js 18+
• npm 或 yarn
• 兼容 MCP 的 AI 客户端 (如 Claude Code 等)

安装

安装 Claude Code

Windows 11 (使用 WSL2):

# 首先确保已安装 WSL2 (在以管理员身份运行的 PowerShell 中)
wsl --install

# 进入 Ubuntu/WSL 环境
wsl -d Ubuntu

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 启动 Claude Code
claude

macOS/Linux:

# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 启动 Claude Code
claude

安装 Shrimp Task Manager

# 克隆仓库
git clone https://github.com/cjo4m06/mcp-shrimp-task-manager.git
cd mcp-shrimp-task-manager

# 安装依赖
npm install

# 构建项目
npm run build

配置 Claude Code

在你的项目目录下创建一个 .mcp.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"
      }
    }
  }
}

配置示例：

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

然后使用自定义的 MCP 配置启动 Claude Code：

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

其他 AI 客户端：

Cline (VS Code 插件)：用于 AI 辅助编码的 VS Code 插件。请添加到 VS Code settings.json 的 cline.mcpServers 中。

Claude Desktop：添加到 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows)。

开始使用

1. 初始化项目："init project rules"
2. 计划任务："plan task: implement user authentication"
3. 执行任务："execute task" 或 "continuous mode"

💡 什么是 Shrimp？

Shrimp Task Manager 是一个 MCP (Model Context Protocol) 服务器，它改变了 AI Agent 进行软件开发的方式。Shrimp 不再让 AI 丢失上下文或重复工作，而是提供了：

• 🧠 持久化记忆：任务和进度在不同会话间持续存在
• 📋 结构化工作流：针对规划、执行和验证的引导式流程
• 🔄 智能拆解：自动将复杂任务拆解为可管理的子任务
• 🎯 上下文留存：即使在 Token 限制下，也不会丢失当前工作进度

✨ 核心功能

任务管理

• 智能规划：在实施前对需求进行深入分析
• 任务拆解：将大型项目拆分为原子的、可测试的单元
• 依赖追踪：自动管理任务间的依赖关系
• 进度监控：实时的状态跟踪和更新

高级能力

• 🔬 研究模式：系统性地探索技术方案
• 🤖 Agent 系统：为特定任务分配专门的 AI Agent (了解更多)
• 📏 项目规则：在整个项目中定义并维护编码标准
• 💾 任务记忆：自动备份和恢复任务历史

Web 界面

🖥️ 任务查看器 (Task Viewer)

现代化的 React 界面，支持可视化任务管理、拖拽、实时搜索和多配置支持。

快速设置：

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

📖 查看任务查看器完整文档

🌐 Web GUI

可选的轻量级 Web 界面，用于快速概览任务。

在 .env 中启用：ENABLE_GUI=true

📚 文档

• 📖 完整文档
• 🛠️ 可用工具
• 🤖 Agent 管理
• 🎨 Prompt 自定义