MCP Server

MCP Task Orchestrator MCP Server

Name: MCP Task Orchestrator MCP Server
Author: io.github.jpicklyk

io.github.jpicklyk/task-orchestrator

Repository Registry

What is the MCP Task Orchestrator MCP server?

Server-enforced workflow discipline for AI agents: work items, dependency graphs, quality gates

How to install MCP Task Orchestrator

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

DATABASE_PATH
SQLite database file path (default: data/current-tasks.db)
USE_FLYWAY
Enable Flyway database migrations (default: true)
AGENT_CONFIG_DIR
Directory containing .taskorchestrator/config.yaml for workflow schemas (default: working dir)
MCP_TRANSPORT
Transport mode: stdio (default) or http
MCP_HTTP_PORT
HTTP port when using http transport (default: 3001)
LOG_LEVEL
Logging level: DEBUG, INFO, WARN, ERROR (default: INFO)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "task-orchestrator": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/jpicklyk/task-orchestrator:latest"
      ],
      "env": {
        "DATABASE_PATH": "<YOUR_DATABASE_PATH>",
        "USE_FLYWAY": "<YOUR_USE_FLYWAY>",
        "AGENT_CONFIG_DIR": "<YOUR_AGENT_CONFIG_DIR>",
        "MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
        "MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "task-orchestrator": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/jpicklyk/task-orchestrator:latest"
      ],
      "env": {
        "DATABASE_PATH": "<YOUR_DATABASE_PATH>",
        "USE_FLYWAY": "<YOUR_USE_FLYWAY>",
        "AGENT_CONFIG_DIR": "<YOUR_AGENT_CONFIG_DIR>",
        "MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
        "MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "task-orchestrator": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/jpicklyk/task-orchestrator:latest"
      ],
      "env": {
        "DATABASE_PATH": "<YOUR_DATABASE_PATH>",
        "USE_FLYWAY": "<YOUR_USE_FLYWAY>",
        "AGENT_CONFIG_DIR": "<YOUR_AGENT_CONFIG_DIR>",
        "MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
        "MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "task-orchestrator": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/jpicklyk/task-orchestrator:latest"
      ],
      "env": {
        "DATABASE_PATH": "<YOUR_DATABASE_PATH>",
        "USE_FLYWAY": "<YOUR_USE_FLYWAY>",
        "AGENT_CONFIG_DIR": "<YOUR_AGENT_CONFIG_DIR>",
        "MCP_TRANSPORT": "<YOUR_MCP_TRANSPORT>",
        "MCP_HTTP_PORT": "<YOUR_MCP_HTTP_PORT>",
        "LOG_LEVEL": "<YOUR_LOG_LEVEL>"
      }
    }
  }
}

Claude Code

claude mcp add task-orchestrator --env DATABASE_PATH=<YOUR_DATABASE_PATH> --env USE_FLYWAY=<YOUR_USE_FLYWAY> --env AGENT_CONFIG_DIR=<YOUR_AGENT_CONFIG_DIR> --env MCP_TRANSPORT=<YOUR_MCP_TRANSPORT> --env MCP_HTTP_PORT=<YOUR_MCP_HTTP_PORT> --env LOG_LEVEL=<YOUR_LOG_LEVEL> -- docker run -i --rm ghcr.io/jpicklyk/task-orchestrator:latest