coding-agents-mcp

# coding-agents-mcp `coding-agents-mcp`는 자율 CLI 코딩 에이전트를 오케스트레이션하도록 설계된 Agent Hypervisor이자 범용 Model Context Protocol(MCP) 게이트웨이다. 이를 통해 AI 슈퍼바이저, IDE(Cursor, Windsurf 등), 데스크톱 어시스턴트(Claude Desktop, Google Antigravity 등)가 Anthropic의 Claude Code, Google의 Antigravity, OpenAI의 Codex, Cursor Agent를 포함한 하위 코딩 에이전트를 관리할 수 있다. ## 핵심 철학 이 프로젝트는 신뢰할 수 있는 단순성과 macOS, Linux, Windows 전반에 걸친 엄격한 크로스 플랫폼 동등성을 강조한다. 주요 아키텍처 특징은 다음과 같다: * **제로 데몬 / 제로 루트:** 순수하고 권한이 필요 없는 Node.js stdio 프로세스로 동작한다. Docker 데몬, 루트 권한, 백그라운드 서비스가 필요하지 않다. * **Git Worktree를 통한 범용 샌드박싱:** 전용 브랜치의 격리된 임시 Git worktree에서 에이전트 실행을 수행한다. 이는 파일 변동과 잠금 경합을 제거하여 안전한 병합 또는 폐기 작업을 가능하게 한다. * **크로스 OS 일관성:** 취약한 OS별 가상화 사일로를 거부한다. 모든 격리, 안전, 위임 기능은 표준 Git 및 Node.js 기본 요소를 사용하여 운영체제 전반에서 동일하게 실행된다. * **프로세스 안전성:** Unix에서는 표준 POSIX 프로세스 그룹을, Windows에서는 `taskkill`을 사용하여 고아 프로세스 방지 회수를 구현해 깔끔한 정리를 보장한다. ## 주요 기능 1. **Agent Hypervisor 패러다임:** 감독 모델이 의도, 불변 조건, 수용 기준을 지시하고 하위 에이전트가 마이크로 결정을 자율적으로 실행하는 목표 지향적 기반을 제공한다. 2. **상태 유지 세션:** 토큰 와이어 오버헤드 없이 호출 전반에 걸쳐 다중 턴 대화 메모리를 자동으로 보존한다. 3. **에이전트 간 핸드오프:** 원시 트랜스크립트 대신 구조화된 패킷(목표, 파일 매니페스트, git diff)을 사용하여 서로 다른 모델 간에 작업을 전송해 컨텍스트 윈도 폭발을 방지한다. 4. **멀티 에이전트 오케스트레이션:** `architect_builder`, `peer_review` 같은 내장 선언적 토폴로지와 자동 롤백 및 diff 검증을 갖춘 사용자 정의 DAG를 지원한다. 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 라이선스에 따른다.