coding-agents-mcp

# coding-agents-mcp `coding-agents-mcp` es un Agent Hypervisor y puerta de enlace universal del Model Context Protocol (MCP) diseñado para orquestar agentes autónomos de codificación por CLI. Permite que supervisores de IA, IDEs (como Cursor y Windsurf) y asistentes de escritorio (como Claude Desktop y Google Antigravity) gestionen agentes de codificación subordinados, incluidos Claude Code de Anthropic, Antigravity de Google, Codex de OpenAI y Cursor Agent. ## Filosofía central El proyecto enfatiza la simplicidad confiable y una estricta paridad multiplataforma en macOS, Linux y Windows. Las características arquitectónicas clave incluyen: * **Cero daemon / Cero root:** Opera como un proceso Node.js stdio puro y sin privilegios. No requiere daemon de Docker, privilegios de root ni servicios en segundo plano. * **Sandboxing universal mediante Git Worktrees:** Ejecuta las corridas de los agentes en Git worktrees aislados y efímeros sobre ramas dedicadas. Esto elimina la rotación de archivos y la contención de bloqueos, permitiendo operaciones seguras de merge o descarte. * **Consistencia entre sistemas operativos:** Rechaza silos frágiles de virtualización específicos de cada sistema operativo. Todas las funciones de aislamiento, seguridad y delegación se ejecutan de forma idéntica en todos los sistemas operativos usando primitivas estándar de Git y Node.js. * **Seguridad de procesos:** Implementa recuperación de procesos a prueba de huérfanos usando grupos de procesos POSIX estándar en Unix y `taskkill` en Windows para garantizar un desmontaje limpio. ## Capacidades clave 1. **Paradigma de Agent Hypervisor:** Proporciona un sustrato orientado a objetivos donde los modelos supervisores dictan la intención, las invariantes y los criterios de aceptación, mientras que los agentes subordinados ejecutan microdecisiones de forma autónoma. 2. **Sesiones con estado:** Preserva automáticamente la memoria de conversaciones multiturno entre llamadas con cero sobrecarga de tokens en la transmisión. 3. **Traspasos entre agentes:** Transfiere tareas entre distintos modelos usando paquetes estructurados (objetivos, manifiestos de archivos, diffs de git) en lugar de transcripciones sin procesar, evitando la explosión de la ventana de contexto. 4. **Orquestación multiagente:** Admite topologías declarativas integradas como `architect_builder`, `peer_review` y DAGs personalizados con rollback automático y verificación de diffs. 5. **Sandboxing efímero:** Usa worktrees separados para aislar las corridas de los agentes, garantizando que el espacio de trabajo principal permanezca limpio hasta que los cambios se fusionen explícitamente. ## Agentes compatibles | Agente | Binario CLI | Estado | | :--- | :--- | :--- | | Anthropic Claude Code | `claude` | Compatible | | Google Antigravity | `agy` | Compatible | | OpenAI Codex CLI | `codex` | Adaptador listo | | Cursor Agent | `cursor` | Adaptador listo | ## Referencia del conjunto de herramientas La puerta de enlace expone varias herramientas para delegación, inspección y orquestación: * **Delegación central:** `delegate_task` para programación en pareja autónoma, `delegate_ask` para consultas de solo lectura y `delegate_diff` para inspección del espacio de trabajo. * **Gestión de sesiones:** `delegate_sessions` y `delegate_reset` para gestionar el estado de la conversación. * **Gestión de worktrees:** `delegate_worktree` para listar, inspeccionar, fusionar o descartar sandboxes aislados. * **Orquestación:** `delegate_pipeline` para flujos de trabajo multiagente y `delegate_handoff` para transferencias estructuradas de tareas. * **Mensajería:** `agent_mailbox` para coordinación asíncrona entre agentes. ## Inicio rápido Ejecutar directamente mediante `npx`: ```bash npx -y coding-agents-mcp ``` ### Ejemplos de configuración **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"] } } } ``` **Sidecar de Google Antigravity:** ```json { "mcpServers": { "coding-agents": { "command": "npx", "args": ["-y", "coding-agents-mcp", "--compat=agy"] } } } ``` ## Desarrollo Para compilar y probar localmente: ```bash git clone https://github.com/funkyfunc/coding-agents-mcp.git cd coding-agents-mcp npm install npm run build npm test ``` El proyecto está licenciado bajo MIT.