科学工具
科学工具让世界更美好
让世界更美好

MCP服务器 codex-as-mcp:让 Claude Code、Cursor 等 AI 工具调用 OpenAI Codex 执行任务

codex-as-mcp作为一个MCP (Model Control Protocol) 服务器,让 Claude Code、Cursor 等 AI 工具能调用 OpenAI 的 Codex 进行任务执行,为相关订阅用户提供无需额外费用的GPT-5使用优化,通过codex_execute实现通用Codex任务执行以及codex_review进行专业的代码审查,提供了两种操作模式以兼顾功能与安全性:“安全模式”默认为只读,有效保护用户环境;通过--yolo标志启用的“可写模式”则提供完整的Codex功能。codex-as-mcp采用顺序执行机制来防止并行代理操作可能引发的冲突,确保运行的稳定性,需依赖特定版本的Codex CLI进行配置和使用。

扩展能力:为 Claude 等工具添加强大的代码执行能力。

成本优化:对 OpenAI Plus/Pro/Team 订阅者友好,可最大化利用 GPT-4o 而无需额外费用。

codex-as-mcp 快速上手

1、安装 Codex CLI

# 安装或升级到最新版
npm install -g @openai/codex@latest

# 登录
codex login

# 验证版本 (需 >= 0.25.0)
codex --version

2、配置 MCP

在你的 .mcp.json 文件中添加以下配置:

安全模式 (默认)

{
  "mcpServers": {
    "codex": {
      "type": "stdio",
      "command": "uvx",
      "args": ["codex-as-mcp@latest"]
    }
  }
}

可写模式 (谨慎使用):

{
  "mcpServers": {
    "codex": {
      "type": "stdio",
      "command": "uvx",
      "args": ["codex-as-mcp@latest", "--yolo"]
    }
  }
}

或者使用 Claude Code 命令快速添加:

# 安全模式
claude mcp add codex-as-mcp -- uvx codex-as-mcp@latest

# 可写模式
claude mcp add codex-as-mcp -- uvx codex-as-mcp@latest --yolo

codex-as-mcp 核心功能

服务器提供两个核心工具:

codex_execute(prompt, work_dir): 通用的代码执行工具。

codex_review(review_type, work_dir, target?, prompt?): 专业的代码审查工具。

安全机制

安全模式 (默认):仅允许只读操作,保护你的环境。

可写模式 (--yolo):开放完整的写入和执行权限。

串行执行:防止多个代理并行操作导致的冲突。

本地开发测试

如果需要本地调试,可以运行:

uv run mcp dev src/codex_as_mcp/server.py