Codex MCP Server

在 Claude 与 OpenAI 的 Codex CLI 之间架起桥梁——直接在编辑器中获得 AI 驱动的代码分析、生成与审查。

graph LR
    A[Claude Code] --> B[Codex MCP Server]
    B --> C[Codex CLI]
    C --> D[OpenAI API]

    style A fill:#FF6B35
    style B fill:#4A90E2
    style C fill:#00D4AA
    style D fill:#FFA500

快速开始

1. 安装 Codex CLI

npm i -g @openai/codex
codex login --api-key "your-openai-api-key"

2. 添加到 Claude Code

claude mcp add codex-cli -- npx -y codex-mcp-server

3. 开始使用

Ask codex to explain this function
Use codex to refactor this code for better performance
Use review to check my uncommitted changes

一键安装

工具

| 工具 | 描述 | |------|------| | codex | 支持会话、模型选择和结构化输出元数据的 AI 编码助手 | | review | 针对未提交更改、分支或提交的 AI 代码审查 | | websearch | 使用 Codex CLI 进行网络搜索，可自定义结果数量和搜索深度 | | listSessions | 查看活动对话会话 | | ping | 测试服务器连接 | | help | 获取 Codex CLI 帮助 |

示例

代码分析：

Use codex to analyze this authentication logic for security issues

多轮对话：

Use codex with sessionId "refactor" to analyze this module
Use codex with sessionId "refactor" to implement your suggestions

传入 sessionId 会在首次使用时创建会话，因此 listSessions 会显示该会话（针对此服务器实例），后续调用可以恢复上下文。

代码审查：

Use review with base "main" to check my PR changes
Use review with uncommitted true to review my local changes

高级选项：

Use codex with model "o3" and reasoningEffort "high" for complex analysis
Use codex with fullAuto true and sandbox "workspace-write" for automated tasks
Use codex with callbackUri "http://localhost:1234/callback" for static callbacks
Use codex to return structuredContent with threadId metadata when available

网络搜索：

Use websearch with query "TypeScript 5.8 new features"
Use websearch with query "Rust vs Go performance 2025" and numResults 15
Use websearch with query "React Server Components" and searchDepth "full"

要求

• Codex CLI v0.75.0+ — 使用 npm i -g @openai/codex 或 brew install codex 安装
• OpenAI API 密钥 — 运行 codex login --api-key "your-key" 进行身份验证

Codex 0.87 兼容性

• 线程 ID + 结构化输出：当 Codex CLI 输出 threadId 时，此服务器会在内容元数据和 structuredContent 中返回它，并为结构化响应提供 outputSchema。

文档

• API 参考 — 完整的工具参数和响应格式
• 会话管理 — 对话如何工作
• Codex CLI 集成 — 版本兼容性和 CLI 详细信息

环境变量

• CODEX_MCP_CALLBACK_URI：设置后作为静态 MCP 回调 URI 传递给 Codex（会被 callbackUri 工具参数覆盖）

开发

npm install    # Install dependencies
npm run dev    # Development mode
npm run build  # Build for production
npm test       # Run tests

相关项目

• gemini-mcp-server — 面向 Gemini CLI 的 MCP 服务器，支持 100 万+ token 上下文、网络搜索和媒体分析
• Clotch — macOS 上 Claude Code 的 Dynamic Island — 实时监控跨多台机器和提供商的会话

许可证

ISC