omp-worker-mcp

持久化模型上下文协议（MCP）服务器，用于将异步编码任务和 DAG 工作流委托给本地 Oh My Pi（OMP）CLI 子代理。

快速开始 • 配置 • 可用工具 • 安全契约 • 上游归属与免责声明

核心亮点

• ⚡ 异步委托执行：将繁重的编码、重构和探索任务卸载到后台 OMP worker 实例，而不会阻塞您的主对话会话。

• 🔀 拓扑 DAG 编排：通过自动拓扑排序、并发控制和依赖传播来执行相互依赖的批量任务。

• 🛡️ 工作区路径隔离：强制执行显式写入路径边界，防止并发任务之间重叠的文件修改。

• 🔍 监督恢复与信封：实时检查中间日志，提取结构化 JSON 结果信封，并提供监督指导以重试或调整任务。

上游归属与免责声明

• 外部上游 CLI：本项目与 Oh My Pi (OMP) 交互，后者是根据 MIT License 发布的开源工具。

• 用户先决条件：

  • 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 许可。