ProBridge

开源本地 MCP 桥接器，用于 ChatGPT desktop Quick Chat + GPT-5.6 Pro。

Codex、OpenCode、Claude 或类似 MCP 主机中的编码代理会调用 ProBridge。ProBridge 将任务加入队列，打开一个已验证的 ChatGPT Quick Chat，并发送提示词。在该 ChatGPT 会话中，LocalAnt / DevSpace 是连接到你本地 Mac 和当前工作区的连接器。

使用 ChatGPT Pro 配额，而非 Codex 模型配额。无需模型 API 密钥。

当前目标平台：macOS。 尚不支持 Windows 和 Linux。欢迎贡献，为这些平台添加真正的驱动程序。

它是如何协同工作的

Codex / OpenCode / Claude
        |
        | MCP tool call
        v
     ProBridge
   prompt · queue · status · follow-up
        |
        | drives ChatGPT desktop Quick Chat
        v
 ChatGPT Quick Chat  (GPT-5.6 Pro)
        |
        | LocalAnt / DevSpace inside ChatGPT
        v
 authenticated device tunnel
        |
        v
 local Mac / active workspace

调用代理只需要三个工具：

gpt56_pro_start({ prompt })
gpt56_pro_status({ jobId })
gpt56_pro_followup({ jobId, prompt })

start 会立即返回一个 jobId。轮询 status。仅在同一个 Quick Chat 轮次完成后使用 follow-up。

Related MCP server: mcacp

本仓库新增了什么

LocalAnt / DevSpace 让 ChatGPT 可以访问你的 Mac。 ProBridge 不会替代该连接器，也无法替你安装它。

ProBridge 为你的编码代理提供了通往 ChatGPT Pro 的桥梁。 MCP 主机向 ProBridge 发送提示词；ProBridge 将其加入队列，驱动 Quick Chat，并通过 MCP 返回任务状态。这就是为什么当你已经希望 ChatGPT Pro 执行本地工作，但又想让 Codex、OpenCode、Claude 或其他代理将其作为子代理调用时，本仓库是有意义的。

环境要求

• macOS

• Node 20+

• Xcode 命令行工具（swiftc）

• 已使用 Pro 登录的 ChatGPT desktop

• 已在 ChatGPT 中连接的 LocalAnt / DevSpace

• 为编译后的 bin/ax-driver 授予辅助功能权限

LocalAnt / DevSpace 赋予 ChatGPT Pro 在机器上的操作能力，而 ProBridge 则让其他代理可以向该 ChatGPT 会话发送工作。

设置 — 两个必需部分

1. 先设置 ChatGPT 的本地连接器

ProBridge 需要 ChatGPT 已经拥有一个可以访问你本地 Mac 的连接器。在安装 ProBridge 之前，请选择一个连接器并完成其上游设置：

• LocalAnt（经过测试的路径）： 按照 LocalAnt 的设置指南 操作。快速入门如下：

npx -y localant setup
localant tools profile coding

localant setup 会打印你已认证的 MCP 端点。在 ChatGPT desktop 中，进入 设置 → 应用与连接器，启用开发者模式，选择连接器 → 创建，粘贴该 MCP 端点，选择身份验证：无，并将连接器命名为 LocalAnt。请根据你的机器情况，保持合适的 LocalAnt 本地审批与安全设置。

• DevSpace： 按照 Waishnav/devspace 项目的说明，将其本地环境连接到 ChatGPT。

在继续之前，打开一个 ChatGPT Quick Chat，验证所选连接器能否读取一个无害的本地项目文件。这是 ChatGPT 端的独立设置；仅安装 ProBridge 不会让 ChatGPT 访问你的 Mac。

2. 在 Mac 上安装 ProBridge

git clone https://github.com/HAMZADEMIR33412005/probridge.git
cd probridge
node scripts/build-ax.mjs
node scripts/install.mjs
node scripts/doctor.mjs

如有需要，install.mjs 会创建 ~/.codex/config.toml，写入 ProBridge MCP 条目，并在现有配置发生变化时生成带时间戳的备份。然后，如果 macOS 有提示，请为 bin/ax-driver 授予辅助功能权限，保持 ChatGPT desktop 打开，并开启一个新的 Codex 对话。

它不会设置 cwd；Codex 应从你已经打开的项目中启动服务器。

用于 Codex 的 MCP

自动：

node scripts/install.mjs

手动：将 examples/codex.config.toml 复制到 ~/.codex/config.toml，并替换服务器绝对路径。

注册的服务器名称是 probridge。在任何更新之后，请开启一个新的 Codex 对话，以便重新加载 MCP 进程和守护进程协议。

用于 Claude Code / OpenCode / 其他主机的 MCP

将 stdio MCP 服务器指向此检出目录：

{
  "mcpServers": {
    "probridge": {
      "command": "/Applications/ChatGPT.app/Contents/Resources/cua_node/bin/node",
      "args": ["/ABS/PATH/TO/probridge/src/server.mjs"]
    }
  }
}

参见 examples/claude-code.mcp.json 和 examples/opencode.json。如果 ChatGPT 自带的 Node 缺失，任何 Node 20+ 二进制文件都可以使用。

MCP 主机必须从项目工作区启动服务器，或者只提供一个 file:// 根目录。ProBridge 会拒绝 home、Desktop、Documents 以及类似的范围过大的文件夹。

使用方法

从项目工作区中的代理执行：

gpt56_pro_start({
  prompt: "Inspect the failing tests, fix the root cause, run focused tests, and report changed files."
})

轮询：

gpt56_pro_status({ jobId: "pro_..." })

在同一个 Quick Chat 完成后继续：

gpt56_pro_followup({
  jobId: "pro_...",
  prompt: "Now implement the review findings."
})

任务会排队。一旦前一个提示词被确认已提交，就可以发送第二个 New chat。后续消息会保持在同一个对话中。

状态存在于两个位置：

• ~/.chatgpt-pro-subagent/ — 守护进程的权威状态、队列和锁

• <workspace>/.chatgpt-pro-jobs/<jobId>.md — ChatGPT 通过 LocalAnt / DevSpace 写入的协作控制文件

相关项目

• LocalAnt — ChatGPT 的本地 MCP 网关 / 计算机连接器

• DevSpace — 与 ChatGPT 配合使用的本地环境 / 计算机连接器

平台支持

MCP 服务器、队列和控制文件协议与操作系统无关。其他平台缺失的只是一个可信的 src/native/ax-driver.swift 替代品。

安全

ProBridge 驱动你已经登录的 ChatGPT 应用，然后 ChatGPT 通过 LocalAnt / DevSpace 操作工作区。请将其视为同一用户的本地执行，而非沙箱。

~/.chatgpt-pro-subagent 下的运行时文件是私有的（0700 / 0600）。工作区任务文件在可能的情况下会通过 .git/info/exclude 从 git 中排除。范围过大的个人文件夹会被拒绝作为工作区。

开发

npm test
npm run build:ax
node scripts/doctor.mjs

许可证

MIT