Token导航 LogoToken导航TokenDH.com
Codex Review Server logo
开发工具stdio官方级别未说明来源级核验

Codex Review Server

MCP Server

一个使用OpenAI Codex模型进行跨模型代码审查的MCP服务器,提供自动修复和报告功能。

工具数

3

提示词数

0

GitHub Stars

0

资源数

0
代码审查代码质量PythonClaude开发工具Claude

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

作者 / 组织

bdouble

提供方

bdouble

最后核验

2026/5/17 20:20

运行时

Python

快速接入

先看主来源和安装命令,再打开仓库或文档;下面只保留这个条目的关键接入事实。

命令预览

python3 --version # must be 3.10+

详细介绍

Codex审查MCP服务器

一个MCP服务器,允许Claude Code访问OpenAI的Codex模型,以进行跨模型代码审查。Codex在您的存储库中作为完整代理运行——读取文件、探索依赖关系和理解上下文——与在Codex UI中手动运行它相同。

使用Codex CLI和ChatGPT订阅身份验证。不需要API密钥计费。

它的作用

三种工具,与自然的审查工作流程相匹配:

工具模式发生了什么
codex_review_and_fix审查+自动修复Codex审查更改,自动修复P0-P2问题,报告有问题的模糊问题,列出P3以提高认识
codex_review仅审查相同的审查,没有修复。只读。当你首先想要发现的时候。
codex_fix仅修复应用特定的已批准发现。经过人工审核后的第二次通过。

优先级方案

  • P0(临界):安全漏洞、数据丢失、崩溃、绕过身份验证
  • P1(高):重大错误、逻辑错误、竞争条件、缺少错误处理
  • P2(中等):边缘案例,特定条件下的潜在问题
  • P3(低):细微改进、建议(从不自动修复)

自动修复规则

对于P0-P2发现:

  • 明确的 (自信、明显的解决方案)→ 自动修复
  • 有问题 (歧义、权衡、需求背景)→ 报告了食品法典委员会的问题,未解决

P3的发现总是只报告,从不固定。

先决条件

1.Python 3.10或更高版本

python3 --version  # must be 3.10+

# macOS
brew install python@3.14

2.Codex CLI

# macOS
npm i -g @openai/codex

# Verify
codex --version

看 对于其他平台。

3.ChatGPT订阅

Codex CLI通过您的ChatGPT帐户进行身份验证(外加每月20美元或Pro每月200美元)。不需要单独的API密钥。

codex login  # opens browser, sign into ChatGPT

凭据存储在 ~/.codex/config.toml.重新运行 codex login 如果您的会话到期。

4.克劳德密码

从以下位置安装 claude.ai/code 如果你还没有。

安装

第一步:克隆

git clone https://github.com/bdouble/codex-review-server.git ~/.claude/mcp/codex-review-server

步骤2:设置虚拟环境

cd ~/.claude/mcp/codex-review-server
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
deactivate

步骤3:使用Claude Code注册

# Global (available in all projects — recommended)
claude mcp add --scope user codex-review-server -- \
  ~/.claude/mcp/codex-review-server/.venv/bin/python3 \
  ~/.claude/mcp/codex-review-server/server.py

# Or project-scoped (current repo only)
claude mcp add codex-review-server -- \
  ~/.claude/mcp/codex-review-server/.venv/bin/python3 \
  ~/.claude/mcp/codex-review-server/server.py

步骤4:验证

开始a Claude Code会话(MCP服务器在会话开始时加载)并询问:

What MCP tools are available from codex-review-server?

克劳德应该列出 codex_review_and_fix, codex_review,以及 codex_fix.

配置

所有设置都是可选的。默认值开箱即用。

cd ~/.claude/mcp/codex-review-server
cp .env.example .env
# Edit .env as needed

配置为 实时重新加载 每次工具调用。编辑 .env 会话中期和下一次调用使用新值,无需重新启动。

您还可以在中设置值 .claude/settings.json (环境变量覆盖 .env):

{
  "env": {
    "CODEX_REVIEW_MODEL": "gpt-5.3-codex",
    "CODEX_REVIEW_REASONING": "xhigh"
  }
}

配置参考

变量默认值描述
CODEX_REVIEW_HOME~/.codexCodex CLI主目录(config.toml+凭据)
CODEX_REVIEW_MODELgpt-5.3-codexOpenAI模型ID(必须以开头 gpt-o)
CODEX_REVIEW_REASONINGxhigh推理努力: none, low, medium, high, xhigh
CODEX_REVIEW_TIMEOUT1500超时时间(秒)(默认值为25分钟——支持回购的审查是彻底的)
CODEX_REVIEW_FOCUSall评审重点: bugs, security, performance, all

