zoeynine/Local-Codex-Bridge

让 ChatGPT 通过 MCP 调用本机原生 Codex 会话的轻量 Windows 桥接器。

About Local-Codex-Bridge

A thin MCP control bridge from ChatGPT to native Codex sessions.

Local Codex Bridge 是一个面向 Windows 的轻量 MCP stdio 桥接器：它让 ChatGPT（或其他 MCP 客户端）能够调用本机原生 Codex 会话，同时把真正的线程、回合、历史记录和执行能力继续交给官方 Codex app-server 管理。

它解决的是一个很具体的问题：ChatGPT 适合对话、拆解目标和持续监督，Codex 则能在本机工作区里使用真实的文件、命令和开发工具。Bridge 在两者之间提供 7 个边界清楚的控制工具，不再额外发明一套任务系统。

本版本完成监督与控制边界加固，进一步明确超时、重复请求 ID 与待响应请求的安全语义。当前仍仅声明支持 Windows。

换句话说，Local Codex Bridge 是提供给 ChatGPT 的 MCP Server；Codex app-server 是 Bridge 在内部驱动原生 Codex 的官方协议进程。它们不是同一个接口，也不是两套并行的任务系统。

当工具首次需要原生 Codex 时，Bridge 会懒启动一个官方 app-server 子进程。Bridge 自己不创建 job ID、不维护队列、不保存第二份对话历史，也不会自动重试或自动重启意外退出的 app-server。

工具 用途 重要边界 --- --- --- codexthreads 列出、搜索或读取原生 Codex 持久线程 cwd 和搜索词只是筛选条件，不是权限边界；不会重建已经丢失的 Bridge 实时事件 codexturn 新建或恢复线程，并启动一个回合 新线程必须提供绝对 Windows 盘符路径；返回“已接受”不等于任务完成 codexobserve 读取有界的实时事件、待处理请求、终态和游标 waitms 最长 10 秒，只做一次事件驱动等待；安静不代表卡死 codexsteer 向同一个活动回合追加纠正或新意图 必须匹配准确的 threadid 和 expectedturnid；不会新建回合 codexrespond 回答真实的审批、用户输入、权限或 elicitation 请求 必须使用原始 request ID 及准确的线程、方法和回合范围；不能虚构请求 codexinterrupt 中断准确的活动线程与回合 只发送原生 turn/interrupt；不会停止或重启 Bridge / app-server codexcheckpoint 为长任务保存可选、精简且有界的监督锚点 不是转录、日志、任务 ID 或 Codex 历史；原始目标、约束和验收条件初始化后不可变

所有工具都公开对象输入 schema，以及 MCP 的只读、破坏性、幂等和 open-world 提示。完整字段和限制以 src/tools.ts 为准。

- Windows - Node.js 24 或更高版本 - 官方 Codex 可执行文件：可以直接通过 codex 命令找到，也可以用 CODEXEXE 指定

如果你把仓库交给 Codex、Claude Code、Kimi 或其他本地 AI Agent，请让它先阅读本页和 AGENTS.md，检查目标机器上真实的 Node.js、Codex、路径及可选 Tunnel 环境，再按实际情况适配；不要照抄示例路径、profile、端口或配置。

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/zoeynine--Local-Codex-Bridge.html)

Related MCP servers