omp-worker-mcp server
io.github.divenire990/omp-worker-mcp·v0.2.1·3 starsHand off coding tasks from ChatGPT, Codex or Claude Code to local Oh My Pi (OMP) workers.
3 stars539 downloads/wk
Reviews
Write oneNobody has reviewed omp-worker-mcp yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
omp-worker-mcp tools (9, 4 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
omp_cancelwrite actionRequest immediate cancellation of one exact delegated OMP job. The detached runner owns the OMP child PID and terminates that process tree safely. Call this immediately when the user asks to stop; do not inspect PIDs or manually kill processes first.
omp_cancel_groupwrite actionRequest immediate cancellation of a running batch task group and its child tasks. Writes a cancellation request that the detached group coordinator handles safely. Call this immediately when the user asks to stop a batch.
omp_continueResume the same OMP session with targeted supervisory feedback to correct specific acceptance defects without starting a fresh task from scratch. Bounded to remaining attempts within max_attempts.
omp_delegateLow-level background delegation entrypoint. Transfers ownership of an execution task to OMP and returns immediately with job_id. Prefer omp_run_compact for standard workflows to avoid separate delegate/wait round trips.
omp_resultRetrieve full details of a terminal OMP job, including finalResponse and attempt logs. Call this only when minimal acceptance check fails, high-risk operations occurred, or the user explicitly asks for full inspection; do not call this after every successful compact run.
omp_run_batch_compactwrite actionSubmits a decomposed group of OMP tasks to execute concurrently in the server-side bounded rolling pool (max_parallel 1-10) using a detached group runner. Enforces dependency DAG and write-ownership safety, waits up to wait_seconds (0-240, default 60s) for batch completion, and returns stable compact aggregated results. If still running when deadline elapses, returns group_id and minimal progress
omp_run_compactwrite actionPreferred entrypoint for single substantive execution tasks. Creates a delegated OMP task, launches the detached runner, and waits up to wait_seconds (default 60s) for completion in a single MCP call. If finished, returns a compact summary, artifacts, verification, and details_path without dumping the full final response. If still running at the deadline, returns job_id and status running for subs
omp_waitWait for an existing OMP job to reach a terminal status, polling up to wait_seconds (default 30s, max 60s). Returns the current status and summary once terminal or when the wait deadline elapses. Avoid polling in a tight loop.
omp_wait_groupWait for an existing OMP task group to reach a terminal status, polling up to wait_seconds (0-240, default 60s). If completed, returns full aggregated compact results in original input order. If still running when deadline elapses, returns minimal progress counts without leaking task summaries.
Public scan report
scanner v0.1.10 · 2026-10-31 · same rubric, same numbers if you re-run it
- Code scan12 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 7 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How omp-worker-mcp compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 92/100
- higher than 95% of 48,255 servers
- Tools
- 9
- the typical server has 7
- Tools that change things
- 44%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 3
- more than 80% of 28,688 servers
- Downloads a week
- 539
- more than 89% of 12,191 servers with a package
What its tools let an agent do: 5 read · 4 change
Release history: 3 versions in the registry since 2026-08-27, latest 2026-10-24, typically one every 57 days.
Install omp-worker-mcp in Claude Code, Cursor or VS Code
Runs npx -y omp-worker-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add omp-worker-mcp -- npx -y omp-worker-mcp
What the publisher says
From the omp-worker-mcp repository's README, as published. We do not edit it. Read it on GitHub
omp-worker-mcp
Durable Model Context Protocol (MCP) server for delegating background coding tasks and DAG workflows to local Oh My Pi (OMP) CLI sub-agents.
English • 简体中文 • Documentation Hub
Asynchronous task execution, DAG dependency resolution, path ownership isolation, and structured result verification.
Quick Start • Entrypoints • Safety Contract • Platform Support • Docs Hub
Value & Operating Model
omp-worker-mcp implements an outcome-led Supervisor-Worker pattern that decouples high-level planning from concrete implementation:
- Main Agent Remains in Control: The primary host harness (e.g., Codex, Claude Code) retains full authority over architecture, task decomposition, trade-off decisions, and final acceptance review.
- Durable Local Background Execution: Concrete, long-running coding, refactoring, and exploratory tasks are offloaded to local OMP worker processes running in the background without blocking conversational turns.
- Topological DAG Orchestration: Independent work units can be orchestrated as a directed acyclic graph (DAG) with automated dependency resolution, concurrency limits, and failure containment.
- Explicit Path Ownership Boundaries: Write tasks must declare explicit write-path ownership. The server validates and rejects overlapping concurrent write scopes in batch DAGs, supplying declared boundaries as worker constraints to prevent write collisions.
- Structured Results & Supervised Resumption: Workers report deliverables via the structured OMPWORKERRESULT envelope (status, summary, artifacts, verification checks, remaining items). Supervisors can inspect logs in real time and inject corrective guidance via omp_continue to retry within the same session.
Installation & Quick Start
1. Install OMP
Install Oh My Pi (OMP) from its official project. (Note: running omp-worker-mcp requires local Node.js >= 22.0.0.)
2. Verify OMP Reachability
Verify that the OMP CLI is reachable in your environment:
omp --versionTroubleshooting: If omp is not on your PATH, set OMPWORKEROMPCOMMAND to its executable path in your MCP configuration.*
3. Configure OMP & Default Worker Model
Run omp setup in your terminal to authenticate, configure your local OMP environment, and select your default worker model. This default model is what background OMP workers use during task execution.
(Optional advanced configuration): You can specify your default model via modelRoles.default: / in ~/.omp/agent/config.yml. For upstream configuration options, see Oh My Pi.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
omp-worker-mcp: common questions
- Is omp-worker-mcp server safe?
- Yes, by our scan: it is graded A (92/100). Read the omp-worker-mcp safety report
- How do I install omp-worker-mcp?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does omp-worker-mcp need an API key?
- No secret keys are declared. It reads 2 settings from the environment.
- Is omp-worker-mcp maintained?
- The last commit was 11 days ago (2026-10-24). The latest release is v0.2.1.
- What can I use instead of omp-worker-mcp?
- Servers from other publishers that do the same job: Claudexor MCP server.
- How does omp-worker-mcp compare with other MCP servers?
- safety score 92/100 (higher than 95% of 48,255 servers); tools 9 (the typical server has 7); tools that change things 44% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to omp-worker-mcp
Same job from other publishers: the closest match first, then the best rated.
- ClaudexorRoute coding work across Claude Code, Codex, Cursor, and OpenCode with shared context.not reviewedEstablishedA