Codex工具服务

一个将OpenAI Codex CLI作为Claude Code工具的MCP服务器,提供代码执行、分析、审查、安全审计等功能。

  • by panuhen
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 panuhen/codex-mcp

使用说明

codex mcp

MCP服务器公开 OpenAI Codex命令行界面 作为Claude Code的工具。

工具

工具 说明
codex_exec 在任何提示下运行Codex
codex_ask 只读问题和代码分析
codex_review 针对分支、提交或未提交的更改进行代码审查
codex_security_audit 基于OWASP的安全审计
codex_brainstorm 多视角设计探索
codex_resume 继续之前的任何食典会议

先决条件

  • Python 3.11+
  • Codex CLI 已安装并位于PATH中

安装

git clone https://github.com/panuhen/codex-mcp.git
cd codex-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e .

在Claude代码中配置

添加到您的Claude Code MCP设置中(~/.mcp.json 或项目级别 .mcp.json):

{
  "mcpServers": {
    "codex": {
      "command": "/absolute/path/to/codex-mcp/.venv/bin/codex-mcp"
    }
  }
}

替换 /absolute/path/to/codex-mcp 使用克隆仓库的实际路径。

使用Codex配置文件(例如Azure OpenAI)

如果您在中配置了配置文件 ~/.codex/config.toml (例如a azure 使用自定义模型提供商的配置文件),pass --profile 通过 args 并通过提供所需的API密钥 env:

{
  "mcpServers": {
    "codex": {
      "command": "/absolute/path/to/codex-mcp/.venv/bin/codex-mcp",
      "args": ["--profile", "azure"],
      "env": {
        "AZURE_OPENAI_API_KEY": "your-api-key-here"
      }
    }
  }
}

如果API密钥已经在您的外壳配置文件中导出(例如。 export AZURE_OPENAI_API_KEY=... 在 ~/.bashrc),您可以跳过 env 完全封锁:

{
  "mcpServers": {
    "codex": {
      "command": "/absolute/path/to/codex-mcp/.venv/bin/codex-mcp",
      "args": ["--profile", "azure"]
    }
  }
}

您还可以通过以下方式设置配置文件 CODEX_PROFILE 环境变量而不是 args.

可以通过传递其他codex配置覆盖 -c:

{
  "mcpServers": {
    "codex": {
      "command": "/absolute/path/to/codex-mcp/.venv/bin/codex-mcp",
      "args": ["--profile", "azure", "-c", "model=\"o3\""]
    }
  }
}

重新启动Claude Code,Codex工具将可用。

使用示例

配置后,Claude Code可以直接使用这些工具:

  • “查看我未提交的更改” --触发器 codex_review
  • “在src/上运行安全审核” --触发器 codex_security_audit
  • “集思广益缓存方法” --触发器 codex_brainstorm
  • “询问Codex身份验证模块是如何工作的” --触发器 codex_ask

会话可以继续 codex_resume 使用 session_id 由任何工具返回。

许可证

麻省理工学院