इस प्रोजेक्ट के बारे में
# coding-agents-mcp
`coding-agents-mcp` एक Agent Hypervisor और सार्वभौमिक Model Context Protocol (MCP) गेटवे है, जिसे स्वायत्त CLI कोडिंग एजेंट्स को ऑर्केस्ट्रेट करने के लिए डिज़ाइन किया गया है। यह AI सुपरवाइज़र, IDEs (जैसे Cursor और Windsurf), और डेस्कटॉप सहायकों (जैसे Claude Desktop और Google Antigravity) को अधीनस्थ कोडिंग एजेंट्स—Anthropic के Claude Code, Google के Antigravity, OpenAI के Codex, और Cursor Agent—को प्रबंधित करने की अनुमति देता है।
## मूल दर्शन
यह परियोजना विश्वसनीय सरलता और macOS, Linux, और Windows पर सख्त क्रॉस-प्लेटफ़ॉर्म समानता पर ज़ोर देती है। प्रमुख आर्किटेक्चरल विशेषताएँ शामिल हैं:
* **Zero Daemon / Zero Root:** एक शुद्ध, अपरिविलेज्ड Node.js stdio प्रक्रिया के रूप में संचालित होता है। किसी Docker daemon, root विशेषाधिकार, या बैकग्राउंड सेवाओं की आवश्यकता नहीं है।
* **Git Worktrees के माध्यम से सार्वभौमिक सैंडबॉक्सिंग:** एजेंट रन को समर्पित ब्रांचों पर पृथक, अल्पकालिक Git worktrees में निष्पादित करता है। यह फ़ाइल churn और lock contention को समाप्त करता है, जिससे सुरक्षित merge या discard संचालन संभव होता है।
* **क्रॉस-OS Consistency:** नाजुक OS-विशिष्ट वर्चुअलाइज़ेशन साइलो को अस्वीकार करता है। सभी आइसोलेशन, सुरक्षा, और प्रतिनिधिमंडल सुविधाएँ मानक Git और Node.js प्रिमिटिव्स का उपयोग करके सभी ऑपरेटिंग सिस्टम पर समान रूप से चलती हैं।
* **Process Safety:** Unix पर मानक POSIX प्रोसेस ग्रुप्स और Windows पर `taskkill` का उपयोग करके orphan-proof प्रोसेस रिक्लेमेशन लागू करता है ताकि साफ़ teardown सुनिश्चित हो सके।
## प्रमुख क्षमताएँ
1. **Agent Hypervisor Paradigm:** एक लक्ष्य-उन्मुख सब्सट्रेट प्रदान करता है जहाँ सुपरवाइज़िंग मॉडल इरादा, invariants, और स्वीकृति मानदंड तय करते हैं, जबकि अधीनस्थ एजेंट स्वायत्त रूप से सूक्ष्म निर्णय निष्पादित करते हैं।
2. **Stateful Sessions:** शून्य टोकन वायर ओवरहेड के साथ कॉल्स के बीच मल्टी-टर्न बातचीत स्मृति को स्वचालित रूप से संरक्षित करता है।
3. **Inter-Agent Handoffs:** कच्चे ट्रांसक्रिप्ट के बजाय संरचित पैकेट्स (उद्देश्य, फ़ाइल मैनिफ़ेस्ट, git diffs) का उपयोग करके विभिन्न मॉडलों के बीच कार्यों को स्थानांतरित करता है, जिससे context window विस्फोट रुकता है।
4. **Multi-Agent Orchestration:** अंतर्निहित डिक्लेरेटिव टोपोलॉजीज़ जैसे `architect_builder`, `peer_review`, और स्वचालित रोलबैक और diff सत्यापन के साथ कस्टम DAGs का समर्थन करता है।
5. **Ephemeral Sandboxing:** एजेंट रन को अलग करने के लिए detached worktrees का उपयोग करता है, यह सुनिश्चित करते हुए कि मुख्य वर्कस्पेस तब तक साफ़ रहे जब तक परिवर्तनों को स्पष्ट रूप से merge न किया जाए।
## समर्थित एजेंट्स
| एजेंट | CLI बाइनरी | स्थिति |
| :--- | :--- | :--- |
| Anthropic Claude Code | `claude` | समर्थित |
| Google Antigravity | `agy` | समर्थित |
| OpenAI Codex CLI | `codex` | Adapter तैयार |
| Cursor Agent | `cursor` | Adapter तैयार |
## टूलसेट संदर्भ
गेटवे प्रतिनिधिमंडल, निरीक्षण, और ऑर्केस्ट्रेशन के लिए कई टूल्स प्रदान करता है:
* **Core Delegation:** स्वायत्त पेयर प्रोग्रामिंग के लिए `delegate_task`, केवल-पढ़ने की क्वेरीज़ के लिए `delegate_ask`, और वर्कस्पेस निरीक्षण के लिए `delegate_diff`।
* **Session Management:** बातचीत की स्थिति प्रबंधित करने के लिए `delegate_sessions` और `delegate_reset`।
* **Worktree Management:** पृथक सैंडबॉक्स को सूचीबद्ध, निरीक्षण, merge, या discard करने के लिए `delegate_worktree`।
* **Orchestration:** मल्टी-एजेंट वर्कफ़्लो के लिए `delegate_pipeline` और संरचित कार्य हस्तांतरण के लिए `delegate_handoff`।
* **Messaging:** एजेंट्स के बीच अतुल्यकालिक समन्वय के लिए `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 के अंतर्गत लाइसेंस प्राप्त है।
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.