🇺🇸 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 不会让你丢失上下文或重复劳动，它提供了：

• 🧠 持久化内存：任务和进度在不同会话间持续存在
• 📋 结构化工作流：针对规划、执行和验证的引导式流程
• 🔄 智能拆解：自动将复杂任务分解为可管理的子任务
• 🎯 上下文保留：即使在 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 管理
• 🎨 提示词自定义