STARWARCLOUD STARWAR.AI
返回市场
代码CLI MCP工具

代码CLI MCP工具

作者：Mr-Tomahawk20 星标更新：2025-08-19
安装使用来源：spider==github.com

项目介绍

Codex CLI MCP 服务器

一个允许 Claude Code 与 OpenAI Codex CLI 进行交互的 MCP 服务器。如果你拥有 ChatGPT 订阅和 Claude Code 订阅，你可以使用此工具来同时享受两者的好处，因为价值 $20 的 ChatGPT 订阅可以让你免费访问 Codex CLI 中的 GPT-5 模型。

特性

  • 完整的 Codex 集成：通过 MCP 访问所有 Codex CLI 功能。
  • GPT-5 模型：由 OpenAI 最强大的模型驱动。
  • 沙箱安全：可配置执行模式（只读、工作区写入、完全访问）。
  • 进度跟踪：长时间运行操作的实时更新。
  • Git 集成：将 Codex 生成的差异直接应用于仓库。
  • 灵活配置：支持环境变量和配置文件。

安装

  1. 安装 Codex CLI（必需）：

    npm install -g @openai/codex

  2. 使用 npx 将其添加到 Claude Code：

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

    或者先全局安装：

    npm install -g codex-cli-mcp-tool

  3. 配置认证：

    # 选项 1：使用 API 密钥
export OPENAI_API_KEY=your-api-key

# 选项 2：使用 ChatGPT 账户登录
codex login

可用工具

ask-codex

执行 Codex，支持全面的参数用于代码分析、生成和辅助。

参数：

  • prompt（必需）：你的查询或指令
  • model（可选）：gpt-5（默认且唯一支持的模型）
  • sandbox（可选）：read-only, workspace-write, danger-full-access
  • approval（可选）：untrusted, on-failure, on-request, never
  • image（可选）：要包含的图像文件路径
  • config（可选）：配置覆盖
  • timeout（可选）：最大执行时间

示例：

ask-codex "解释这段代码：@main.py" sandbox="read-only"

exec-codex

非交互式 Codex 执行，适用于自动化工作流。

参数：

  • prompt（必需）：命令或指令
  • model（可选）：始终为 gpt-5
  • sandbox（可选）：沙箱模式
  • timeout（可选）：执行超时

apply-diff

将最新的 Codex 生成的差异应用到你的 Git 仓库。

参数：

  • dryRun（可选）：预览更改而不应用
  • validate（可选）：在应用前验证

实用工具

  • ping：测试 MCP 连接
  • help：显示详细的帮助信息
  • version：显示版本信息

配置

环境变量

OPENAI_API_KEY=sk-...           # OpenAI API 密钥
CODEX_MODEL=gpt-5               # 默认模型
CODEX_SANDBOX_MODE=read-only    # 默认沙箱模式

配置文件 (~/.codex/config.toml)

[model]
provider = "openai"
default = "gpt-5"
reasoning_effort = "medium"

[sandbox]
default_mode = "read-only"
permissions = ["disk-read-access"]

[approval]
policy = "untrusted"
trusted_commands = ["ls", "cat", "grep"]

沙箱模式

  • 只读：安全探索，不修改文件
  • 工作区写入：项目内的有限修改
  • 危险全访问：系统全访问（需要确认）

示例

代码分析

ask-codex "审查这个函数的安全问题：@auth.py"

代码生成

ask-codex "为 User 类生成单元测试" sandbox="workspace-write"

调试

ask-codex "修复登录函数中的错误" approval="on-request"

文件操作

ask-codex "创建一个新的 React 组件用于用户资料" sandbox="workspace-write"

应用更改

ask-codex "重构这段代码以使用 async/await"
apply-diff validate=true

故障排除

常见问题

  1. Codex CLI 未找到：

    npm install -g @openai/codex

  2. 认证失败：

    # 设置 API 密钥
export OPENAI_API_KEY=your-key

# 或登录
codex login

  3. 权限被拒绝：

    • 使用适当的沙箱模式
    • 检查批准策略设置
    • 验证文件权限

  4. 速率限制：

    • 在重试前等待
    • 检查 OpenAI 账户配额

调试模式

启用调试日志：

DEBUG=true codex-cli-mcp-tool

开发

设置

git clone <repository>
cd codex-cli-tool
npm install
npm run build
npm run dev

测试

npm test
npm run lint

致谢

本项目基于 jamubc 的出色 Gemini MCP 工具。我们借鉴了他们的架构和模式，创建了这个 Codex CLI 集成。

许可证

MIT 许可证 - 详情参见 LICENSE 文件。

贡献

  1. 分叉仓库
  2. 创建功能分支
  3. 进行更改
  4. 添加测试
  5. 提交拉取请求

支持