How cjo4m06/mcp-shrimp-task-manager works
Shrimp Task Manager is an MCP server that helps AI clients plan, decompose, execute, and track development tasks, with persistent task memory and optional web interfaces. The principal workflow begins with an AI client invoking registered tools; task tools use prompts and, for supported operations, the task model. Planning and decomposition can incorporate specialized agents. The repository also includes an optional lightweight web GUI and a separate React Task Viewer. Some tool implementations and viewer-server wiring were not sampled, so those relationships are shown only where documented or evidenced.
Main entry points: index.ts MCP Server · task Task Tools · researchMode.ts Research Mode · taskModel.ts Task Memory
Components 18
MCP Runtime
- MCP Server
src/index.ts - Data Paths
src/utils/paths.ts
Task Workflows
- Task Tools
src/tools/task - Research Mode
src/tools/research/researchMode.ts - Project Rules
src/tools/project/initProjectRules.ts - Thought Processing
src/tools/thought/processThought.ts - Task Memory
src/models/taskModel.ts
Prompts & Agents
- Prompt Templates
src/prompts/loader.ts - Agent Definitions
src/utils/agentLoader.ts - Agent Matching
src/utils/agentMatcher.ts
Web Interfaces
- Lightweight Web GUI
src/web/webServer.ts - Task Viewer
tools/task-viewer/src/App.jsx - Task Table
tools/task-viewer/src/components/TaskTable.jsx - History Tasks
tools/task-viewer/src/components/HistoryTasksView.jsx - Task Details
tools/task-viewer/src/components/TaskDetailView.jsx - Viewer Server
tools/task-viewer/server.js
Other components
- AI Client
- Task Viewer User
Connections 15
- AI Client → MCP Server: invokes tools
README.md - MCP Server → Task Tools: dispatches calls
src/index.ts - MCP Server → Research Mode: dispatches calls
src/index.ts - MCP Server → Project Rules: dispatches calls
src/index.ts - MCP Server → Thought Processing: dispatches calls
src/index.ts - Task Tools → Task Memory: reads and updates
src/tools/task/listTasks.ts - Task Tools → Prompt Templates: generates prompts
src/tools/task/listTasks.ts - Research Mode → Prompt Templates: generates prompts
src/tools/research/researchMode.ts - Task Tools → Agent Matching: matches agents
src/tools/task/splitTasks.ts - Agent Matching → Agent Definitions: loads definitions
src/utils/agentMatcher.ts - Task Memory → Data Paths: resolves storage paths
src/models/taskModel.ts - MCP Server → Lightweight Web GUI: starts optionally
src/index.ts - Task Viewer User → Task Viewer: manages tasks
README.md - Task Viewer → Task Table: renders
tools/task-viewer/src/App.jsx - History Tasks → Task Details: opens details
tools/task-viewer/src/components/HistoryTasksView.jsx