适合谁
- 希望将 Codex CLI 集成到 AI 辅助编辑器的开发者。
- 需要自动化代码分析或编辑的团队。
- 寻求在 MCP 生态系统中使用 Codex 模型的用户。
C
46FMRS · D
该项目在 GitHub 上获得积极评价，社区认可其功能。v1.2.4 增强了 Windows 兼容性，并提供了详细的文档。安全性方面需注意沙箱配置。
Codex MCP Tool 是一个开源的模型上下文协议 (MCP) 服务器，它将您的 IDE 或 AI 助手（如 Claude、Cursor）连接到 Codex CLI。它支持通过 codex exec 进行非交互式自动化，通过审批进行安全的沙箱编辑，以及通过 @ 文件引用进行大规模代码分析。它专为可靠性和速度而设计，提供进度更新流、支持结构化变更模式（OLD/NEW 补丁输出），并与标准的 MCP 客户端无缝集成，适用于代码审查、重构、文档和 CI 自动化。
工具能力
ask-codex
通过 `codex exec` 向 Codex 发送提示词，支持 `@` 文件引用、模型选择、沙箱和审批策略、变更模式，并自动添加 `--skip-git-repo-check` 标志。
brainstorm
使用结构化方法生成创新想法，支持多种框架（如 SCAMPER、设计思维）和领域特定上下文，并提供可行性、影响和创新评分。
ping
简单的测试工具，用于验证 MCP 连接是否正常。
help
显示 Codex CLI 的帮助文本和可用命令。
fetch-chunk
从变更模式的响应中检索缓存的块，用于分页大型结构化编辑响应。
timeout-test
测试工具，用于测试超时预防机制。
安装接入
- 确保已安装 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"]
}
}
}
选型与风险
不适合谁
- 需要官方 OpenAI 支持或背书的用户。
- 不使用 Codex CLI 或 Node.js 的用户。
- 需要完全无需人工干预且高风险自动化的用户（如 yolo 模式，不推荐）。
所需权限
- 需要访问文件系统以读取代码文件（取决于沙箱模式）。
- 在 `workspace-write` 模式下可以修改工作区文件。
- 在 `danger-full-access` 模式下具有完全系统访问权限（不推荐）。
- 可能需要网络访问（取决于配置和任务）。
风险与副作用
- 沙箱模式设置为 `danger-full-access` 或 `yolo` 时，可能造成意外修改或数据丢失。
- 自动执行代码编辑可能引入错误或安全问题。
- Codex CLI 需要认证，可能涉及 API 费用。
- 使用 `@` 文件引用时可能暴露敏感代码内容。
常见排障
- 出现超时错误时，设置环境变量 `MCP_TOOL_TIMEOUT`（毫秒）。
- 文件写入权限错误时，检查沙箱模式是否为 `read-only`，建议使用 `workspace-write`。
- Codex CLI 未找到时，确保已全局安装并认证。
- Windows 上遇到 ENOENT 错误，更新到 v1.2.4+ 或遵循文档中的故障排除指南。
使用场景
从 MCP 客户端询问 Codex 问题或进行头脑风暴。
分析代码库、文件或目录，并获取解释或建议。
安全地编辑代码，支持审批和沙箱模式。
执行大规模代码分析，使用 `@` 文件引用。
自动进行代码审查、重构、文档编写和 CI 集成。
支持客户端
Claude Desktop完整支持
Claude Code完整支持