batch-runner-mcp

Run several bash steps in one MCP call, and know whether each one actually did what you wanted.

A zero exit code only proves a command ran. With omega_batch, every step can carry an expect assertion (contains / notContains / regex). Each step is reported as ok, FAIL (process) or FAIL (expectation), with exit code, signal, timeout and stderr kept separate. Steps skipped after a failure are listed as (halted) instead of silently disappearing.

Zero npm dependencies. Node >= 20. Works with any MCP host that speaks stdio (Claude Code, opencode, Claude Desktop, ...).

Install

Claude Code:

claude mcp add batch-runner -- npx -y github:Birdywen/batch-runner-mcp

Generic JSON config (mcpServers):

{ "batch-runner": { "command": "npx", "args": ["-y", "github:Birdywen/batch-runner-mcp"] } }

opencode (opencode.json, mcp section):

{ "batch-runner": { "type": "local", "command": ["npx", "-y", "github:Birdywen/batch-runner-mcp"] } }

Then call omega_health once. The first line is the verdict (HEALTHY / DEGRADED); optional parts that are not configured show as [--].

Related MCP server: Bash MCP Server

Example

{ "steps": [
  { "label": "build", "command_line": "npm run build", "expect": { "contains": ["compiled successfully"] } },
  { "label": "smoke", "command_line": "node dist/cli.js --version", "expect": { "regex": "^\\d+\\.\\d+" } }
], "stopOnError": true }

omega_batch returns a job id at once; omega_batch_status with waitMs (max 50000) blocks until the verdict is ready:

batch job-xxxx: partial 4/4
  [FAIL] 1. basic exit3 (process)
      exit=3 signal=none timedOut=false chars=34
      out-line
      --- stderr ---
      err-line
  [FAIL] 2. expect fail on exit0 (expectation) -- expect.contains failed: NOPE_MARK
  [ok] 3. long 30000
  [ok] 4. after

Add format: "json" for structured per-step fields (ok, status, failureType, exitCode, signal, timedOut, durationMs) and verbose: true for full output.

Tools

Configuration

Everything works with defaults under ~/.omega-mcp/. Common overrides:

Development

npm test