Workflow MCP MCP Server

Name: Workflow MCP MCP Server
Author: io.github.Juliusolsson05

io.github.Juliusolsson05/workflow-mcp

Repository Registry

What is the Workflow MCP MCP server?

Session-bound Docker workflow server through Codex. State is discarded with the container.

How to install Workflow MCP

Copy-paste configuration for popular MCP clients.

transport: stdio

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

Environment / auth

OPENAI_API_KEY
required
secret
OpenAI API key used only by the contained Codex provider.
WORKFLOW_MCP_CONCURRENCY
Constrained session profile; the Docker-first daemon bundle provides the larger durable profile.

Claude Desktop

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

{
  "mcpServers": {
    "workflow-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/juliusolsson/workflow-mcp@sha256:4b6889f9e78d0208e6d1d343ba23d0c5d092b1a1513a73c9c85deb2d00ab5855",
        "--read-only",
        "true",
        "--user",
        "10001:10001",
        "--cap-drop",
        "ALL",
        "--security-opt",
        "no-new-privileges:true",
        "--security-opt",
        "seccomp=unconfined",
        "--security-opt",
        "apparmor=unconfined",
        "--pids-limit",
        "256",
        "--memory",
        "2g",
        "--cpus",
        "1",
        "--tmpfs",
        "/tmp:size=256m,mode=1777,uid=10001,gid=10001",
        "--tmpfs",
        "/run/workflow-mcp:size=16m,mode=0700,uid=10001,gid=10001",
        "--mount",
        "type=volume,target=/data",
        "--mount",
        "type=bind,source={project},target=/workspace,readonly"
      ],
      "env": {
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "WORKFLOW_MCP_CONCURRENCY": "<YOUR_WORKFLOW_MCP_CONCURRENCY>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "workflow-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/juliusolsson/workflow-mcp@sha256:4b6889f9e78d0208e6d1d343ba23d0c5d092b1a1513a73c9c85deb2d00ab5855",
        "--read-only",
        "true",
        "--user",
        "10001:10001",
        "--cap-drop",
        "ALL",
        "--security-opt",
        "no-new-privileges:true",
        "--security-opt",
        "seccomp=unconfined",
        "--security-opt",
        "apparmor=unconfined",
        "--pids-limit",
        "256",
        "--memory",
        "2g",
        "--cpus",
        "1",
        "--tmpfs",
        "/tmp:size=256m,mode=1777,uid=10001,gid=10001",
        "--tmpfs",
        "/run/workflow-mcp:size=16m,mode=0700,uid=10001,gid=10001",
        "--mount",
        "type=volume,target=/data",
        "--mount",
        "type=bind,source={project},target=/workspace,readonly"
      ],
      "env": {
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "WORKFLOW_MCP_CONCURRENCY": "<YOUR_WORKFLOW_MCP_CONCURRENCY>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "workflow-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/juliusolsson/workflow-mcp@sha256:4b6889f9e78d0208e6d1d343ba23d0c5d092b1a1513a73c9c85deb2d00ab5855",
        "--read-only",
        "true",
        "--user",
        "10001:10001",
        "--cap-drop",
        "ALL",
        "--security-opt",
        "no-new-privileges:true",
        "--security-opt",
        "seccomp=unconfined",
        "--security-opt",
        "apparmor=unconfined",
        "--pids-limit",
        "256",
        "--memory",
        "2g",
        "--cpus",
        "1",
        "--tmpfs",
        "/tmp:size=256m,mode=1777,uid=10001,gid=10001",
        "--tmpfs",
        "/run/workflow-mcp:size=16m,mode=0700,uid=10001,gid=10001",
        "--mount",
        "type=volume,target=/data",
        "--mount",
        "type=bind,source={project},target=/workspace,readonly"
      ],
      "env": {
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "WORKFLOW_MCP_CONCURRENCY": "<YOUR_WORKFLOW_MCP_CONCURRENCY>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "workflow-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/juliusolsson/workflow-mcp@sha256:4b6889f9e78d0208e6d1d343ba23d0c5d092b1a1513a73c9c85deb2d00ab5855",
        "--read-only",
        "true",
        "--user",
        "10001:10001",
        "--cap-drop",
        "ALL",
        "--security-opt",
        "no-new-privileges:true",
        "--security-opt",
        "seccomp=unconfined",
        "--security-opt",
        "apparmor=unconfined",
        "--pids-limit",
        "256",
        "--memory",
        "2g",
        "--cpus",
        "1",
        "--tmpfs",
        "/tmp:size=256m,mode=1777,uid=10001,gid=10001",
        "--tmpfs",
        "/run/workflow-mcp:size=16m,mode=0700,uid=10001,gid=10001",
        "--mount",
        "type=volume,target=/data",
        "--mount",
        "type=bind,source={project},target=/workspace,readonly"
      ],
      "env": {
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "WORKFLOW_MCP_CONCURRENCY": "<YOUR_WORKFLOW_MCP_CONCURRENCY>"
      }
    }
  }
}

Claude Code

claude mcp add workflow-mcp --env OPENAI_API_KEY=<YOUR_OPENAI_API_KEY> --env WORKFLOW_MCP_CONCURRENCY=<YOUR_WORKFLOW_MCP_CONCURRENCY> -- docker run -i --rm docker.io/juliusolsson/workflow-mcp@sha256:4b6889f9e78d0208e6d1d343ba23d0c5d092b1a1513a73c9c85deb2d00ab5855 --read-only true --user 10001:10001 --cap-drop ALL --security-opt no-new-privileges:true --security-opt seccomp=unconfined --security-opt apparmor=unconfined --pids-limit 256 --memory 2g --cpus 1 --tmpfs /tmp:size=256m,mode=1777,uid=10001,gid=10001 --tmpfs /run/workflow-mcp:size=16m,mode=0700,uid=10001,gid=10001 --mount type=volume,target=/data --mount type=bind,source={project},target=/workspace,readonly