这个项目能做什么

Mac Developer Bridge 是一个开源 MCP(模型上下文协议)服务器,将 ChatGPT 连接到真实的 Mac 执行环境。它暴露确定性的本地工具——shell 命令、文件系统操作、交互式 PTY 会话、后台任务管理、存储的 Codex 线程读取,以及可选的后台 Chrome 自动化——而无需添加第二个推理循环。ChatGPT 仍是代理;Mac 是执行环境。 主要功能包括: - 通过 /bin/zsh -lc 以登录的 macOS 用户身份执行任意 shell 命令 - 分离的后台任务,带有持久化的 stdout/stderr 日志、状态检查和进程组终止 - 无限制的文件读、写、追加、列表、stat、复制、移动、chmod、符号链接、mkdir 和递归删除 - 通过 git apply 应用统一差异 - 发现和读取存储的 Codex 线程,而无需恢复线程或启动 Codex 模型轮次 - 分页的 Codex 轮次检索,适用于单次响应无法容纳的大历史记录 - 本地 JSONL 审计 - 通过 OpenAI 安全 MCP 隧道的仅出站私有连接,或通过 Cloudflare 隧道以 HTTPS 发布的纯 HTTP 回环前端 - 通过 macOS LaunchAgent 实现按用户持久化 - 故障关闭解锁闩锁:bridge.mjs 在每次工具调用前重新读取解锁文件,因此移除它会使下一次调用被拒绝并退出 - 本地终止开关(scripts/disable.sh),停止前端、桥接器、可选的后台 Chrome 原生主机、分离的 shell_start 任务组、交互式 PTY 会话和联合子 MCP 服务器 可选的后台 Chrome 集成通过一个小型本地扩展操作同一已登录的 Chrome 配置文件,将自动化保持在后台而不抢占焦点。它管理一个持久化的标签页池(默认 8 个,最大 32 个),具有基于租约的访问、10 分钟后的空闲回收和自愈容量。通过 shell_exec 直接控制 Chrome 始终被拒绝,并返回 CHROME_BACKGROUND_REQUIRED,以在结构上强制无焦点抢占边界。对于常规 HTTP/HTTPS 工作,默认是宽松访问;严格审批模式增加了按站点的 URL 授权,TTL 为 15 分钟。 交互式终端会话使用由核心 Perl 辅助程序(lib/ptyhelper.pl)分配的真实 PTY,并提供启动、读取、写入、调整大小、发送信号和关闭会话的工具。强制 1024 字节的规范模式行限制,并使用固定环形缓冲区保留最近的输出。 该项目还包括实验性功能:一个 ChatGPT 对话启动工具(chatgpt_conversation_start),通过已登录页面的第一方运行时操作启动或继续消费者 ChatGPT 对话,无需 UI 输入或凭据导出;以及一个单独的 /v1/responses 适配器,用于显式 OpenCodex 模型(chatgpt-browser 和 chatgpt-sol),从 Responses 指令/输入重建无状态轮次,并通过固定 JSON 决策协议呈现工具。 安全考虑:该桥接器有意赋予 MCP 客户端 macOS 用户的有效权限。它未沙箱化,也没有命令或路径白名单。用户被指示在启用前阅读 SECURITY.md。严格审批模式可用于更严格的浏览器/应用工作流控制,菜单栏应用提供实时切换。 该项目以 MIT 许可证发布,是一个独立的开源项目,不是 OpenAI 或 Cloudflare 的官方产品。