SuperAPI AI 工具集

cos-codex-bridge

CoS Codex Bridge 是一个本地 MCP(Model Context Protocol)服务器,旨在让 Chief of Staff 类客户端能够查找、创建和注册 Codex 项目,提交完整提示词,追踪持久回执,继续已有任务,并在受限范围内组织工作。它支持 Codex 和可选的 Claude Code CLI 路线,使用本地项目文件夹和保存的 CLI 会话。核心版本免费使用 MIT 协议,但需要用户已有的 Codex 或 Claude Code 访问权限才能实际执行。它提供明确的目录白名单、只读默认执行、本地明文回执、十种 bridge_* 工具,以及通过 npm 或源码安装的灵活方式。

访问官网

工具介绍

用途

CoS Codex Bridge 是一个本地 MCP 服务器,让 Chief of Staff 客户端能够发现 Codex 任务、创建项目工作、投递完整提示词、跟踪进度并继续同一会话。它还提供可选的 Claude Code CLI 路线,使用本地项目文件夹和保存的 CLI 会话。

主要能力

  • 将研究或产品想法转化为新的 Codex 项目和任务。
  • 发送完整的提示词和附加文本,无需手动复制粘贴。
  • 查找现有 Codex 任务,读取进度并继续同一会话。
  • 使用持久回执跟踪投递,而非假设已接受的提示词已运行。
  • 在已批准的项目中重命名、分配、固定和取消有范围的工作。
  • 通过显式允许列表目录限制本地项目访问。
  • Claude Code 路线(beta):将 provider:"claude-code" 传递给 bridge_projects、bridge_sessions 和 bridge_submit,即可启动并继续 Claude Code CLI 工作。

使用方式

安装要求:Node.js 22+、npm、本地已认证的 Codex CLI 和/或 Claude Code CLI,以及支持 stdio MCP 的本地客户端。Codex Desktop 注册还需要 macOS 上的 Codex Desktop。

安装步骤:

  1. 从 GitHub 克隆仓库或使用 npm 安装固定版本。
    • 稳定版(仅 Codex):npm install @0.1.4
    • Beta 版(Codex + Claude Code CLI):npm install @0.2.0-beta.1
    • 或 git clone https://github.com/AV-Labs-Co/cos-codex-bridge
  2. 运行本地安装程序,生成私有配置、启动器和 MCP 片段,位于 ~/.local/share/cos-codex-bridge。
  3. 将生成的 mcp-client.json 粘贴到客户端的 MCP 配置中。
  4. 使用 bridge_* 工具。

默认执行是只读的;使用 --write 仅用于已批准的项目编辑。选择特定的项目根目录,切勿使用整个主目录。如果 CLI 不在 MCP 客户端的 PATH 中,添加 --codex /absolute/path/to/codex 或 --claude /absolute/path/to/claude。

适用场景

  • 将研究想法转化为 Codex 项目并跟踪构建。
  • 向 Codex 发送完整实现简报并监控,然后继续同一任务添加审查发现。
  • 在允许列表文件夹中启动 Claude Code CLI 工作,并继续同一保存的会话。

限制

  • 需要用户已有的 Codex 或 Claude Code 访问权限。
  • Claude Code 路线为 beta 版,本地测试版本为 Claude Code 2.1.269。
  • 已知限制:如果会话已有活动写入者,发送引导提示词时会等待自然暂停/停止点;长时间自主运行可能需要人工点击 Steer。
  • 桌面拥有的暂停队列恢复在 v0.1 中推迟;可能需人工点击 Steer。
  • 新版本 Codex Desktop 的侧边栏渲染未认证;使用前请检查兼容性表。
  • 回执在本地以明文存储,用于保证回执完整性,不应视为加密存储。
  • 直接工作进程禁用继承的连接器并拒绝权限批准。桌面队列使用现有任务的权限和工具,桥接无法在已运行任务内强制执行更窄的沙箱。
  • 不授权自动提交商店、社交发布或出版。
  • 桥接不声称“最先进”、全账户控制或全面自主。