coding-agents-mcp

# coding-agents-mcp `coding-agents-mcp` هو Agent Hypervisor وبوابة Model Context Protocol (MCP) شاملة مصممة لتنسيق وكلاء البرمجة المستقلين عبر سطر الأوامر. يتيح للمشرفين من الذكاء الاصطناعي وبيئات التطوير المتكاملة (مثل Cursor وWindsurf) والمساعدين المكتبيين (مثل Claude Desktop وGoogle Antigravity) إدارة وكلاء البرمجة التابعين بما في ذلك Claude Code من Anthropic وAntigravity من Google وCodex من OpenAI وCursor Agent. ## الفلسفة الأساسية يركّز المشروع على البساطة الموثوقة والتكافؤ الصارم عبر الأنظمة الأساسية على macOS وLinux وWindows. تشمل الميزات المعمارية الرئيسية: * **بدون خادم خفي / بدون صلاحيات جذر:** يعمل كعملية Node.js stdio نقية وغير مميزة. لا حاجة إلى خادم Docker أو صلاحيات جذر أو خدمات خلفية. * **عزل شامل عبر Git Worktrees:** ينفّذ تشغيل الوكلاء في Git worktrees معزولة ومؤقتة على فروع مخصصة. يلغي ذلك تبدّل الملفات وتنازع الأقفال، مما يتيح عمليات دمج أو إلغاء آمنة. * **اتساق عبر أنظمة التشغيل:** يرفض جزر المحاكاة الهشة الخاصة بكل نظام تشغيل. تعمل جميع ميزات العزل والسلامة والتفويض بشكل متطابق عبر أنظمة التشغيل باستخدام بدائيات Git وNode.js القياسية. * **سلامة العمليات:** ينفّذ استعادة العمليات اليتيمة باستخدام مجموعات عمليات POSIX القياسية على Unix و`taskkill` على Windows لضمان إنهاء نظيف. ## القدرات الرئيسية 1. **نموذج Agent Hypervisor:** يوفّر أساسًا موجّهًا نحو الأهداف حيث تفرض النماذج المشرفة النية والثوابت ومعايير القبول، بينما ينفّذ الوكلاء التابعون القرارات الدقيقة بشكل مستقل. 2. **جلسات ذات حالة:** يحافظ تلقائيًا على ذاكرة المحادثة متعددة الأدوار عبر الاستدعاءات دون أي حمل إضافي على الرموز. 3. **التسليم بين الوكلاء:** ينقل المهام بين نماذج مختلفة باستخدام حزم منظمة (الأهداف، قوائم الملفات، فروقات git) بدلًا من النصوص الخام، مما يمنع تضخم نافذة السياق. 4. **تنسيق متعدد الوكلاء:** يدعم طوبولوجيات تعريفية مدمجة مثل `architect_builder` و`peer_review` وDAGs مخصصة مع تراجع تلقائي والتحقق من الفروقات. 5. **عزل مؤقت:** يستخدم worktrees منفصلة لعزل تشغيل الوكلاء، مما يضمن بقاء مساحة العمل الرئيسية نظيفة حتى يتم دمج التغييرات صراحةً. ## الوكلاء المدعومون | الوكيل | ملف 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.