虾任务管理器

Name: 虾任务管理器
Author: cjo4m06

作者：cjo4m061887 星标更新：2025-08-21

安装使用来源：spider==github.com

项目介绍

🇺🇸 英文 | 🇩🇪 德文 | 🇪🇸 西班牙文 | 🇫🇷 法文 | 🇮🇹 意大利文 | 🇮🇳 印地文 | 🇰🇷 韩文 | 🇧🇷 葡萄牙文 | 🇷🇺 俄文 | 🇨🇳 中文

MCP 虾任务管理器

🦐 智能任务管理，助力AI驱动的开发 - 将复杂项目分解为可管理的任务，跨会话维护上下文，并加速您的开发流程。

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

</div>

🚀 快速开始

先决条件

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

安装虾任务管理器

# 克隆仓库
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

<details> <summary>其他AI客户端</summary>

Cline（VS Code扩展）：一个用于AI辅助编码的VS Code扩展。添加到VS Code的settings.json下的cline.mcpServers

Claude桌面版：添加到~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或%APPDATA%\Claude\claude_desktop_config.json（Windows）

</details>

开始使用

初始化项目："init project rules"
规划任务："plan task: 实现用户认证"
执行任务："execute task" 或 "continuous mode"

💡 虾是什么？

虾任务管理器是一个MCP（模型上下文协议）服务器，它改变了AI代理处理软件开发的方式。通过虾，可以避免丢失上下文或重复工作，虾提供了：

🧠 持久记忆：任务和进度跨会话持久化
📋 结构化工作流：指导性的规划、执行和验证过程
🔄 智能分解：自动将复杂任务分解为可管理的子任务
🎯 上下文保留：即使有令牌限制，也不会迷失方向

✨ 核心功能

任务管理

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

高级能力

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

Web界面

🖥️ 任务查看器

现代React界面，支持视觉任务管理，包括拖放、实时搜索和多配置文件支持。

快速设置：

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

📖 完整任务查看器文档

🌐 Web GUI

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

在.env中启用：ENABLE_GUI=true

📚 文档

🎯 常见用例

代理："plan task: 添加JWT用户认证"
# 代理分析代码库，创建子任务

代理："execute task"
# 分步实现认证

</details> <details> <summary>错误修复</summary>

代理："plan task: 修复数据处理中的内存泄漏"
# 代理研究问题，制定修复计划

代理："continuous mode"
# 自动执行所有修复任务

</details> <details> <summary>研究与学习</summary>

代理："research: 比较React与Vue在本项目中的应用"
# 系统性分析优缺点

代理："plan task: 根据研究迁移组件到选定框架"
# 基于研究创建迁移计划

</details>

🛠️ 配置

环境变量

创建一个.env文件：

# 必需
DATA_DIR=/path/to/data/storage

# 可选
ENABLE_GUI=true          # 启用Web GUI
WEB_PORT=3000           # 自定义Web端口
PROMPT_LANGUAGE=en      # 提示语言（en, zh等）

可用命令

命令	描述
`init project rules`	初始化项目标准
`plan task [描述]`	创建任务计划
`execute task [ID]`	执行特定任务
`continuous mode`	依次执行所有任务
`list tasks`	显示所有任务
`research [主题]`	进入研究模式
`reflect task [ID]`	回顾并改进任务

🤝 贡献

我们欢迎贡献！请参阅我们的贡献指南以获取详细信息。

📄 许可证

该项目采用MIT许可证 - 详情请参阅LICENSE文件。

🌟 致谢

由cjo4m06创建并由社区维护。

<a href="https://github.com/cjo4m06/mcp-shrimp-task-manager">GitHub</a> • <a href="https://github.com/cjo4m06/mcp-shrimp-task-manager/issues">问题</a> • <a href="https_//github.com/cjo4m06/mcp-shrimp-task-manager/discussions">讨论</a>