coding-agents-mcp

# coding-agents-mcp `coding-agents-mcp` est un Agent Hypervisor et une passerelle universelle Model Context Protocol (MCP) conçue pour orchestrer des agents de codage CLI autonomes. Il permet aux superviseurs IA, aux IDE (tels que Cursor et Windsurf) et aux assistants de bureau (comme Claude Desktop et Google Antigravity) de gérer des agents de codage subordonnés, notamment Anthropic's Claude Code, Google's Antigravity, OpenAI's Codex et Cursor Agent. ## Philosophie fondamentale Le projet met l'accent sur une simplicité fiable et une parité multiplateforme stricte entre macOS, Linux et Windows. Les principales caractéristiques architecturales incluent : * **Zéro démon / Zéro root :** Fonctionne comme un processus Node.js stdio pur et non privilégié. Aucun démon Docker, privilège root ou service en arrière-plan n'est requis. * **Sandboxing universel via Git Worktrees :** Exécute les exécutions d'agents dans des Git worktrees isolés et éphémères sur des branches dédiées. Cela élimine la rotation de fichiers et la contention de verrous, permettant des opérations de fusion ou d'abandon sûres. * **Cohérence multi-OS :** Rejette les silos de virtualisation fragiles spécifiques à un OS. Toutes les fonctionnalités d'isolation, de sécurité et de délégation fonctionnent de manière identique sur tous les systèmes d'exploitation en utilisant les primitives standard Git et Node.js. * **Sécurité des processus :** Implémente une récupération de processus à l'épreuve des orphelins en utilisant les groupes de processus POSIX standard sur Unix et `taskkill` sur Windows pour garantir un démontage propre. ## Capacités clés 1. **Paradigme Agent Hypervisor :** Fournit un substrat orienté objectifs où les modèles superviseurs dictent l'intention, les invariants et les critères d'acceptation, tandis que les agents subordonnés exécutent les micro-décisions de manière autonome. 2. **Sessions avec état :** Préserve automatiquement la mémoire de conversation multi-tours entre les appels avec zéro surcoût de tokens sur le fil. 3. **Transferts entre agents :** Transfère des tâches entre différents modèles à l'aide de paquets structurés (objectifs, manifestes de fichiers, diffs git) plutôt que de transcriptions brutes, évitant l'explosion de la fenêtre de contexte. 4. **Orchestration multi-agents :** Prend en charge des topologies déclaratives intégrées telles que `architect_builder`, `peer_review` et des DAG personnalisés avec rollback automatique et vérification des diffs. 5. **Sandboxing éphémère :** Utilise des worktrees détachés pour isoler les exécutions d'agents, garantissant que l'espace de travail principal reste propre jusqu'à ce que les modifications soient explicitement fusionnées. ## Agents pris en charge | Agent | Binaire CLI | Statut | | :--- | :--- | :--- | | Anthropic Claude Code | `claude` | Pris en charge | | Google Antigravity | `agy` | Pris en charge | | OpenAI Codex CLI | `codex` | Adaptateur prêt | | Cursor Agent | `cursor` | Adaptateur prêt | ## Référence de l'ensemble d'outils La passerelle expose plusieurs outils pour la délégation, l'inspection et l'orchestration : * **Délégation principale :** `delegate_task` pour la programmation en binôme autonome, `delegate_ask` pour les requêtes en lecture seule, et `delegate_diff` pour l'inspection de l'espace de travail. * **Gestion des sessions :** `delegate_sessions` et `delegate_reset` pour gérer l'état de la conversation. * **Gestion des worktrees :** `delegate_worktree` pour lister, inspecter, fusionner ou abandonner des sandboxes isolés. * **Orchestration :** `delegate_pipeline` pour les workflows multi-agents et `delegate_handoff` pour les transferts de tâches structurés. * **Messagerie :** `agent_mailbox` pour la coordination asynchrone entre agents. ## Démarrage rapide Exécutez directement via `npx` : ```bash npx -y coding-agents-mcp ``` ### Exemples de configuration **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"] } } } ``` ## Développement Pour compiler et tester localement : ```bash git clone https://github.com/funkyfunc/coding-agents-mcp.git cd coding-agents-mcp npm install npm run build npm test ``` Le projet est sous licence MIT.