mcp-shrimp-task-manager
为 AI Agent 提供持久化任务记忆,支持思维链追踪与多阶段复杂任务自动分解执行
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
为 AI Agent 提供持久化任务记忆,支持思维链追踪与多阶段复杂任务自动分解执行
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
当你让 AI 帮你写一个完整的 Web 应用,它可能第一分钟就写出了漂亮的首页——但接下来的几天,你发现它:忘了首页需要配套的 API 接口,后端一片空白;写数据库 schema 和写业务逻辑的人"互相不认识",字段对不上;代码风格飘忽不定:有时候用 TypeScript strict 模式,有时候又偷偷用 any;写着写着,突然问你"接下来做什么",你得从头解释上下文。
这些问题背后有一个根本原因:大多数 AI 编程工具缺乏结构化的任务管理能力。它们像一个记忆力有限的实习生,每次对话都是"全新开始"。
Shrimp Task Manager(简称 Shrimp,直译"虾")正是为解决这个痛点而生。它的核心定位是:为 AI Agents 提供任务管理基础设施,让 AI 能够像人类开发者一样,把复杂项目拆解为结构化任务、追踪依赖关系、保持风格一致,并在执行过程中进行反思和调整。
Shrimp Task Manager 由 GitHub 用户 cjo4m06 开发维护,是一个开源的 MCP(Model Context Protocol)服务器实现。MCP 是 Anthropic 主导推出的 AI 与工具/数据源交互的标准协议,类似于 AI 领域的"USB 接口"——只要双方都遵循这个协议,就可以互相通信。
"Shrimp"(虾)这个命名并非随意。它的灵感来自 Shrimp Coding 概念——一种强调"小步快跑、持续迭代"的编程哲学。虾的特点是:体型小但反应快、能倒退游动(反思)、动作精准(结构化)。作者用这个比喻来暗示 Shrimp 工具的设计目标:让 AI 像虾一样敏捷、精准,并能"后退一步"审视自己的工作。
该项目在 GitHub 上已获得 2112 stars,fork 254 次,topics 覆盖了当前主流 AI Coding 工具生态(cursorai、windsurf、agent、codeagent 等),说明它精准命中了 AI 辅助开发社区的需求。
Shrimp Task Manager 提供了一套完整的 AI 任务生命周期管理能力:
plan_task 工具接收一段自然语言描述(比如"帮我搭建一个用户登录系统"),将其解析为结构化的开发任务树,支持子任务分解和依赖关系建模。这意味着 AI 不再是"想到哪写到哪",而是有了一个全局作战图。
execute_task 和 list_tasks 工具负责执行和监控任务状态。每完成一个任务,状态自动更新;依赖关系确保前置任务完成后才执行后续任务,避免"还没写数据库 schema 就开始写业务逻辑"的情况。
reflect_task 和 verify_task 是 Shrimp 的亮点功能。它们让 AI 在完成任务后"停下来想一想":当前实现是否符合预期?风格是否与项目规范一致?有没有遗漏的边界情况?这种反思机制是区分"能用"和"好用"的关键。
process_thought 工具专门处理 AI 的中间推理过程。它将思维链外化存储,让 AI 在长时间任务中保持上下文连贯,不会"失忆"。
init_project_rules 工具让 AI 快速了解当前项目的技术栈、编码规范和目录结构。这是保持风格一致性的前提——如果 AI 知道项目用的是 ESLint + Prettier、TypeScript strict 模式、目录结构是 MVC,它就能自动对齐。
research_mode 为 AI 提供了一个系统化的技术调研框架。项目目录下的 shrimp-rules.md 则定义了 AI Agent 在该项目中的行为规范——包括命名规则(变量用 camelCase、类名用 PascalCase)、格式要求(2空格缩进、必须分号)等软约束。
从源码结构来看,Shrimp Task Manager 是一个典型的 TypeScript Node.js 项目,核心依赖包括:
@modelcontextprotocol/sdk(v1.0.0+):官方 MCP SDK,负责与 AI 客户端的通信协议处理zod(v3.22.4+):运行时数据验证库,所有工具输入输出都经过 Zod schema 验证express(v5.1.0):当 ENABLE_GUI=true 时可选启动 Web GUI 服务uuid、dotenv、get-port:工具类依赖项目采用 ES Module 模式("type": "module"),源码组织清晰:
| 目录 | 职责 |
|---|---|
src/tools/task/ | 任务管理工具(plan、execute、list、split 等) |
src/tools/project/ | 项目规则初始化工具 |
src/tools/thought/ | 思维链处理工具 |
src/tools/research/ | 研究模式工具 |
src/models/ | 数据模型与 Zod Schema 定义 |
src/prompts/ | AI 提示词模板(支持多语言) |
src/web/ | 可选 Web GUI 服务 |
src/utils/ | 通用工具函数 |
编译后通过 dist/index.js 暴露为 CLI 可执行文件,或作为 MCP 服务器通过 stdio 与 AI 客户端通信。
Shrimp Task Manager 提供了多种接入方式:npm 全局安装(最简单)、Docker 容器(Smithery.ai 官方镜像,适合服务器场景)、Smithery.ai 市场一键集成(Claude Desktop、Cursor、Windsurf 等主流 AI IDE)、以及自定义指令集成到各大 AI 编程助手的原生工作流。硬件门槛极低(Node.js >= 18,无 GPU 需求),部署难度评为"简单",预计 10 分钟内可完成。
Shrimp Task Manager 的崛起背后,是一个正在快速演进的大趋势:AI 编程工具正在从"单次问答"向"持续工程"进化。随着 Claude Code、Cursor Agent、Windsurf 等 AI Coding Agent 的爆发式增长,这些工具普遍面临一个共同问题:缺乏长期任务记忆和结构化执行能力。Shrimp 填补了"MCP 生态中任务管理基础设施"这一空白。2112 stars 和 254 forks 的社区数据印证了需求的真实性和强烈程度。