omp-worker-mcp

Надёжный сервер Model Context Protocol (MCP) для делегирования асинхронных задач программирования и DAG-рабочих процессов локальным субагентам CLI Oh My Pi (OMP).

Быстрый старт • Конфигурация • Доступные инструменты • Контракт безопасности • Атрибуция вышестоящего проекта

Ключевые особенности

• ⚡ Асинхронное делегированное выполнение: Выгружайте тяжёлые задачи программирования, рефакторинга и исследования в фоновые рабочие экземпляры OMP, не блокируя основной диалог.

• 🔀 Топологическая оркестрация DAG: Выполняйте взаимозависимые пакетные задачи с автоматической топологической сортировкой, контролем параллелизма и распространением зависимостей.

• 🛡️ Изоляция путей рабочей области: Обеспечивайте явные границы путей записи и предотвращайте перекрывающиеся изменения файлов в параллельных задачах.

• 🔍 Контролируемое возобновление и конверты: Просматривайте промежуточные журналы в реальном времени, извлекайте структурированные JSON-конверты результатов и предоставляйте контролирующие указания для повторных попыток или корректировки задач.

Атрибуция вышестоящего проекта и отказ от ответственности

• Внешний вышестоящий CLI: Этот проект взаимодействует с Oh My Pi (OMP), инструментом с открытым исходным кодом, выпущенным под лицензией MIT.

• Требования к пользователю:

  • Node.js >= 22.0.0.

  • Пользователи должны установить и настроить собственный локальный экземпляр OMP CLI.

  • Пользователи несут ответственность за соблюдение лицензии и условий OMP CLI, применимых к их среде.

Возможности

• Асинхронное делегированное выполнение: Запускайте независимые задачи программирования субагентов, не блокируя основной диалоговый сеанс.

• Оркестрация DAG и пакетов: Выполняйте взаимозависимые пакетные задачи с топологической сортировкой зависимостей, ограничениями параллелизма и автоматическим распространением зависимостей.

• Строгая безопасность и владение задачами: Встроенные проверки предотвращают запись нескольких параллельных задач в перекрывающиеся пути файлов или конфликты в одной рабочей области.

• Непрерывное наблюдение и обратная связь: Просматривайте промежуточные результаты, потоковые журналы, извлекайте структурированные JSON-конверты и предоставляйте контролирующую обратную связь для продолжения или повторных попыток.

• Кроссплатформенный дизайн: Предназначен для локальных сред Node.js на Windows, macOS и Linux; проверьте доступность 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

Пример конфигурации MCP-клиента Codex

Добавьте сервер в конфигурацию MCP Codex (например, в 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.