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などの subordinate コーディングエージェントを管理できるようにします。 ## 基本理念 本プロジェクトは、信頼できるシンプルさと、macOS、Linux、Windows間での厳密なクロスプラットフォーム同等性を重視しています。主要なアーキテクチャ上の特徴は次のとおりです。 * **Zero Daemon / Zero Root:** 純粋で非特権のNode.js stdioプロセスとして動作します。Dockerデーモン、root権限、バックグラウンドサービスは不要です。 * **Git Worktreeによるユニバーサルサンドボックス化:** 専用ブランチ上の分離された一時的なGit worktreeでエージェント実行を行います。これによりファイルの頻繁な変更やロック競合を排除し、安全なマージまたは破棄操作を可能にします。 * **クロスOS一貫性:** 壊れやすいOS固有の仮想化サイロを排除します。すべての分離、安全性、委任機能は、標準のGitおよびNode.jsプリミティブを使用して、オペレーティングシステム間で同一に動作します。 * **プロセス安全性:** Unixでは標準のPOSIXプロセスグループ、Windowsでは`taskkill`を使用して、孤児化しないプロセス回収を実装し、クリーンな終了を保証します。 ## 主な機能 1. **Agent Hypervisorパラダイム:** 監督モデルが意図、不変条件、受け入れ基準を指示し、 subordinate エージェントがマイクロ意思決定を自律的に実行する、目標指向の基盤を提供します。 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の下でライセンスされています。