इस प्रोजेक्ट के बारे में

Mac Developer Bridge एक पन-सोर्स MCP (Model Context Protocol) सर्वर है जो ChatGPT को वास्तविक Mac execution environment से जोड़ता है। यह deterministic local tools उपलब्ध कराता है—shell commands, filesystem operations, interactive PTY sessions, background job management, संग्रहीत Codex thread reading, और वैकल्पिक background Chrome automation—बिना कोई दूसरा reasoning loop जोड़े। ChatGPT ही agent रहता है; Mac execution environment है। मुख्य क्षमताएँ शामिल हैं: - logged-in macOS user के अंतर्गत /bin/zsh -lc के माध्यम से मनमाना shell command execution - persistent stdout/stderr logs, status inspection, और process-group termination के साथ detached background jobs - अप्रतिबंधित file read, write, append, list, stat, copy, move, chmod, symlink, mkdir, और recursive delete - git apply के माध्यम से unified-diff application - किसी thread को resume किए या Codex model turn शुरू किए बिना संग्रहीत Codex thread discovery और reading - एक ही response के लिए बहुत बड़ी histories के लिए paginated Codex turn retrieval - Local JSONL auditing - OpenAI Secure MCP Tunnel के माध्यम से outbound-only private connectivity, या Cloudflare Tunnel के माध्यम से HTTPS पर publish किया गया plain-HTTP loopback front end - macOS LaunchAgent के माध्यम से per-user persistence - Fail-closed unlock latch: bridge.mjs हर tool call से पहले unlock file को फिर से पढ़ता है, इसलिए उसे हटाने पर अगला call अस्वीकार हो जाता है और वह exit कर जाता है - Local kill switch (scripts/disable.sh) जो front end, bridge, वैकल्पिक background-Chrome native host, detached shell_start job groups, interactive PTY sessions, और federated child MCP servers को रोकता है वैकल्पिक Background Chrome integration एक छोटे local extension के माध्यम से उसी signed-in Chrome profile को संचालित करता है, जिससे automation background में रहता है और focus नहीं चुराता। यह lease-based access के साथ एक persistent tab pool (डिफ़ॉल्ट 8, अधिकतम 32) प्रबंधित करता है, 10 मिनट के बाद idle reclamation, और self-healing capacity। shell_exec के माध्यम से सीधा Chrome control हमेशा CHROME_BACKGROUND_REQUIRED के साथ अस्वीकार किया जाता है ताकि no-focus-stealing boundary संरचनात्मक रूप से लागू रहे। सामान्य HTTP/HTTPS कार्य के लिए Relaxed access डिफ़ॉल्ट है; Strict approvals mode प्रति-साइट URL grants जोड़ता है जिनका TTL 15 मिनट होता है। Interactive terminal sessions एक वास्तविक PTY का उपयोग करते हैं जिसे core Perl helper (lib/ptyhelper.pl) allocate करता है, साथ में sessions को start, read, write, resize, signal, और close करने के tools हैं। 1024-byte canonical-mode line limit लागू किया जाता है, और एक fixed ring buffer हाल का output रखता है। परियोजना में प्रायोगिक सुविधाँ भी शामिल हैं: एक ChatGPT conversation kickoff tool (chatgpt_conversation_start) जो UI typing या credential export के बिना signed-in page के first-party runtime action के माध्यम से consumer ChatGPT conversation शुरू या जारी करता है, और explicit OpenCodex models (chatgpt-browser और chatgpt-sol) के लिए एक अलग /v1/responses adapter जो Responses instructions/input से stateless turns को फिर से बनाता है और tools को एक fixed JSON decision protocol के माध्यम से प्रस्तुत करता है। सुरक्षा संबंधी विचार: यह bridge जानबूझकर एक MCP client को macOS user की effective permissions देता है। यह sandboxed नहीं है और इसमें कोई command या path allowlist नहीं है। उपयोगकर्ताओं को इसे enable करने से पहले SECURITY.md पढ़ने के लिए निर्देशित किया जाता है। अधिक कड़े browser/app workflow control के लिए Strict approvals mode उपलब्ध है, और menu-bar app एक live toggle प्रदान करता है। यह परियोजना MIT License के अंतर्गत जारी की गई है और एक स्वतंत्र ओपन-सोर्स परियोजना है, न कि कोई आधिकारिक OpenAI या Cloudflare उत्पाद।