omp-worker-mcp

非同期コーディングタスクとDAGワークフローをローカルのOh My Pi (OMP) CLIサブエージェントに委任するための永続的なModel Context Protocol (MCP)サーバー。

クイックスタート • 設定 • 利用可能なツール • 安全性と所有権の契約 • アップストリームの帰属と免責事項

主なハイライト

• ⚡ 非同期委任実行: メインの会話セッションをブロックすることなく、重いコーディング、リファクタリング、探索タスクをバックグラウンドのOMPワーカーインスタンスにオフロードします。

• 🔀 トポロジカルDAGオーケストレーション: 自動トポロジカルソート、並行性制御、依存関係の伝播を備えた、相互依存するバッチタスクを実行します。

• 🛡️ ワークスペースパス分離: 明示的な書き込みパスの境界を強制し、並行タスク間でのファイル変更の重複を防ぎます。

• 🔍 監視付き再開とエンベロープ: 中間ログをリアルタイムで検査し、構造化されたJSON結果エンベロープを抽出し、タスクを再試行または調整するための監視ガイダンスを提供します。

アップストリームの帰属と免責事項

• 外部アップストリーム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クライアントで直接設定）で管理します。

クロスプラットフォーム環境の例

Windows (cmd / PowerShell)

set OMP_WORKER_OMP_COMMAND=omp
set OMP_WORKER_STATE_DIR=C:\Users\YourUser\.codex\state\omp-worker

macOS / Linux (bash / zsh)

export OMP_WORKER_OMP_COMMAND=/usr/local/bin/omp
export OMP_WORKER_STATE_DIR=/home/youruser/.codex/state/omp-worker

Codex 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ツール

タスクの安全性と所有権の契約

1. 書き込みと読み取り専用の分離:

   • write タスクは、所有する具体的なファイルパスを宣言する必要があります。

   • read_only タスクは、ワークスペースの変更を厳密に禁止されています。

2. DAGの重複検証:

   • 並行して実行されるタスクは、重複する書き込み境界を宣言できません。

   • 共有パスを変更するタスクは、明示的な線形DAG依存関係（depends_on）を宣言する必要があります。

3. 構造化検証の契約:

   • 完了した各サブタスクは、構造化された検証の詳細と更新された成果物の説明を返すことが期待されます。

ライセンス

このプロジェクトはMIT Licenseの下でライセンスされています。