@hive-academy/mcp-workflow-manager NPM

MCP Workflow Manager

A comprehensive Model Context Protocol (MCP) server for AI workflow automation and task management. Built with NestJS, Prisma, and @rekog/mcp-nest for production-ready reliability.

✨ Key Features

🔄 Role-Based Workflow: Structured AI coordination (Boomerang, Researcher, Architect, Developer, Code Review)
📊 Task Management: Complete task lifecycle with status tracking and delegation
🎯 Implementation Planning: Batch-based subtask organization and execution
📈 Analytics & Reporting: Comprehensive workflow analytics and progress monitoring
🔒 Project Isolation: Automatic database separation for multi-project workflows
🚀 Zero Setup: Just add to MCP config - no manual installation required
📦 Self-Contained NPX Package: Automatic dependency management with no external requirements
🔧 Environment-Aware: Adapts behavior for NPX, global, and local installations

🚀 Quick Setup Guide

Streamlined Database Configuration ✨

Zero Configuration Required! Each project automatically gets its own isolated database:

project-a/data/workflow.db  ← Project A's data
project-b/data/workflow.db  ← Project B's data
project-c/data/workflow.db  ← Project C's data

NPX Setup (Recommended)

One command, automatic project isolation:

{
  "mcpServers": {
    "workflow-manager": {
      "command": "npx",
      "args": ["-y", "@hive-academy/mcp-workflow-manager"]
    }
  }
}

✅ Automatic project detection
✅ Database created in ./data/workflow.db
✅ Migrations applied safely
✅ Zero setup required

Docker Setup

Project isolation via volume mounts:

{
  "mcpServers": {
    "workflow-manager": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "D:/projects/your-project/data:/app/data",
        "hiveacademy/mcp-workflow-manager"
      ]
    }
  }
}

Replace D:/projects/your-project/ with your actual project path

✅ Instant startup (pre-deployed migrations)
✅ Project isolation via different volume mounts
✅ Consistent across platforms

How Project Isolation Works

NPX: Automatic detection

cd /path/to/project-a && npx @hive-academy/mcp-workflow-manager
# Database: /path/to/project-a/data/workflow.db

cd /path/to/project-b && npx @hive-academy/mcp-workflow-manager
# Database: /path/to/project-b/data/workflow.db

Docker: Volume mount isolation

# Project A
docker run -v "/path/to/project-a/data:/app/data" hiveacademy/mcp-workflow-manager

# Project B
docker run -v "/path/to/project-b/data:/app/data" hiveacademy/mcp-workflow-manager

🛠️ Available MCP Tools

Core Workflow Management

task_operations - Task lifecycle management (create, update, get, list)
planning_operations - Implementation planning and batch subtask management
workflow_operations - Role-based delegation and workflow transitions
review_operations - Code review and completion report management
research_operations - Research reports and communication management