openai-codex-mcp

基本能力

产品定位

openai-codex-mcp 是一个中间件服务，旨在将 OpenAI Codex CLI 工具的功能集成到 Claude Code 中，提供代码生成、解释和调试的能力。

核心功能

1. 代码生成：通过 write_code 方法生成指定语言的代码。
2. 代码解释：通过 explain_code 方法解释代码的工作原理。
3. 代码调试：通过 debug_code 方法查找和修复代码中的错误。
4. 模型选择：支持多种 OpenAI 模型，包括 O 系列和 GPT 系列模型。

适用场景

1. 开发辅助：快速生成代码片段或函数实现。
2. 学习工具：解释复杂代码的逻辑和结构。
3. 调试助手：帮助开发者识别和修复代码中的错误。

工具列表

1. codex_server：MCP 服务器的主程序，提供 JSON-RPC 接口。
2. setup_and_run.sh：自动化脚本，用于设置环境和启动服务器。
3. Claude CLI：用于注册和管理 MCP 工具的命令行工具。

常见问题解答

1. 依赖问题：确保已安装 Python 3.12+ 和 OpenAI Codex CLI 工具。
2. API 密钥：需要有效的 OpenAI API 密钥来使用 Codex CLI。
3. 服务器启动：如果服务器无法启动，检查端口是否被占用或依赖是否安装正确。

使用教程

使用依赖

1. 安装 Python 3.12+。
2. 安装 OpenAI Codex CLI 工具： bash npm install -g @openai/codex
3. 获取有效的 OpenAI API 密钥。

安装教程

1. 创建并激活虚拟环境： bash uv venv source .venv/bin/activate
2. 安装依赖： bash uv pip install .

调试方式

1. 启动服务器： bash codex_server 或使用 uvicorn 直接启动： bash uvicorn codex_server:app
2. 测试 API 接口： bash curl -X POST http://localhost:8000/ -H 'Content-Type: application/json' -d '{"jsonrpc": "2.0", "method": "write_code", "params": {"task": "Calculate the first 100 Fibonacci numbers", "language": "python"}, "id": 1}'

许可证

该项目遵循 Other 开源许可条款，请参阅 Other 了解完整条款。