omp-worker-mcp 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +174 -263
- package/README.zh-CN.md +174 -260
- package/package.json +4 -1
- package/server.json +43 -0
package/README.md
CHANGED
|
@@ -1,263 +1,174 @@
|
|
|
1
|
-
<div align="center">
|
|
2
|
-
|
|
3
|
-
# omp-worker-mcp
|
|
4
|
-
|
|
5
|
-
**Durable Model Context Protocol (MCP) server for delegating asynchronous coding tasks and DAG workflows to local Oh My Pi (OMP) CLI sub-agents.**
|
|
6
|
-
|
|
7
|
-
<p align="center">
|
|
8
|
-
|
|
9
|
-
<a href="README.zh-CN.md">简体中文</a>
|
|
10
|
-
</
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
[ for public contract definitions, deprecation policies, and upgrade guarantees.
|
|
257
|
-
- **Release History**: Review [CHANGELOG.md](./CHANGELOG.md) for notable changes across releases.
|
|
258
|
-
|
|
259
|
-
---
|
|
260
|
-
|
|
261
|
-
## License
|
|
262
|
-
|
|
263
|
-
This project is licensed under the [MIT License](LICENSE).
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
# omp-worker-mcp
|
|
4
|
+
|
|
5
|
+
**Durable Model Context Protocol (MCP) server for delegating asynchronous coding tasks and DAG workflows to local Oh My Pi (OMP) CLI sub-agents.**
|
|
6
|
+
|
|
7
|
+
<p align="center">
|
|
8
|
+
English •
|
|
9
|
+
<a href="README.zh-CN.md">简体中文</a> •
|
|
10
|
+
<a href="docs/README.md">Documentation Hub</a>
|
|
11
|
+
</p>
|
|
12
|
+
|
|
13
|
+
[](LICENSE)
|
|
14
|
+
[](https://www.npmjs.com/package/omp-worker-mcp)
|
|
15
|
+
[](package.json)
|
|
16
|
+
[](https://github.com/divenire990/omp-worker-mcp/actions/workflows/ci.yml)
|
|
17
|
+
[](https://modelcontextprotocol.io/)
|
|
18
|
+
[](https://m8ven.ai/mcp/divenire990-omp-worker-mcp-4fc9xm)
|
|
19
|
+
|
|
20
|
+
<br />
|
|
21
|
+
|
|
22
|
+
<img src="assets/orchestration.gif" alt="Async DAG Orchestration Flow" width="800" />
|
|
23
|
+
|
|
24
|
+
<p align="center">
|
|
25
|
+
<em>Asynchronous task execution, DAG dependency resolution, path ownership isolation, and structured result verification.</em>
|
|
26
|
+
</p>
|
|
27
|
+
|
|
28
|
+
[Quick Start](#installation--quick-start) • [Minimal Config](#minimal-mcp-configuration) • [Tool Overview](#available-mcp-tools) • [Safety Contract](#task-safety--ownership) • [Benchmark Protocol](benchmarks/README.md) • [Platform Support](#platform-support--boundaries) • [Docs Hub](docs/README.md)
|
|
29
|
+
|
|
30
|
+
</div>
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## Key Highlights
|
|
35
|
+
|
|
36
|
+
- ⚡ **Asynchronous Task Delegation**: Offload long-running coding, refactoring, and exploration tasks to background OMP workers without blocking conversational turns.
|
|
37
|
+
- 🔀 **Topological DAG Orchestration**: Execute interdependent batch tasks with automatic dependency validation, concurrency pool limiting, and failure containment.
|
|
38
|
+
- 🛡️ **Workspace Path Isolation**: Enforce explicit write-path boundaries to prevent overlapping modifications between parallel tasks.
|
|
39
|
+
- 🔍 **Supervised Resumption & Envelopes**: Inspect interim execution logs in real time, extract structured result envelopes (`OMP_WORKER_RESULT`), and inject supervisory feedback via `omp_continue`.
|
|
40
|
+
- 💾 **Persistent State & Configurable Retention**: File-backed state persistence for job metadata and logs with optional TTL and storage capacity bounds.
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## Why This Architecture?
|
|
46
|
+
|
|
47
|
+
`omp-worker-mcp` adopts a supervisor-worker delegation model: a premium host LLM (such as Codex or Claude Code) focuses on architecture, task decomposition, and acceptance review, while autonomous `omp-worker-mcp` background workers handle concrete execution.
|
|
48
|
+
|
|
49
|
+
> **Empirical Hypothesis**: Delegating execution-heavy coding tasks to background workers frees the primary host harness to focus on high-level design and verification, reducing conversational context fatigue while enabling multi-task parallelism. Evaluate this hypothesis empirically using our reproducible [Benchmark Protocol](benchmarks/README.md).
|
|
50
|
+
---
|
|
51
|
+
|
|
52
|
+
## Platform Support & Boundaries
|
|
53
|
+
|
|
54
|
+
- **Upstream Engine**: Interfaces with the [Oh My Pi (OMP)](https://github.com/can1357/oh-my-pi) CLI (MIT License). The upstream binary is **not bundled** and must be installed in your local runtime `PATH`.
|
|
55
|
+
- **Runtime Requirement**: Node.js **>= 22.0.0** (native ESM and standard library capabilities).
|
|
56
|
+
- **Operating Systems**:
|
|
57
|
+
- **Windows** (`win32`) & **macOS** (`darwin` / Apple Silicon): Fully verified with Node 22+ and real OMP CLI E2E testing.
|
|
58
|
+
- **Linux** (`x86_64`, `aarch64`): Architectural design target; awaiting broader production verification.
|
|
59
|
+
- **Support Tiers**:
|
|
60
|
+
- **Author-Verified**: Codex (author's daily local workflow; not a cross-platform CI guarantee).
|
|
61
|
+
- **Documented / Reproducible**: Claude Code, WorkBuddy, Claude Desktop, Cursor, Cline, VS Code, Copilot CLI (*not CI integration-tested*).
|
|
62
|
+
- **Cloud / Remote Hosts**: Conditional (*requires complete runtime, OMP CLI in PATH, writable workspace, and process spawning permissions*).
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## Installation & Quick Start
|
|
67
|
+
|
|
68
|
+
`omp-worker-mcp` is an MCP server launched by stdio MCP hosts (such as Codex, Claude Code, etc.) using `npx` or a global install, rather than a standalone interactive CLI.
|
|
69
|
+
|
|
70
|
+
### Host Stdio Command (Recommended)
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
# Executed by your stdio MCP host configuration (e.g., mcpServers)
|
|
74
|
+
npx -y omp-worker-mcp
|
|
75
|
+
```
|
|
76
|
+
### Global Installation
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
# Install globally via npm
|
|
80
|
+
npm install -g omp-worker-mcp
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### Building from Source
|
|
84
|
+
|
|
85
|
+
```bash
|
|
86
|
+
git clone https://github.com/divenire990/omp-worker-mcp.git
|
|
87
|
+
cd omp-worker-mcp
|
|
88
|
+
npm ci
|
|
89
|
+
npm run build
|
|
90
|
+
npm test
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
## Minimal MCP Configuration
|
|
96
|
+
|
|
97
|
+
Add `omp-worker-mcp` to your host harness's `mcpServers` configuration using standard stdio transport:
|
|
98
|
+
|
|
99
|
+
```json
|
|
100
|
+
{
|
|
101
|
+
"mcpServers": {
|
|
102
|
+
"omp-worker": {
|
|
103
|
+
"command": "npx",
|
|
104
|
+
"args": ["-y", "omp-worker-mcp"],
|
|
105
|
+
"env": {
|
|
106
|
+
"OMP_WORKER_OMP_COMMAND": "omp"
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
*For detailed configs covering Codex (`config.toml`), Claude Code CLI, WorkBuddy, and other clients, see [Client Configurations](docs/client-configurations.md).*
|
|
114
|
+
|
|
115
|
+
---
|
|
116
|
+
|
|
117
|
+
## Available MCP Tools
|
|
118
|
+
|
|
119
|
+
### Single Task Delegation Tools
|
|
120
|
+
|
|
121
|
+
| Tool | Purpose |
|
|
122
|
+
| :--- | :--- |
|
|
123
|
+
| `omp_run_compact` | **Recommended for single tasks**: Delegates a coding task and waits up to `wait_seconds` for a compact summary. |
|
|
124
|
+
| `omp_delegate` | Low-level dispatch: Spawns an asynchronous background worker and returns a `job_id`. |
|
|
125
|
+
| `omp_wait` | Polls or waits for an asynchronous job to reach a terminal status or timeout. |
|
|
126
|
+
| `omp_result` | Inspects attempt history, stdout/stderr logs, modified artifacts, and structured result envelopes. |
|
|
127
|
+
| `omp_continue` | Injects supervisory guidance into a failed or blocked task to retry within the same session. |
|
|
128
|
+
| `omp_cancel` | Sends a cancellation signal to terminate a running job and its child process tree. |
|
|
129
|
+
|
|
130
|
+
### Batch & DAG Orchestration Tools
|
|
131
|
+
|
|
132
|
+
| Tool | Purpose |
|
|
133
|
+
| :--- | :--- |
|
|
134
|
+
| `omp_run_batch_compact` | **Recommended for multi-task workflows**: Runs an interdependent task DAG with concurrency control and waits for completion. |
|
|
135
|
+
| `omp_wait_group` | Waits for progress or completion of an asynchronous batch task group. |
|
|
136
|
+
| `omp_cancel_group` | Cancels all active and queued tasks within a batch group. |
|
|
137
|
+
|
|
138
|
+
*For complete tool schemas and parameter references, consult the [Tool Reference](docs/tool-reference.md).*
|
|
139
|
+
|
|
140
|
+
---
|
|
141
|
+
|
|
142
|
+
## Task Safety & Ownership
|
|
143
|
+
|
|
144
|
+
1. **Write vs. Read-Only Boundaries**: `write` tasks must explicitly declare the workspace paths they own via `ownership`; `read_only` tasks are strictly prohibited from modifying files.
|
|
145
|
+
2. **DAG Overlap Verification**: Parallel tasks within the same batch cannot declare overlapping write boundaries; tasks sharing paths must declare sequential `depends_on` dependencies.
|
|
146
|
+
3. **Structured Verification Contract**: Subagents deliver deliverables using the structured `OMP_WORKER_RESULT` envelope (status, summary, artifacts, verification checks, remaining items).
|
|
147
|
+
|
|
148
|
+
*High-impact operations (e.g., `npm publish`, `git push`, production deployments, secret modification) must always remain under direct host harness and human supervision.*
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
## Documentation Hub
|
|
153
|
+
|
|
154
|
+
Detailed documentation is organized in the [`docs/`](docs/README.md) directory:
|
|
155
|
+
|
|
156
|
+
- [**Documentation Index**](docs/README.md): Overview of documentation layout and responsibilities.
|
|
157
|
+
- [**Author Workflow & Architecture**](docs/author-workflow.md): Host-Worker supervision loop, execution strategies, and authoring guidelines.
|
|
158
|
+
- [**Client Configurations**](docs/client-configurations.md): Documented and reproducible configuration guidance for Codex, Claude Code, WorkBuddy, Cursor, VS Code, and more.
|
|
159
|
+
- [**Operations & State Lifecycle**](docs/operations.md): Environment variables, state directory layout, retention policies, and recovery.
|
|
160
|
+
- [**Tool Reference & Safety Contract**](docs/tool-reference.md): Full MCP tool specifications and safety boundaries.
|
|
161
|
+
- [**Benchmark Protocol**](benchmarks/README.md): Reproducible evaluation protocol comparing direct host execution against supervisor-worker delegation.
|
|
162
|
+
|
|
163
|
+
---
|
|
164
|
+
|
|
165
|
+
## Compatibility & Changelog
|
|
166
|
+
|
|
167
|
+
- **Public Contract & Deprecation**: Review [COMPATIBILITY.md](COMPATIBILITY.md) for versioning guarantees.
|
|
168
|
+
- **Release History**: Review [CHANGELOG.md](CHANGELOG.md) for notable updates.
|
|
169
|
+
|
|
170
|
+
---
|
|
171
|
+
|
|
172
|
+
## License
|
|
173
|
+
|
|
174
|
+
This project is licensed under the [MIT License](LICENSE).
|
package/README.zh-CN.md
CHANGED
|
@@ -1,260 +1,174 @@
|
|
|
1
|
-
<div align="center">
|
|
2
|
-
|
|
3
|
-
# omp-worker-mcp
|
|
4
|
-
|
|
5
|
-
**用于将异步编码任务和 DAG 工作流委托给本地 Oh My Pi (OMP) CLI 子 Agent 执行的持久化模型上下文协议（MCP）服务器。**
|
|
6
|
-
|
|
7
|
-
<p align="center">
|
|
8
|
-
<a href="README.md">English</a> •
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
[ 了解公共契约定义、废弃过渡流程与版本兼容性保证。
|
|
254
|
-
- **变更日志**：请参阅 [CHANGELOG.md](./CHANGELOG.md) 了解各版本的详细更新与修复记录。
|
|
255
|
-
|
|
256
|
-
---
|
|
257
|
-
|
|
258
|
-
## 许可证
|
|
259
|
-
|
|
260
|
-
本项目基于 [MIT 许可证](LICENSE) 开源。
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
# omp-worker-mcp
|
|
4
|
+
|
|
5
|
+
**用于将异步编码任务和 DAG 工作流委托给本地 Oh My Pi (OMP) CLI 子 Agent 执行的持久化模型上下文协议（MCP）服务器。**
|
|
6
|
+
|
|
7
|
+
<p align="center">
|
|
8
|
+
<a href="README.md">English</a> •
|
|
9
|
+
简体中文 •
|
|
10
|
+
<a href="docs/README.zh-CN.md">文档中心</a>
|
|
11
|
+
</p>
|
|
12
|
+
|
|
13
|
+
[](LICENSE)
|
|
14
|
+
[](https://www.npmjs.com/package/omp-worker-mcp)
|
|
15
|
+
[](package.json)
|
|
16
|
+
[](https://github.com/divenire990/omp-worker-mcp/actions/workflows/ci.yml)
|
|
17
|
+
[](https://modelcontextprotocol.io/)
|
|
18
|
+
[](https://m8ven.ai/mcp/divenire990-omp-worker-mcp-4fc9xm)
|
|
19
|
+
|
|
20
|
+
<br />
|
|
21
|
+
|
|
22
|
+
<img src="assets/orchestration.gif" alt="异步 DAG 编排流程" width="800" />
|
|
23
|
+
|
|
24
|
+
<p align="center">
|
|
25
|
+
<em>异步任务执行、DAG 依赖解析、路径所有权隔离与结构化结果校验。</em>
|
|
26
|
+
</p>
|
|
27
|
+
|
|
28
|
+
[快速开始](#安装与快速开始) • [最小配置](#最小-mcp-配置) • [工具概览](#可用-mcp-工具) • [安全约束](#任务安全与所有权约束) • [基准测试规范](benchmarks/README.zh-CN.md) • [平台支持](#平台支持与支持边界) • [文档中心](docs/README.zh-CN.md)
|
|
29
|
+
|
|
30
|
+
</div>
|
|
31
|
+
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## 核心亮点
|
|
35
|
+
|
|
36
|
+
- ⚡ **异步委托执行**：将耗时的编码、重构与调研任务下发给后台 OMP Worker 实例，主对话会话无需等待阻塞。
|
|
37
|
+
- 🔀 **拓扑 DAG 编排**：执行相互依赖的批量任务，支持自动依赖解析、并发池调度与故障隔离。
|
|
38
|
+
- 🛡️ **工作区路径隔离**：强制执行严格的写路径边界约束，防止并发任务之间发生文件写入冲突。
|
|
39
|
+
- 🔍 **持续监督与结构化信封**：支持实时查看运行日志、提取结构化 JSON 结果信封（`OMP_WORKER_RESULT`），并通过 `omp_continue` 注入纠错指导。
|
|
40
|
+
- 💾 **持久化状态与生命周期管理**：基于磁盘文件的任务元数据与日志持久化，支持可配置的保留时间（TTL）与磁盘容量上限。
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## 为什么采用此架构？
|
|
46
|
+
|
|
47
|
+
`omp-worker-mcp` 采用“主控监督与自治委派”模型：高级主控模型（如 Codex、Claude Code 等）专注于高层架构设计、任务拆解与质量把关，后台 `omp-worker-mcp` 实例则负责具体编码、重构与调研任务的自治执行。
|
|
48
|
+
|
|
49
|
+
> **待测经验假设**：将高耗时的具体执行任务委派给后台 Worker，使高级主控模型能够专注于架构设计与质量验收，有助于降低主会话上下文压力与交互疲劳，并在支持并发的批处理任务中提升吞吐效率。欢迎通过我们的公开 [基准测试评估规范](benchmarks/README.zh-CN.md) 开展实测检验。
|
|
50
|
+
---
|
|
51
|
+
|
|
52
|
+
## 平台支持与支持边界
|
|
53
|
+
|
|
54
|
+
- **外部上游引擎**：调用 [Oh My Pi (OMP)](https://github.com/can1357/oh-my-pi) CLI（基于 MIT 许可证）。上游二进制文件**不随本包分发**，需自行安装并置于 `PATH` 中。
|
|
55
|
+
- **运行环境要求**：Node.js **>= 22.0.0**（依赖原生 ECMAScript Modules 与标准库能力）。
|
|
56
|
+
- **操作系统支持**：
|
|
57
|
+
- **Windows** (`win32`) 与 **macOS** (`darwin` / Apple Silicon)：经由真实 Node 22+ 与 OMP CLI E2E 完整验证支持。
|
|
58
|
+
- **Linux** (`x86_64`, `aarch64`)：目前为架构设计目标，待在生产环境中进一步验证。
|
|
59
|
+
- **支持等级**：
|
|
60
|
+
- **作者实测**：Codex（作者个人主力本机工作流实测；不构成跨平台 CI 集成保证）。
|
|
61
|
+
- **官方文档或可复制配置**：Claude Code、WorkBuddy、Claude Desktop、Cursor、Cline、VS Code、GitHub Copilot CLI（*未在 CI 做集成测试*）。
|
|
62
|
+
- **云端 / 远程宿主**：有条件支持（*需远程容器完整提供 Node.js >= 22、处于 PATH 的 OMP CLI、可写工作区及进程启动权限*）。
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## 安装与快速开始
|
|
67
|
+
|
|
68
|
+
`omp-worker-mcp` 作为 MCP 服务器运行，由 stdio MCP 宿主（如 Codex、Claude Code 等）通过 `npx` 或全局安装命令调起，并非独立的交互式命令行工具。
|
|
69
|
+
|
|
70
|
+
### 宿主 Stdio 启动命令（推荐）
|
|
71
|
+
|
|
72
|
+
```bash
|
|
73
|
+
# 由 MCP 宿主配置（如 mcpServers）自动调起的启动命令
|
|
74
|
+
npx -y omp-worker-mcp
|
|
75
|
+
```
|
|
76
|
+
### 全局安装
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
# 通过 npm 全局安装
|
|
80
|
+
npm install -g omp-worker-mcp
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### 从源码编译
|
|
84
|
+
|
|
85
|
+
```bash
|
|
86
|
+
git clone https://github.com/divenire990/omp-worker-mcp.git
|
|
87
|
+
cd omp-worker-mcp
|
|
88
|
+
npm ci
|
|
89
|
+
npm run build
|
|
90
|
+
npm test
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
---
|
|
94
|
+
|
|
95
|
+
## 最小 MCP 配置
|
|
96
|
+
|
|
97
|
+
在您的主控 Harness 的 `mcpServers` 配置中添加标准 stdio 服务定义：
|
|
98
|
+
|
|
99
|
+
```json
|
|
100
|
+
{
|
|
101
|
+
"mcpServers": {
|
|
102
|
+
"omp-worker": {
|
|
103
|
+
"command": "npx",
|
|
104
|
+
"args": ["-y", "omp-worker-mcp"],
|
|
105
|
+
"env": {
|
|
106
|
+
"OMP_WORKER_OMP_COMMAND": "omp"
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
*关于 Codex (`config.toml`)、Claude Code CLI、WorkBuddy 及其他客户端的完整配置，请参阅 [客户端接入与配置指南](docs/client-configurations.zh-CN.md)。*
|
|
114
|
+
|
|
115
|
+
---
|
|
116
|
+
|
|
117
|
+
## 可用 MCP 工具
|
|
118
|
+
|
|
119
|
+
### 单任务委托工具
|
|
120
|
+
|
|
121
|
+
| 工具名称 | 用途 |
|
|
122
|
+
| :--- | :--- |
|
|
123
|
+
| `omp_run_compact` | **单任务推荐**：便捷工具，委托单个任务并在 `wait_seconds` 内等待结果，返回压缩摘要。 |
|
|
124
|
+
| `omp_delegate` | 底层分发：异步创建后台 Worker 执行编码任务，立即返回 `job_id`。 |
|
|
125
|
+
| `omp_wait` | 轮询或等待正在运行的后台任务直至终态或超时。 |
|
|
126
|
+
| `omp_result` | 获取任务的尝试历史、标准输出/错误日志、修改产物及结构化结果信封。 |
|
|
127
|
+
| `omp_continue` | 向失败或阻塞的任务注入监督指导，在同一会话中发起新一轮尝试。 |
|
|
128
|
+
| `omp_cancel` | 发送取消信号，优雅终止正在运行的任务及其子进程树。 |
|
|
129
|
+
|
|
130
|
+
### 批量任务与 DAG 编排工具
|
|
131
|
+
|
|
132
|
+
| 工具名称 | 用途 |
|
|
133
|
+
| :--- | :--- |
|
|
134
|
+
| `omp_run_batch_compact` | **多任务推荐**：创建具有依赖图（DAG）的批量任务组，控制并发度并等待全部完成返回汇总结果。 |
|
|
135
|
+
| `omp_wait_group` | 等待异步批量任务组的执行推进或全部完成。 |
|
|
136
|
+
| `omp_cancel_group` | 取消批量任务组中所有正在运行及等待队列中的任务。 |
|
|
137
|
+
|
|
138
|
+
*有关完整工具 Schema 与参数定义，请查阅 [工具参考与安全约束](docs/tool-reference.zh-CN.md)。*
|
|
139
|
+
|
|
140
|
+
---
|
|
141
|
+
|
|
142
|
+
## 任务安全与所有权约束
|
|
143
|
+
|
|
144
|
+
1. **写入与只读隔离**：`write` 任务必须通过 `ownership` 明确声明拥有所有权的文件路径；`read_only` 任务被严格禁止修改任何工作区文件。
|
|
145
|
+
2. **DAG 冲突与重叠校验**：同一组内并行运行的任务之间不得声明重叠的写入路径；操作相同路径的任务必须通过 `depends_on` 声明串行先后关系。
|
|
146
|
+
3. **结构化校验信封约定**：所有子任务均需在最终输出中遵循 `OMP_WORKER_RESULT` 格式返回结构化结果（状态、总结、产物列表、测试验证、遗留项）。
|
|
147
|
+
|
|
148
|
+
*高影响操作（如 `npm publish`、`git push`、生产部署、修改生产机密）必须始终保留在主控 Harness 与人类用户的直接交互中由人类确认。*
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
## 文档中心导航
|
|
153
|
+
|
|
154
|
+
更深入的技术指南与运维参考已系统整理至 [`docs/`](docs/README.zh-CN.md) 目录：
|
|
155
|
+
|
|
156
|
+
- [**文档中心首页**](docs/README.zh-CN.md)：文档结构布局与职责划分说明。
|
|
157
|
+
- [**作者工作流与架构设计**](docs/author-workflow.zh-CN.md)：主控与 Worker 监督闭环、执行策略矩阵与工作流撰写准则。
|
|
158
|
+
- [**客户端接入与配置指南**](docs/client-configurations.zh-CN.md)：涵盖 Codex（作者实测）及 Claude Code、WorkBuddy、Cursor、VS Code 等客户端的配置指南与可复现示例。
|
|
159
|
+
- [**运维配置与状态生命周期**](docs/operations.zh-CN.md)：环境变量完整表、磁盘状态布局、保留清理策略与重启恢复。
|
|
160
|
+
- [**工具参考与安全约束**](docs/tool-reference.zh-CN.md)：全部 MCP 工具定义、参数规范与安全边界。
|
|
161
|
+
- [**基准测试评估规范**](benchmarks/README.zh-CN.md)：对比主控直接执行与主控-Worker 委派编排的可复现评测协议。
|
|
162
|
+
|
|
163
|
+
---
|
|
164
|
+
|
|
165
|
+
## 兼容性政策与变更记录
|
|
166
|
+
|
|
167
|
+
- **公共契约与升级保证**：请参阅 [COMPATIBILITY.md](COMPATIBILITY.md) 了解版本策略与契约定义。
|
|
168
|
+
- **发布记录**：请参阅 [CHANGELOG.md](CHANGELOG.md) 了解详细版本更新历史。
|
|
169
|
+
|
|
170
|
+
---
|
|
171
|
+
|
|
172
|
+
## 许可证
|
|
173
|
+
|
|
174
|
+
本项目基于 [MIT 许可证](LICENSE) 开源。
|
package/package.json
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "omp-worker-mcp",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"mcpName": "io.github.divenire990/omp-worker-mcp",
|
|
4
5
|
"type": "module",
|
|
5
6
|
"description": "Delegate complete coding tasks to the local OMP default model and inspect the result.",
|
|
6
7
|
"license": "MIT",
|
|
@@ -34,6 +35,7 @@
|
|
|
34
35
|
"files": [
|
|
35
36
|
"dist",
|
|
36
37
|
"bin",
|
|
38
|
+
"server.json",
|
|
37
39
|
"README.md",
|
|
38
40
|
"LICENSE"
|
|
39
41
|
],
|
|
@@ -41,6 +43,7 @@
|
|
|
41
43
|
"build": "tsc -p tsconfig.json",
|
|
42
44
|
"prepack": "npm run build",
|
|
43
45
|
"test": "npm run build && node --test tests/*.test.mjs",
|
|
46
|
+
"benchmark:extract-telemetry": "node benchmarks/tools/extract-codex-telemetry.mjs",
|
|
44
47
|
"start": "node dist/index.js"
|
|
45
48
|
},
|
|
46
49
|
"dependencies": {
|
package/server.json
ADDED
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
|
|
3
|
+
"name": "io.github.divenire990/omp-worker-mcp",
|
|
4
|
+
"title": "omp-worker-mcp",
|
|
5
|
+
"description": "Delegate complete coding tasks to the local OMP default model and inspect the result.",
|
|
6
|
+
"version": "0.1.1",
|
|
7
|
+
"websiteUrl": "https://github.com/divenire990/omp-worker-mcp#readme",
|
|
8
|
+
"repository": {
|
|
9
|
+
"type": "git",
|
|
10
|
+
"url": "https://github.com/divenire990/omp-worker-mcp",
|
|
11
|
+
"source": "github"
|
|
12
|
+
},
|
|
13
|
+
"packages": [
|
|
14
|
+
{
|
|
15
|
+
"registryType": "npm",
|
|
16
|
+
"identifier": "omp-worker-mcp",
|
|
17
|
+
"version": "0.1.1",
|
|
18
|
+
"transport": {
|
|
19
|
+
"type": "stdio"
|
|
20
|
+
},
|
|
21
|
+
"runtimeHint": "npx",
|
|
22
|
+
"runtimeArguments": [
|
|
23
|
+
{
|
|
24
|
+
"type": "positional",
|
|
25
|
+
"value": "-y"
|
|
26
|
+
},
|
|
27
|
+
{
|
|
28
|
+
"type": "positional",
|
|
29
|
+
"value": "omp-worker-mcp"
|
|
30
|
+
}
|
|
31
|
+
],
|
|
32
|
+
"environmentVariables": [
|
|
33
|
+
{
|
|
34
|
+
"name": "OMP_WORKER_OMP_COMMAND",
|
|
35
|
+
"description": "Path or executable name for the local OMP CLI binary.",
|
|
36
|
+
"isRequired": true,
|
|
37
|
+
"format": "string",
|
|
38
|
+
"isSecret": false
|
|
39
|
+
}
|
|
40
|
+
]
|
|
41
|
+
}
|
|
42
|
+
]
|
|
43
|
+
}
|