Об этом проекте

# coding-agents-mcp `coding-agents-mcp` — это Agent Hypervisor и универсальный шлюз Model Context Protocol (MCP), предназначенный для оркестрации автономных CLI-агентов программирования. Он позволяет ИИ-супервизорам, IDE (таким как Cursor и Windsurf) и настольным ассистентам (например, Claude Desktop и Google Antigravity) управлять подчинёнными агентами программирования, включая Anthropic Claude Code, Google Antigravity, OpenAI Codex и Cursor Agent. ## Основная философия Проект делает акцент на надёжной простоте и строгой кросс-платформенной совместимости между macOS, Linux и Windows. Ключевые архитектурные особенности включают: * **Zero Daemon / Zero Root:** Работает как чистый непривилегированный процесс Node.js stdio. Не требуются Docker-демон, root-права или фоновые службы. * **Универсальная песочница через Git Worktrees:** Выполняет запуски агентов в изолированных эфемерных Git worktree на выделенных ветках. Это устраняет хаос в файлах и конфликты блокировок, позволяя безопасно выполнять слияние или отмену изменений. * **Согласованность между ОС:** Отказывается от хрупких ОС-специфичных изолированных решений виртуализации. Все функции изоляции, безопасности и делегирования работают одинаково во всех операционных системах с использованием стандартных примитивов Git и Node.js. * **Безопасность процессов:** Реализует защищённое от осиротевших процессов освобождение с использованием стандартных групп процессов POSIX в Unix и `taskkill` в Windows для обеспечения чистого завершения. ## Ключевые возможности 1. **Парадигма Agent Hypervisor:** Предоставляет ориентированный на цели субстрат, где супервизирующие модели задают намерение, инварианты и критерии приёмки, а подчинённые агенты автономно выполняют микрoreшения. 2. **Сессии с сохранением состояния:** Автоматически сохраняет память многоходовых разговоров между вызовами без накладных расходов на передачу токенов. 3. **Передача задач между агентами:** Передаёт задачи между разными моделями с использованием структурированных пакетов (цели, манифесты файлов, git diff), а не необработанных транскриптов, предотвращая переполнение контекстного окна. 4. **Мультиагентная оркестрация:** Поддерживает встроенные декларативные топологии, такие как `architect_builder`, `peer_review`, и пользовательские DAG с автоматическим откатом и проверкой diff. 5. **Эфемерная песочница:** Использует отсоединённые worktree для изоляции запусков агентов, гарантируя, что основное рабочее пространство остаётся чистым до явного слияния изменений. ## Поддерживаемые агенты | Агент | CLI-бинарник | Статус | | :--- | :--- | :--- | | Anthropic Claude Code | `claude` | Поддерживается | | Google Antigravity | `agy` | Поддерживается | | OpenAI Codex CLI | `codex` | Адаптер готов | | Cursor Agent | `cursor` | Адаптер готов | ## Справочник по инструментам Шлюз предоставляет несколько инструментов для делегирования, инспекции и оркестрации: * **Основное делегирование:** `delegate_task` для автономного парного программирования, `delegate_ask` для запросов только для чтения и `delegate_diff` для инспекции рабочего пространства. * **Управление сессиями:** `delegate_sessions` и `delegate_reset` для управления состоянием разговора. * **Управление Worktree:** `delegate_worktree` для перечисления, инспекции, слияния или отмены изолированных песочниц. * **Оркестрация:** `delegate_pipeline` для мультиагентных рабочих процессов и `delegate_handoff` для структурированной передачи задач. * **Обмен сообщениями:** `agent_mailbox` для асинхронной координации между агентами. ## Быстрый старт Запуск напрямую через `npx`: ```bash npx -y coding-agents-mcp ``` ### Примеры конфигурации **Claude Desktop (`claude_desktop_config.json`):** ```json { "mcpServers": { "coding-agents": { "command": "npx", "args": ["-y", "coding-agents-mcp"] } } } ``` **Cursor (`~/.cursor/mcp.json`):** ```json { "mcpServers": { "coding-agents": { "command": "npx", "args": ["-y", "coding-agents-mcp"] } } } ``` **Google Antigravity Sidecar:** ```json { "mcpServers": { "coding-agents": { "command": "npx", "args": ["-y", "coding-agents-mcp", "--compat=agy"] } } } ``` ## Разработка Для локальной сборки и тестирования: ```bash git clone https://github.com/funkyfunc/coding-agents-mcp.git cd coding-agents-mcp npm install npm run build npm test ``` Проект лицензирован под MIT.