Codex Review Server MCP Server安装配置 GitHub与使用方法

选型结论

Codex Review Server 属于开发工具类 MCP Server，公开资料标注 3 个工具，通过stdio 本地进程接入，适配 Claude，有可以直接复制的安装命令；接入前要先准备会话凭据。

分类

开发工具

传输方式

stdio

认证方式

会话凭据

部署方式

公开资料未说明

安装与配置

安装命令

python3 --version # must be 3.10+

客户端配置示例

{
  "mcpServers": {
    "codex-review-server": {
      "command": "python3",
      "args": [
        "--version",
        "#",
        "must",
        "be",
        "3.10+"
      ]
    }
  }
}

按公开安装命令拼出来的示例，字段名和参数以仓库 README 为准；带 YOUR_API_KEY 这类占位符的位置记得换成自己的值。

上手步骤

1
准备运行环境
stdio 服务在本地起进程，需要先装好 Python，再按安装命令拉取依赖。
2
安装服务
复制下面的安装命令执行；命令里带占位符的位置换成自己的密钥或路径。
3
写入客户端配置
在客户端的 MCP 配置里填启动命令和参数，保存后完全退出客户端再打开，让新配置生效。
4
验证是否可用
连接成功后客户端会列出 3 个工具，随便调一个只读工具确认能返回结果。

接入前确认

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

详细介绍

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`	`~/.codex`	Codex CLI主目录（config.toml+凭据）
`CODEX_REVIEW_MODEL`	`gpt-5.3-codex`	OpenAI模型ID（必须以开头 `gpt-` 或 `o`)
`CODEX_REVIEW_REASONING`	`xhigh`	推理努力： `none`, `low`, `medium`, `high`, `xhigh`
`CODEX_REVIEW_TIMEOUT`	`1500`	超时时间（秒）（默认值为25分钟——支持回购的审查是彻底的）
`CODEX_REVIEW_FOCUS`	`all`	评审重点： `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

工具与能力

工具数量

3

资源数量

0

提示词数量

0

能力标签

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

支持客户端

Claude

数量来自来源目录的标注，具体工具清单以官方文档为准。

典型使用场景

让助手直接读代码

把仓库、提交记录和 issue 交给模型检索，补全和重构时不用来回复制文件。

在对话里跑命令

触发构建、测试和脚本，执行结果直接回到上下文，省去切终端。

接进开发流程

把 PR、CI 状态和代码审查接进助手，减少在几个工具之间跳。

选择建议

值得选的地方

只提供 3 个工具，职责集中，接入后不容易误操作。
有现成的安装命令，不用自己找入口，照着跑就能起服务。
公开说明写得比较完整，接入前能看清能力边界。

先想清楚的地方

stdio 方式要求本地装好 Python，换机器要重新装一遍。
需要自备会话凭据，没有凭据没法直接试。
公开摘要偏短，具体能力和限制要回到仓库确认。

更适合

需要在开发工具场景里让模型直接调用外部能力的人。
已经在用 Claude 的用户，接入路径最短。
想先快速试一下、能接受在本地跑服务的人。

不太适合

完全不想在本地装环境的人。
暂时拿不到会话凭据的人。
需要厂商级 SLA 和技术支持的生产环境。

MCP Server	工具数	传输方式	安装命令	收录来源	最后核验
Codex Review Server MCP World · 本页	3	stdio	有	1 个	2026-05-17
Git 838e2ec1 MCP World	12	stdio	有	2 个	2026-05-17
Markitdown MCP 2c653a5f MCP World	1	stdio	有	1 个	2026-05-17
Context7 MCP C671e75a MCP World	0	stdio	有	1 个	2026-05-17
Context7 831acf40 MCP World	0	stdio	有	1 个	2026-05-17

常见问题

5 条

Codex Review Server 怎么安装？

公开资料给出的安装命令是 python3 --version # must be 3.10+，运行环境为 Python。装完后按客户端要求写进 MCP 配置，重启客户端生效。

Codex Review Server 怎么在 Claude Desktop、Cursor 里配置？

它是stdio 本地进程，客户端配置里要写启动命令和参数，运行环境是 Python；保存后完全退出客户端再打开，配置才会生效。

Codex Review Server 收费吗？

本站只整理公开资料，不代收费用，也没有标注具体价格。是否收费取决于服务本身和背后的接口额度，正式使用前按官方说明确认。

Codex Review Server 需要 API Key 吗？

公开资料标注的认证方式是会话凭据，也就是要先拿到凭据才能连上；凭据只填在自己本地的配置里，不要写进公开仓库。

Codex Review Server 支持哪些客户端？

公开资料标注支持 Claude；其他客户端只要能配置 MCP Server，也能用同样的命令或地址接入。

来源信息

MCP World

codex-review-server

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

www.mcpworld.com

/detail/edbbe1baace70fd1e38ea081595a60a3

参考链接

仓库入口

github.com

/bdouble/codex-review-server

来源标签