omp-worker-mcp

English · 简体中文

最高級モデルの割り当てを雑務で消費するのはやめましょう。

Claude Code、Codex、Grok Build、Kimi Code、その他のMCPクライアントに、検索、クリーンアップ、バッチ処理、広範囲のリポジトリスキャンを、OMPで設定済みの小規模モデルに任せられます。

作った理由

私は普段、複数のコーディングエージェントを同時に開いています。Codexを1つのウィンドウに、Grok BuildやKimi Codeを別のウィンドウに、そしてOMPを近くに置いています。OMPに組み込まれているプランのいくつかは、料金に見合った十分なモデル利用時間を提供してくれます。リポジトリスキャン、一次レビュー、トークンを大量に消費する反復作業に最適です。

毎日使うツールのプランは小規模です。割り当てが逼迫してきたとき、私が最も避けたいのは、引き継ぎドキュメントをもう1つ作ることや、ターミナルウィンドウ間でプロンプトをコピーする作業です。すでに会話しているエージェントが、ジョブを送信して結果を持ち帰れるべきです。

そこで、このMCPサーバーを構築しました。メインのエージェントがコンテキストを保持し、意思決定を行います。OMPが境界のあるバックグラウンド作業を処理します。Claude Code、Codex、Grok Build、Kimi Code、OpenCode、Cursor、その他のMCPクライアントはすべて、同じOMPロールとタスクエージェントを共有できます。

Related MCP server: todos

エージェントが得られるもの

ほとんどのジョブは2つのツールだけで済みます:

• run はOMPワーカーを起動し、ジョブIDを返します。

• wait は1つまたは複数の結果を収集します。

エージェントは複数の独立したジョブを開始し、作業を続け、その後まとめて結果を収集できます。status、list、cancel、agents、roles が残りをカバーします。

各ワーカーには agent と role があります。agentはタスクへのアプローチ方法を説明します（例: scout や reviewer）。roleはOMP設定内のモデルマッピングの1つを選択します（例: task、slow、designer）。両方を省略した場合、サーバーは task を使用します。

セットアップ

Node.js 22以降と、インストール済みで認証済みの Oh My Pi が必要です。

git clone https://github.com/elijah7x/omp-worker-mcp.git
cd omp-worker-mcp
node src/server.js --self-check
npm run check

次に、プロジェクトにクライアント用の設定スニペットを出力してもらいます:

node scripts/client-config.js claude
node scripts/client-config.js codex
node scripts/client-config.js opencode
node scripts/client-config.js standard-json

スクリプトは設定を出力し、ファイルには触れません。クライアント設定 には、テスト済みクライアント、その設定場所、汎用stdio形式が記載されています。MCPサーバー名には omp を使用してください。

接続後に実際のディスパッチをテストするには:

npm run check:worker

有用な作業を任せる

OMPワーカーは、タスクに明確な境界があり、最終判断ではなく結果を返せる場合に最も有用です。いくつかの例:

• リポジトリを検索し、1つのサブシステムの仕組みを説明する。

• モジュールをバグやセキュリティ問題についてレビューする。

• テストスイートを実行し、失敗を調査して、考えられる原因を報告する。

• 複数のファイルを比較するか、一次実装のドラフトを作成する。

独立したジョブをまとめて開始してください。最終的な編集、製品判断、ユーザーへの回答は親エージェントに残します。

スキルまたはルールをサポートするクライアントは SKILL.md をインストールできます。その他のクライアントはMCPツールの説明から作業できます。

run 呼び出しは次のようになります:

{
  "prompt": "Review the authentication module for concrete security issues. Return findings with file paths and line numbers.",
  "cwd": "/path/to/project",
  "agent": "reviewer",
  "role": "slow"
}

ワーカーはOMPの非対話型プリントモードで実行されます。すでに開いているOMP TUIウィンドウを乗っ取ることはありません。

独自のモデルとエージェントを使用する

ブリッジは2つ目のモデルレジストリを保持しません。プロバイダー設定と認証がすでにあるOMPでモデルを追加または変更してください。

たとえば、~/.omp/agent/config.yml のブロック形式の modelRoles マップにロールを追加します:

modelRoles:
  task: your-provider/fast-model
  slow: your-provider/reasoning-model
  designer: your-provider/vision-model

MCPクライアントを再起動して roles を呼び出します。新しい名前は run.role としてすぐに使用できます。サーバーのコード変更は不要です。

カスタムOMPタスクエージェントも同様に機能します。OMPのエージェントディレクトリに追加し、クライアントを再起動して agents を呼び出し、その名前を run.agent として使用します。

別のMCPクライアントを接続する

サーバーはローカルstdio MCPを使用します。ほとんどのクライアントでは、コマンドは次のとおりです:

node /absolute/path/to/omp-worker-mcp/src/server.js

node scripts/client-config.js standard-json で開始点が得られます。クライアントが異なる設定形式を期待する場合は、scripts/client-config.js に小さなレンダラーを追加し、examples/ にクリーンな例を追加し、クライアント設定 に行を追加してください。サーバーに触れる必要はありません。

アクセスとプライバシー

このプロジェクトは、信頼できるシングルユーザーマシンを想定しています。OMPワーカーは、ローカルユーザーと同じファイルおよびコマンド権限で無人実行されます。

すべての run 呼び出しは、既存の絶対パス cwd を渡す必要があるため、ワーカーがMCPクライアントの起動ディレクトリに迷い込むことはありません。ホームフォルダー内のプロジェクト、外部ボリューム、クライアントのワークツリーはすべて追加設定なしで機能します。ジョブを特定のルートに制限したい場合は OMP_WORKER_ALLOWED_ROOTS を設定してください。これはオプションの許可リストであり、サンドボックスではありません。

プライベートなOMPスキルとルールは、呼び出しで有効にしない限りオフのままです。サーバーはワーカーに少数の環境変数を渡し、モデルマッピングとローカルエージェントのパスをデフォルトで非表示にします。

プロンプトと結果は ~/.omp/omp-worker-mcp/jobs/ の下に残ります。ソースコードが含まれる場合があります。ローカルユーザーのアクセスがプロジェクトにとって広すぎる場合は、コンテナ、OSサンドボックス、または制限付きアカウントを使用してください。クライアント設定 には、環境と認証情報の動作が記載されています。

開発

npm run check

テストスイートは、設定解析、生成されたクライアント設定、サポートされている両方のMCPフレーミングスタイル、ジョブライフサイクル、モック化されたOMPプロセスをカバーしています。npm run check:worker はライブのOMPディスパッチを追加します。

現在のリリースは、ローカルstdio、分離ジョブ、ロールとエージェントの検出、キャンセル、保存された結果をサポートしています。トークンストリーミング、リモートトランスポート、ライブTUI制御、自動ジョブクリーンアップは現在のスコープ外です。

ライセンス

MIT