coding-agents-mcp

# coding-agents-mcp `coding-agents-mcp` é um Agent Hypervisor e gateway universal do Model Context Protocol (MCP) projetado para orquestrar agentes autônomos de codificação via CLI. Ele permite que supervisores de IA, IDEs (como Cursor e Windsurf) e assistentes de desktop (como Claude Desktop e Google Antigravity) gerenciem agentes de codificação subordinados, incluindo o Claude Code da Anthropic, o Antigravity do Google, o Codex da OpenAI e o Cursor Agent. ## Filosofia Central O projeto enfatiza simplicidade confiável e paridade estrita entre plataformas macOS, Linux e Windows. As principais características arquiteturais incluem: * **Zero Daemon / Zero Root:** Opera como um processo Node.js stdio puro e sem privilégios. Nenhum daemon Docker, privilégio de root ou serviço em segundo plano é necessário. * **Sandboxing Universal via Git Worktrees:** Executa execuções de agentes em Git worktrees isolados e efêmeros em branches dedicadas. Isso elimina a rotatividade de arquivos e a contenção de locks, permitindo operações seguras de merge ou descarte. * **Consistência entre Sistemas Operacionais:** Rejeita silos frágeis de virtualização específicos de cada SO. Todos os recursos de isolamento, segurança e delegação funcionam de forma idêntica em todos os sistemas operacionais usando primitivas padrão de Git e Node.js. * **Segurança de Processos:** Implementa recuperação de processos à prova de órfãos usando grupos de processos POSIX padrão no Unix e `taskkill` no Windows para garantir um encerramento limpo. ## Principais Capacidades 1. **Paradigma de Agent Hypervisor:** Fornece um substrato orientado a objetivos onde modelos supervisores ditam intenção, invariantes e critérios de aceitação, enquanto agentes subordinados executam microdecisões de forma autônoma. 2. **Sessões com Estado:** Preserva automaticamente a memória de conversas com múltiplos turnos entre chamadas, sem overhead de tokens na transmissão. 3. **Transferências entre Agentes:** Transfere tarefas entre modelos diferentes usando pacotes estruturados (objetivos, manifestos de arquivos, diffs do git) em vez de transcrições brutas, evitando a explosão da janela de contexto. 4. **Orquestração Multiagente:** Suporta topologias declarativas integradas como `architect_builder`, `peer_review` e DAGs personalizados com rollback automático e verificação de diff. 5. **Sandboxing Efêmero:** Usa worktrees destacados para isolar execuções de agentes, garantindo que o workspace principal permaneça limpo até que as alterações sejam explicitamente mescladas. ## Agentes Suportados | Agente | Binário CLI | Status | | :--- | :--- | :--- | | Anthropic Claude Code | `claude` | Suportado | | Google Antigravity | `agy` | Suportado | | OpenAI Codex CLI | `codex` | Adaptador Pronto | | Cursor Agent | `cursor` | Adaptador Pronto | ## Referência do Conjunto de Ferramentas O gateway expõe várias ferramentas para delegação, inspeção e orquestração: * **Delegação Central:** `delegate_task` para programação em par autônoma, `delegate_ask` para consultas somente leitura e `delegate_diff` para inspeção do workspace. * **Gerenciamento de Sessões:** `delegate_sessions` e `delegate_reset` para gerenciar o estado da conversa. * **Gerenciamento de Worktree:** `delegate_worktree` para listar, inspecionar, mesclar ou descartar sandboxes isolados. * **Orquestração:** `delegate_pipeline` para fluxos de trabalho multiagente e `delegate_handoff` para transferências estruturadas de tarefas. * **Mensagens:** `agent_mailbox` para coordenação assíncrona entre agentes. ## Início Rápido Execute diretamente via `npx`: ```bash npx -y coding-agents-mcp ``` ### Exemplos de Configuração **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"] } } } ``` ## Desenvolvimento Para compilar e testar localmente: ```bash git clone https://github.com/funkyfunc/coding-agents-mcp.git cd coding-agents-mcp npm install npm run build npm test ``` O projeto está licenciado sob MIT.