/ 目录 / 演练场 / mcp-shrimp-task-manager
● 社区 cjo4m06 ⚡ 即开即用

mcp-shrimp-task-manager

作者 cjo4m06 · cjo4m06/mcp-shrimp-task-manager

持久化任务管理器,用于 AI 编码代理——自然语言需求转化为带有依赖关系的结构化任务,跨会话追踪。

mcp-shrimp-task-manager (cjo4m06) 将自由形式的需求转化为感知依赖的任务图。支持 'plan task'、'execute task'、continuous mode、research mode 和专门的代理分配。磁盘上的持久化 JSON 在有限 token 的会话中保持进度。

为什么要用

核心特性

实时演示

实际使用效果

shrimp-task-manager.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "shrimp-task-manager": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-shrimp-task-manager"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "shrimp-task-manager": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-shrimp-task-manager"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "shrimp-task-manager": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-shrimp-task-manager"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "shrimp-task-manager": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-shrimp-task-manager"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "shrimp-task-manager",
      "command": "npx",
      "args": [
        "-y",
        "mcp-shrimp-task-manager"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "shrimp-task-manager": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-shrimp-task-manager"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add shrimp-task-manager -- npx -y mcp-shrimp-task-manager

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: mcp-shrimp-task-manager

在多个 Claude 会话中使用 Shrimp 发货多天功能

👤 在长期功能上工作的独立开发者 ⏱ ~45 min intermediate

何时使用: 功能比一个 Claude context window 更大——你不想丢失状态。

前置条件
  • 克隆并构建 Repo — npm install && npm run build in mcp-shrimp-task-manager; point .mcp.json at the data dir
步骤
  1. 计划
    在 'implement two-factor auth' 上使用 Shrimp plan_task。生成带有依赖的任务。✓ 已复制
    → 任务图保存到磁盘
  2. 一次执行一个任务
    执行 execute_task next。完成后,标记为完成并显示下一个。✓ 已复制
    → 一个任务完成,下一个已排队
  3. 明天继续
    (新会话) 读取 Shrimp 状态并从第一个打开的任务继续。✓ 已复制
    → 代理从中断的地方继续

结果: 多会话功能交付,无需重复转储上下文。

注意事项
  • 手动 commit 后任务图与现实脱离 — 偶尔运行协调步骤——将完成的任务与实际 repo 状态进行 diff
搭配使用: github

Research mode:在提交代码前探索选项

👤 比较方案的工程师 ⏱ ~30 min intermediate

何时使用: 你有 2-3 个实现选项,想要有序的探索,而不是随意。

步骤
  1. 进入研究模式
    Shrimp research_mode:比较我的 React 应用的三个状态管理选项——Zustand、Redux Toolkit、Jotai。记录权衡。✓ 已复制
    → 每个选项的研究笔记
  2. 将赢家转换为任务
    我会选择 Zustand。将研究结论转换为任务计划。✓ 已复制
    → 与决策一致的任务图

结果: 知情决策与执行任务的追踪一起进行。

搭配使用: idea-reality

通过 Shrimp 在每个代理转换上强制执行项目规则

👤 有严格编码标准的团队 ⏱ ~15 min beginner

何时使用: 代理持续忘记你的 ESLint 配置或架构约束。

步骤
  1. 设置项目规则
    在 Shrimp 中设置规则:(1) TypeScript 中没有 any (2) 所有网络代码在 services/ 层 (3) 测试与源代码相邻。✓ 已复制
    → 规则已保存
  2. 在上下文中执行规则
    执行下一个任务;Shrimp 自动注入规则。✓ 已复制
    → 代理在没有提醒的情况下尊重规则

结果: 长会话中的一致输出。

组合

与其他 MCP 搭配,撬动十倍杠杆

shrimp-task-manager + github

每个完成的任务成为带有关联 PR 的提交

在每个 execute_task 之后,使用 Conventional Commits 格式提交;当计划中的所有任务完成后,打开草稿 PR。✓ 已复制
shrimp-task-manager + overture

Overture 中的视觉计划,Shrimp 中的持久化执行

使用 Overture 批准计划图;然后将任务交给 Shrimp 进行跟踪的执行。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
plan_task description: str, rules?: str[] 功能开始 LLM tokens
execute_task task_id?: str (defaults to next open) 驱动下一步 LLM tokens + tool calls
research_mode question: str 代码前的探索 LLM tokens
continuous_mode 当你相信计划并想要无需干预时 can be high
set_rules rules: str[] 项目入职 0

成本与限制

运行它的成本

API 配额
使用你的 LLM quota
每次调用 Token 数
Plan: 2-5k。Execute: 取决于任务
费用
免费
提示
在为当前项目逐步验证计划之前,避免 continuous_mode

安全

权限、密钥、影响范围

凭据存储: 本身没有;无论执行的任务到达哪里
数据出站: 任务状态存储在你配置的数据目录中

故障排查

常见错误与修复

代理在重启后忘记任务图

确保 .mcp.json 中的数据目录路径是稳定的,而不是 /tmp

验证: cat the state file — tasks should be present
Continuous mode 失控

杀死会话;Shrimp 保持状态,所以你可以选择检查和继续

构建步骤在 npm install 时失败

需要 Node 18+。在某些设置上 Shrimp 有本机依赖——检查平台说明

替代方案

mcp-shrimp-task-manager 对比其他方案

替代方案何时用它替代权衡
sequentialthinking-tools你想要会话内规划,而不是持久化任务没有跨会话的记忆
Linear MCP你想要在你的团队问题追踪器中的任务云端/付费;团队开销

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills