TaskTracker MCP Server

A DAG-based task tracking server for bug analysis and investigation workflows, built as a Model Context Protocol (MCP) server.

Features

• DAG-based task dependencies — declare dependencies for structured investigation workflows
• Circular dependency detection — automatic validation prevents invalid chains
• Priority-based execution — tasks sorted by high/medium/low priority
• Atomic bulk operations — add entire investigation plans in one call
• Rich status tracking — pending → in_progress → completed / skipped / blocked
• Evidence-based resolution — every resolved task requires a finding
• Analysis gate — conclude_analysis() blocks until all tasks are resolved

Installation

Option 1 — npx (no install needed)

npx tasktracker-mcp

Option 2 — Global install

npm install -g tasktracker-mcp
tasktracker-mcp

Option 3 — From source

git clone https://github.com/letscodekrkumar/tasktracker-mcp.git
cd tasktracker-mcp
npm install
npm run build
npm start

MCP Server Configuration

Claude Desktop

Edit claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Using npx (recommended):

{
  "mcpServers": {
    "tasktracker": {
      "command": "npx",
      "args": ["tasktracker-mcp"]
    }
  }
}

Using global install:

{
  "mcpServers": {
    "tasktracker": {
      "command": "tasktracker-mcp"
    }
  }
}

Using local source build:

{
  "mcpServers": {
    "tasktracker": {
      "command": "node",
      "args": ["/absolute/path/to/tasktracker-mcp/dist/index.js"]
    }
  }
}

Claude Code (CLI)

claude mcp add tasktracker npx tasktracker-mcp

Or with a local build:

claude mcp add tasktracker node /absolute/path/to/tasktracker-mcp/dist/index.js

Verify it connected:

claude mcp list
# tasktracker: npx tasktracker-mcp - ✓ Connected

Other MCP Clients

Any client that supports the MCP stdio transport can use:

{
  "command": "npx",
  "args": ["tasktracker-mcp"]
}

Tools

| Tool | Purpose | |------|---------| | add_task | Register a single task with optional dependencies | | add_tasks_bulk | Register an entire investigation DAG atomically | | update_task | Resolve task with evidence, update status, or rewire deps | | get_ready_tasks | Get all executable tasks (deps resolved), priority-sorted | | get_all_tasks | Full DAG snapshot with statuses, findings, and dependency state | | conclude_analysis | Gate that blocks until all tasks resolved; returns summary | | reopen_task | Reopen a blocked task when its blocker is resolved | | reset | Clear all tasks and start fresh |

Quick Start

# 1. Define your investigation DAG
add_tasks_bulk([
    {"title": "Fetch bug fields", "category": "log_check", "priority": "high"},
    {"title": "Extract machine ID", "category": "log_check", "priority": "high"},
    {"title": "Fetch run.log — search for TIMEOUT errors", "category": "log_check", "priority": "high", "depends_on": ["T2"]},
    {"title": "Identify root cause", "category": "root_cause", "priority": "high", "depends_on": ["T1", "T2", "T3"]}
])

# 2. Execute ready tasks
tasks = get_ready_tasks()  # returns T1, T2

# 3. Resolve tasks as you go
update_task("T1", status="completed", finding="Bug filed 2026-03-28. Build: 4.2.1-rc3.")
update_task("T2", status="completed", finding="Machine ID: X200-lot-7.")

# 4. T3 is now unblocked
update_task("T3", status="completed", finding="3 TIMEOUT errors at 14:22:01")

# 5. Conclude when all done
conclude_analysis()

Task Status Transitions

| Transition | Allowed | Notes | |------------|---------|-------| | pending → in_progress | Yes | No dependency check | | pending/in_progress → completed | Yes | All deps must be resolved; finding required | | pending/in_progress → skipped | Yes | Finding required | | pending/in_progress → blocked | Yes | Finding required | | completed / skipped → any | No | Permanently resolved | | blocked → any | No | Use reopen_task() to reopen |

Development

npm test              # run tests
npm run test:coverage # with coverage report
npm run build         # compile TypeScript
npm run dev           # build + run
npm run benchmark     # performance benchmarks

Project Structure

src/
  index.ts      # MCP server entry point
  tracker.ts    # DAG engine (task state, dependency resolution)
  types.ts      # TypeScript interfaces and validators
  monitor.ts    # Progress monitoring
  examples.ts   # Usage examples
  benchmark.ts  # Performance benchmarks
  __tests__/    # Test suite
docs/           # Design docs, deployment guide, specs

License

MIT — see LICENSE