AI导哈

Codex CLI集成服务

MCP Server用于将Codex CLI集成到Claude Code工作流程中，提供会话管理和实时进度监控功能。

  • by FYZAFH
  • TypeScript
  • 本地部署
  • 166 星标
  • 更新于
在 GitHub 查看 FYZAFH/mcp-codex-dev

使用说明

mcp codex开发

English | 中文

用于集成的MCP服务器 Codex CLI 将Claude Code工作流与会话管理和实时进度监控相结合。

安装

先决条件： Codex CLI 安装和配置。

在.mcp.json文件中

{
  "mcpServers": {
    "mcp-codex-dev": {
      "command": "npx",
      "args": ["-y", "mcp-codex-dev"]
    }
  }
}

或

claude mcp add mcp-codex-dev -- npx -y mcp-codex-dev

Windows操作系统：

{
  "mcpServers": {
    "mcp-codex-dev": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "mcp-codex-dev"]
    }
  }
}

或

claude mcp add mcp-codex-dev -- cmd /c npx -y mcp-codex-dev

工具

工具 说明
exec 无模板的干净对话，支持会话恢复
tdd 具有内置测试驱动开发提示模板的Codex CLI
review 代码审查（规范+质量并行），支持简历
health 环境和配置诊断
session_list 列出跟踪的会话
session_discard 放弃会话

配置

创建 ~/.mcp/mcp-codex-dev/config.json:

{
  "model": "gpt-5.2",
  "sandbox": "danger-full-access",
  "timeout": 300000,
  "tools": {
    "tdd": { "model": "gpt-5.3-codex", "sandbox": "danger-full-access", "timeout": 2000000},
    "review": { "model": "gpt-5.2", "sandbox": "danger-full-access", "timeout": 3000000},
    "health": { "enabled": false }
  }
}

顶层 model / sandbox / timeout 是全局默认值。这 tools 每个工具的部分覆盖（按工具名称键入）。集 "enabled": false 禁用工具。

每个项目的配置可以放置在 <project>/.mcp/mcp-codex-dev.config.json.

进度服务器

本地HTTP服务器从以下位置开始 http://localhost:23120 显示实时进度。可通过以下方式配置 progressPort.

当多个MCP服务器实例同时运行时，它们共享一个进度页面：第一个实例绑定端口并为UI提供服务，其他实例将其进度事件转发给它。

会话跟踪

会话跟踪元数据按项目存储在 <project>/.mcp/mcp-codex-dev/sessions.json （其中 <project> 是Git仓库根目录（如果适用）。

Codex CLI自己的会话文件保留在 ~/.codex/sessions/<id>/.

许可证

没有执照。

相关 MCP