推理努力水平

级别使用时间
none快速语法检查
low简单、明显的问题
medium通用代码审查
high复杂的逻辑、安全
xhigh深入分析,发现细微的错误(默认)

“成本”是ChatGPT速率限制消耗,而不是计费。所有使用均由您的订阅支付。

多个Codex账户

如果您维护多个ChatGPT订阅,请设置 CODEX_REVIEW_HOME 指向其他凭据目录:

# In .env
CODEX_REVIEW_HOME=/path/to/other/.codex

每个目录都应该有自己的 config.toml 从跑步 CODEX_HOME=/path/to/other/.codex codex login.

用法

直接工具调用

在任何Claude Code会话中:

Use codex_review_and_fix to review and fix the changes on this branch

Claude使用项目目录和基分支调用MCP工具。Codex作为一个完整的代理运行——读取文件,运行git命令,探索代码库。

使用pm vibecode操作流程

如果你使用 下午维贝科德行动 工作流:

  • /codex-review [ticket-id] --采用线性积分的独立跨模型评审
  • /execute-ticket [ticket-id] --包括法典审查作为第5.5阶段(介于法典审查和安全审查之间)
  • /epic-swarm [epic-id] --在每个并行工单的工作流程中包括食品法典委员会审查

没有此MCP服务器

pm vibecode操作工作流在没有此服务器的情况下完全正常工作。 /execute-ticket 跳过第5.5阶段并添加注释,以及 /codex-review 提供安装说明。

运作原理

Claude Code
    │ (MCP tool call over stdio)
    ▼
server.py (FastMCP)
    │
    ▼
codex exec --model gpt-5.3-codex -c reasoning.effort=xhigh --sandbox read-only
    │ (runs IN the project directory with full file access)
    │ (authenticates via CODEX_HOME/config.toml — ChatGPT subscription)
    ▼
Codex agent explores repo, reviews changes, applies fixes
    │
    ▼
Output captured via -o flag, returned to Claude Code

Codex在您的实际存储库中运行,而不是针对diff blob。它可以读取任何文件、运行git命令、跟踪代码路径和探索依赖关系——与手动使用Codex UI完全相同。

服务器永远不会看到或存储您的ChatGPT凭据。身份验证完全由Codex CLI处理。

故障排除

“未找到Codex CLI”

which codex        # check if installed
npm i -g @openai/codex  # install

“Codex CLI身份验证失败”

codex login  # re-authenticate

“已达到速率限制”

您已达到订阅的速率限制(Plus为30-150条消息/5小时,Pro为300-1500条消息)。工作流程在没有食品法典委员会审查的情况下继续进行。等待几分钟,然后重试,或运行 /codex-review 稍后独立。

要在会话中期切换到其他订阅,请编辑 .env:

CODEX_REVIEW_HOME=/path/to/other/.codex

下一次工具调用将使用新凭据(实时重新加载)。

MCP服务器未出现在克劳德代码中

# Check registration
claude mcp list

# Re-register
claude mcp remove codex-review-server
claude mcp add --scope user codex-review-server -- \
  ~/.claude/mcp/codex-review-server/.venv/bin/python3 \
  ~/.claude/mcp/codex-review-server/server.py

开始a session——MCP服务器在会话开始时加载。

“找不到与mcp匹配的分发”

Python太旧或不使用虚拟环境:

~/.claude/mcp/codex-review-server/.venv/bin/python3 --version  # needs 3.10+

审核超时

具有Repo意识的评论 xhigh 对大差异进行推理可能需要10-20分钟。增加超时时间:

# In .env
CODEX_REVIEW_TIMEOUT=2400  # 40 minutes

独立测试组件

# 1. Test Codex CLI
codex exec "Reply with just hello" --sandbox read-only --skip-git-repo-check --color never

# 2. Test server imports
~/.claude/mcp/codex-review-server/.venv/bin/python3 -c "
import sys; sys.path.insert(0, '$HOME/.claude/mcp/codex-review-server')
from server import server
print(f'Server: {server.name} — OK')
"

卸载

claude mcp remove codex-review-server
rm -rf ~/.claude/mcp/codex-review-server

目录标签

目录标签

代码审查代码质量PythonClaude开发工具本地部署自动修复跨模型

支持客户端

Claude

接入字段

传输方式(transport,传输协议)

stdio

鉴权方式(authType,认证方式)

session

运行时(runtime,运行环境)

Python

工具数量(toolCount,工具数)

3

资源数量(resourceCount,资源数)

0

提示词数量(promptCount,提示词数)

0

权限和风险

stdiosession部署方式未说明

接入前请确认传输方式、认证方式和部署位置,并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

来源信息

继续浏览同类 MCP