omp-worker-mcp
omp-worker-mcp
非同期コーディングタスクとDAGワークフローをローカルのOh My Pi (OMP) CLIサブエージェントに委任するための永続的なModel Context Protocol (MCP)サーバー。
クイックスタート • 設定 • 利用可能なツール • 安全性と所有権の契約 • アップストリームの帰属と免責事項
主なハイライト
⚡ 非同期委任実行: メインの会話セッションをブロックすることなく、重いコーディング、リファクタリング、探索タスクをバックグラウンドのOMPワーカーインスタンスにオフロードします。
🔀 トポロジカルDAGオーケストレーション: 自動トポロジカルソート、並行性制御、依存関係の伝播を備えた、相互依存するバッチタスクを実行します。
🛡️ ワークスペースパス分離: 明示的な書き込みパスの境界を強制し、並行タスク間でのファイル変更の重複を防ぎます。
🔍 監視付き再開とエンベロープ: 中間ログをリアルタイムで検査し、構造化されたJSON結果エンベロープを抽出し、タスクを再試行または調整するための監視ガイダンスを提供します。
Related MCP server: claude-orchestrator
アップストリームの帰属と免責事項
外部アップストリームCLI: このプロジェクトはMIT Licenseの下でリリースされているオープンソースツールであるOh My Pi (OMP)と連携します。
ユーザーの前提条件:
Node.js >= 22.0.0。
ユーザーはローカルのOMP CLIインスタンスを自分でインストールおよび設定する必要があります。
ユーザーは、自分の環境に適用されるOMP CLIライセンスと利用規約を遵守する責任があります。
機能
非同期委任実行: メインの会話セッションをブロックすることなく、独立したサブエージェントのコーディングタスクを起動します。
DAGおよびバッチオーケストレーション: トポロジカル依存関係のソート、並行性制限、自動依存関係の伝播を備えた、相互依存するバッチタスクを実行します。
厳格なタスクの安全性と所有権: 組み込みの検証チェックにより、複数の並行タスクが重複するファイルパスに書き込んだり、同じワークスペース内で衝突したりするのを防ぎます。
継続的な監視とフィードバック: 中間出力の検査、ログのストリーミング、構造化されたJSONエンベロープの取得、継続または再試行のための監視フィードバックの提供を行います。
クロスプラットフォーム設計: Windows、macOS、Linux上のローカルNode.js環境向けに設計されています。お使いのプラットフォームでOMP CLIが利用可能かどうかを検証してください。
インストールとクイックスタート
# 1. Clone the repository
git clone https://github.com/divenire990/omp-worker-mcp.git
cd omp-worker-mcp
# 2. Install dependencies
npm ci
# 3. Build TypeScript to dist/
npm run build
# 4. Run test suite
npm test設定
設定は環境変数(またはMCPクライアントで直接設定)で管理します。
変数 | 説明 | デフォルト |
| OMP CLIバイナリのパスまたは実行可能ファイル名。 |
|
| OMP CLI呼び出しの前に付加される引数のJSON配列。 |
|
| ジョブ状態、試行、ログ、および成果物を保存するディレクトリ。 |
|
| タスクプロンプトに注入されるオプションのカスタムブラウザ自動化指示。 | (なし) |
クロスプラットフォーム環境の例
Windows (cmd / PowerShell)
set OMP_WORKER_OMP_COMMAND=omp
set OMP_WORKER_STATE_DIR=C:\Users\YourUser\.codex\state\omp-workermacOS / Linux (bash / zsh)
export OMP_WORKER_OMP_COMMAND=/usr/local/bin/omp
export OMP_WORKER_STATE_DIR=/home/youruser/.codex/state/omp-workerCodex MCPクライアント設定例
Codex MCP設定(例: config.toml)にサーバーを追加します。
Windowsの例
[mcp_servers.omp-worker]
command = "node"
args = ["C:/path/to/omp-worker-mcp/dist/index.js"]
[mcp_servers.omp-worker.env]
OMP_WORKER_OMP_COMMAND = "omp"
OMP_WORKER_STATE_DIR = "C:/Users/YourUser/.codex/state/omp-worker"macOS / Linuxの例
[mcp_servers.omp-worker]
command = "node"
args = ["/path/to/omp-worker-mcp/dist/index.js"]
[mcp_servers.omp-worker.env]
OMP_WORKER_OMP_COMMAND = "/usr/local/bin/omp"
OMP_WORKER_STATE_DIR = "/home/youruser/.codex/state/omp-worker"利用可能なMCPツール
ツール | 目的 |
| 便利なツール: 単一のタスクを委任し、 |
| コーディングタスク用の非同期バックグラウンドワーカーを起動し、即座に |
| 実行中のバックグラウンドジョブが終了するまで待機するか、タイムアウトに達するまでポーリングします。 |
| ジョブの全試行履歴、ログ、出力、および解析された構造化エンベロープを取得します。 |
| 失敗またはブロックされたジョブに監視による修正/ガイダンスを送り、新しい試行を行います。 |
| 実行中のジョブとその子プロセスのツリーを正常に終了します。 |
| 並行/逐次のバッチタスクの依存関係グラフ(DAG)を起動し、完了を待ちます。 |
| 非同期バッチタスクグループの進行または完了を待ちます。 |
| バッチグループ内の実行中およびキュー内のすべてのタスクをキャンセルします。 |
タスクの安全性と所有権の契約
書き込みと読み取り専用の分離:
writeタスクは、所有する具体的なファイルパスを宣言する必要があります。read_onlyタスクは、ワークスペースの変更を厳密に禁止されています。
DAGの重複検証:
並行して実行されるタスクは、重複する書き込み境界を宣言できません。
共有パスを変更するタスクは、明示的な線形DAG依存関係(
depends_on)を宣言する必要があります。
構造化検証の契約:
完了した各サブタスクは、構造化された検証の詳細と更新された成果物の説明を返すことが期待されます。
ライセンス
このプロジェクトはMIT Licenseの下でライセンスされています。
Available Tools
9 toolsomp_cancelStop OMP TaskADestructiveIdempotent
Request 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.
Inputs: job_id (required), reason. Returns: error, job_id, status, attempt, +7 more
omp_cancel_groupCancel Batch Task GroupADestructiveIdempotent
Request 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.
Inputs: group_id (required), reason. Returns: tasks, status, summary, group_id, +6 more
omp_continueSend Supervisory Feedback to Same OMP SessionADestructive
Resume 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.
Inputs: job_id (required), feedback (required), timeout_minutes. Returns: error, job_id, status, attempt, +7 more
omp_delegateDelegate Complete Task to OMP (Low-level)ADestructive
Low-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.
Inputs: cwd (required), goal (required), acceptance, max_attempts, +2 more. Returns: error, job_id, status, attempt, +7 more
omp_resultInspect Complete OMP Task ResultARead-onlyIdempotent
Retrieve 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.
Inputs: job_id (required). Returns: cwd, goal, error, job_id, +11 more
omp_run_batch_compactRun Batch OMP Tasks with DAG and Compact Aggregated Result (Preferred for Multi-task)ADestructive
Submits 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 counts for subsequent omp_wait_group.
Inputs: cwd (required), tasks (required), max_parallel, wait_seconds, +4 more. Returns: tasks, status, summary, group_id, +6 more
omp_run_compactRun OMP Task with Compact Result (Preferred for Single Task)ADestructive
Preferred 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 subsequent omp_wait.
Inputs: cwd (required), goal (required), acceptance, max_attempts, +3 more. Returns: error, job_id, status, attempt, +7 more
omp_waitWait for OMP TaskARead-onlyIdempotent
Wait 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.
Inputs: job_id (required), wait_seconds. Returns: error, job_id, status, attempt, +7 more
omp_wait_groupWait for Batch Task GroupARead-onlyIdempotent
Wait 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.
Inputs: group_id (required), wait_seconds. Returns: tasks, status, summary, group_id, +6 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool has a clearly distinct purpose: batch vs single, delegate vs wait vs cancel vs result retrieval vs continue. No two tools overlap in function—omp_run_compact and omp_delegate differ by synchronous vs asynchronous, and omp_wait_group vs omp_wait serve batch vs single jobs.
All tools follow a consistent `omp_<verb>[_<noun>]` pattern where the verb describes the action (run, wait, cancel, result, continue) and optional noun specifies the target (batch, group, compact). Perfectly predictable and uniform.
9 tools precisely cover the lifecycle of both single and batch task execution: submission, waiting, cancellation, result retrieval, and continuation. No tool is superfluous, and the count is tight for the complexity of the domain.
The tool surface covers every stage of task management: submission (run/delegate), monitoring (wait), cancellation (cancel), post-hoc inspection (result), and iterative correction (continue). No obvious gaps—both single and batch workflows are fully supported.
Maintenance
Related MCP Connectors
- aXDeprecatedio.github.ax-platform
Agent-native collaboration network: orchestrate a team of long-running agents from any MCP client.
Task manager for AI agents. Orchestrate agents to achieve large goals in unified control plane.
AI work orchestration for plans, tasks, teams, and coding-agent dispatch.
Design, build and run teams of AI agents with checked handoffs between them.
Related MCP Servers
- AlicenseAqualityAmaintenanceEnables orchestrating external AI-agent CLIs like Codex to execute project development tasks through an async task system with objective verification and automated failure rework loops.8182 npm11Apache 2.0
- AlicenseAqualityBmaintenanceEnables Cursor's main agent to delegate development tasks to Claude CLI subagents via MCP, supporting synchronous, asynchronous, and parallel task execution with monitoring and control.7ISC
- AlicenseCqualityBmaintenanceEnables multiple CLI-based AI agents to collaborate as a coordinated team through shared task queues, shared memory, and a message bus, with DAG orchestration, rate-limit avoidance, parallel dispatching, and long-task management.633MIT
- FlicenseNot gradedqualityAmaintenanceEnables a primary AI assistant to delegate tasks in parallel to specialized local CLI-based AI sub-agents, share project context, and synthesize their responses through a single MCP interface.-