← 返回目录

Codex MCP Server

社区

将 Codex CLI 连接到 MCP 客户端，实现代码分析与编辑的自动化。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 295 / 438
Stars: ★ 177 热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+
凭据: 无需凭据
许可证: MIT
最近提交: 11 个月前 ⚠
工具数: 6

46FMRS · D

该项目在 GitHub 上获得积极评价，社区认可其功能。v1.2.4 增强了 Windows 兼容性，并提供了详细的文档。安全性方面需注意沙箱配置。

最强项 · 文档质量 12/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

7/20

维护活跃度

11/20

文档质量

12/20

安装易用性

11/20

查看各项评分依据

可靠性 5/20: 仅提供 README 与仓库元数据，未提供源码、测试或 CI 证据，无法验证 MCP 初始化握手、工具列表与真实行为是否一致；README 的自述不可作为可信证据。68 个未关闭 issue 进一步增加不确定性。按静态校准，未执行任何代码，可靠性不超过 12，此处保守给 5。
安全与权限 7/20: 未发现恶意代码、窃取凭据或默认不可逆远程操作的直接证据，因此不触发红色底线。但服务设计为调用 Codex CLI 并支持 full-auto、danger-full-access、approval_policy=never 等高风险配置，源码缺失导致无法审计凭据处理与数据边界；确认机制和最小权限完全依赖外部 Codex 配置，故给 7 分。
维护活跃度 11/20: 仓库未归档、拥有 MIT 许可证，README 显示近期发布 v1.2.4 并有更新日志，但未提供提交历史、issue 响应、依赖更新或安全响应渠道；68 个开放 issue 显示治理压力。活跃度可见但治理/版本管理有缺口，给 11 分。
文档质量 12/20: README 涵盖安装、配置、工具说明、示例、故障排查、平台支持和更新日志，内容较完整；但缺少成本、限制和安全性边界说明，部分徽章指向旧仓库名，且文档本身是自述性证据，无法交叉验证。给 12 分。
安装易用性 11/20: 提供了 npx 一行安装、Claude Desktop/Claude Code 配置示例、全局安装方式和平台支持矩阵，步骤清晰；但未提供 package.json/bin 入口等可验证打包证据，且依赖外部 Codex CLI 安装与认证，按静态校准上限 15 分以下保守给 11 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码访问网络

适合谁

希望将 Codex CLI 集成到 AI 辅助编辑器的开发者。
需要自动化代码分析或编辑的团队。
寻求在 MCP 生态系统中使用 Codex 模型的用户。

不适合谁

需要官方 OpenAI 支持或背书的用户。
不使用 Codex CLI 或 Node.js 的用户。
需要完全无需人工干预且高风险自动化的用户（如 yolo 模式，不推荐）。

所需权限

需要访问文件系统以读取代码文件（取决于沙箱模式）。
在 `workspace-write` 模式下可以修改工作区文件。
在 `danger-full-access` 模式下具有完全系统访问权限（不推荐）。
可能需要网络访问（取决于配置和任务）。

风险与副作用

沙箱模式设置为 `danger-full-access` 或 `yolo` 时，可能造成意外修改或数据丢失。
自动执行代码编辑可能引入错误或安全问题。
Codex CLI 需要认证，可能涉及 API 费用。
使用 `@` 文件引用时可能暴露敏感代码内容。

安装接入

准备工作

运行环境：Node.js 18+

其他可选配置项（1 个）

MCP_TOOL_TIMEOUT 可选 MCP 工具的超时时长（毫秒），用于避免长时间运行的 Codex 任务超时；在 shell 配置文件中按需设置，例如 export MCP_TOOL_TIMEOUT=36000000。

确保已安装 Node.js v18.0.0 或更高版本。
安装并认证 Codex CLI：npm install -g @openai/codex。
使用 npx 方式安装：运行 claude mcp add codex-cli -- npx -y @cexll/codex-mcp-server，或在 Claude Desktop 配置文件中添加上述 JSON 配置。
重启终端或客户端。

claude_desktop_config.json

{
  "mcpServers": {
    "codex-cli": {
      "command": "npx",
      "args": ["-y", "@cexll/codex-mcp-server"]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "codex-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@cexll/codex-mcp-server"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add codex-cli -- npx -y @cexll/codex-mcp-server

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 Claude Code 中输入 /mcp 确认 codex-cli 服务器已激活并出现 ask-codex 等工具；或调用 ping 工具，能回显消息即说明连接正常。

常见排障

出现超时错误时，设置环境变量 `MCP_TOOL_TIMEOUT`（毫秒）。
文件写入权限错误时，检查沙箱模式是否为 `read-only`，建议使用 `workspace-write`。
Codex CLI 未找到时，确保已全局安装并认证。
Windows 上遇到 ENOENT 错误，更新到 v1.2.4+ 或遵循文档中的故障排除指南。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

ask-codex 分析 @src/ 的架构并总结目录结构
用 gpt-5 模型重构 @utils/database.js 以提升性能
brainstorm 用 SCAMPER 方法优化我们的 CI/CD 流程
ping 一下确认 Codex MCP 连接是否正常

工具能力 6

ask-codex 写入

通过 `codex exec` 向 Codex 发送提示词，支持 `@` 文件引用、模型选择、沙箱和审批策略、变更模式，并自动添加 `--skip-git-repo-check` 标志。

brainstorm 只读

使用结构化方法生成创新想法，支持多种框架（如 SCAMPER、设计思维）和领域特定上下文，并提供可行性、影响和创新评分。

ping 只读

简单的测试工具，用于验证 MCP 连接是否正常。

help 只读

显示 Codex CLI 的帮助文本和可用命令。

fetch-chunk 只读

从变更模式的响应中检索缓存的块，用于分页大型结构化编辑响应。

timeout-test 只读

测试工具，用于测试超时预防机制。

使用场景

从 MCP 客户端询问 Codex 问题或进行头脑风暴。

分析代码库、文件或目录，并获取解释或建议。

安全地编辑代码，支持审批和沙箱模式。

执行大规模代码分析，使用 `@` 文件引用。

自动进行代码审查、重构、文档编写和 CI 集成。

支持客户端

Claude Desktop

Claude Code

依据项目文档列出，未经本站实测。

详细介绍

Codex MCP Tool 是一个开源的模型上下文协议 (MCP) 服务器，它将您的 IDE 或 AI 助手（如 Claude、Cursor）连接到 Codex CLI。它支持通过 codex exec 进行非交互式自动化，通过审批进行安全的沙箱编辑，以及通过 @ 文件引用进行大规模代码分析。它专为可靠性和速度而设计，提供进度更新流、支持结构化变更模式（OLD/NEW 补丁输出），并与标准的 MCP 客户端无缝集成，适用于代码审查、重构、文档和 CI 自动化。