Ask Codex MCP Server

社区

把 Claude 接到 OpenAI Codex CLI，让另一个模型给出代码审查和第二意见。

分类: 开发工具第 227 / 438
Stars: ★ 18 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js 20+
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 今天
工具数: 1

52FMRS · D

这是一个聚焦单一职责的 MCP 服务器：通过 stdio 暴露 ask-codex 工具，把宿主 AI 助手接到 OpenAI Codex CLI 上，用于代码审查、方案辩论和第二意见，默认模型 gpt-6-astra 并在配额受限时回退到 gpt-5.6-terra。安装简单（一条 npx 命令），可配合会话续接。需要注意它并非官方工具，审查内容会发往 Codex 侧，且用量统计仅在内存中；若需要离线或超大上下文能力，应选择同项目中的 Ollama、Gemini 或 Antigravity 服务器。

最强项 · 文档质量 12/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

11/20

维护活跃度

10/20

文档质量

12/20

安装易用性

11/20

查看各项评分依据

可靠性 8/20: 静态审阅仅覆盖 packages/codex-mcp/server.json 与其所引用的 README 章节。清单结构合法（schema 引用、npm registryType、stdio 传输、版本 0.2.0），声明了两个可选环境变量并给出默认值（GMCPT_TIMEOUT_MS=300000、GMCPT_LOG_LEVEL=warn），说明超时与日志可配置，这是可靠性上的正面信号。但仓库材料中没有任何本服务器（ask-codex）的已提交测试、CI 工作流产物或可复现的启动/握手证据，stars 与徽章不作为证据；清单也未声明工具列表、错误码或依赖版本约束，因此无法验证初始化与 tools/list 是否与实现一致。供应商 CLI（Codex）需另行安装并认证，属于外部不可控依赖。按静态校准，可靠性与设置两项在缺少“真实 CI + 已提交测试覆盖关键路径”证据时上限为 12/15，此处取 8：路径看似可行但测试与失败诊断完全不可见，且超时/重试/配额回退（README 提到 Codex 配额回退）无法核实。
安全与权限 11/20: 未触发红线：无恶意代码、无凭据窃取、无隐蔽外传、无默认的不可逆删除/付费/部署/远程命令，示例中也没有真实令牌。清单仅暴露两个非敏感环境变量（超时、日志级别），isSecret 均为 false，字段自洽。数据边界方面 README 明确说明该服务器把提示发送给 OpenAI Codex CLI（外部网络与外部模型处理），也指出 Ollama 路径为本地；但对 ask-codex 本身未在本清单或所给材料中给出数据流披露、工作区读写范围、确认机制或最小权限声明。声明“default: 300000”的 5 分钟超时与日志级别对安全影响中性。由于权限范围、是否可写文件、会话持久化位置均无可核实说明，且外部模型传输缺少可审查的显式确认条款，扣除相应分值；未发现红线，故高于 4。
维护活跃度 10/20: 仓库未归档，license 为 MIT，README 给出 issue 入口与 CONTRIBUTING.md，并展示了 release/CI 徽章与 npm 组织化迁移（@ask-llm/*），说明项目仍在维护并有过版本演进（清单版本 0.2.0）。但所给材料无法核实：提交频率、issue 响应（18 stars / 11 open issues 仅为发现信号，不计分）、依赖更新策略、安全响应渠道、发布流程是否可复现。按“活跃但治理/版本化存在缺口”的锚点取 10：许可与更新路径可见，但所有权、安全响应与发布可验证性均为缺失证据。
文档质量 12/20: README 覆盖面较好：安装方式（Claude Code、Cursor、Codex CLI、Claude Desktop、通用 stdio）、各供应商前置条件与模型默认/回退、工具清单、CLI doctor/repl、包迁移表、文档站点与 llms.txt，并明确披露若干限制（Grok/Ollama 不自动回退、Gemini CLI 的 enterprise 限制、Antigravity 为实验性 one-shot）。但针对被打分对象 ask-codex 的专属文档并不充分：工具参数与返回结构（README 提到 outputSchema、sessionId "" 首次调用可持久化）只在通用章节概述，缺少可逐项核对的参数表、错误语义、成本/配额细节与针对该服务器的排障步骤；也未在本清单中给出工具 schema。属“可用但含隐含假设与排障缺口”，取 12。
安装易用性 11/20: 安装路径清晰：npx -y @ask-llm/codex-mcp 或统一包，均为主流客户端提供了配置文件示例（.cursor/mcp.json、~/.codex/config.toml、claude_desktop_config.json、claude mcp add），并给出 doctor 自检命令与 Node 20+/Linux、macOS 前置条件。扣分点：需额外安装并登录 OpenAI Codex CLI（外部认证步骤，README 仅写“Install and sign in”，无逐步说明）；平台仅声明 Linux/macOS，Windows 未覆盖；两个环境变量为可选未必需；无被打分服务器的端到端连通性验证证据（无已提交测试/CI 证据），故按静态校准不高于 15，取 11。

静态评测 · 未实际运行评测于 2026-09-25

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件执行命令或代码访问网络

适合谁

已经在使用 OpenAI Codex CLI 并希望复用其额度的开发者
希望给 Claude Code、Cursor 等助手增加跨模型第二意见的团队
需要针对具体代码做推理型审查与架构批评的场景

不适合谁

没有 OpenAI/Codex 账号或无法安装 Codex CLI 的用户
需要完全离线、零成本审查的用户（应改选 Ollama 提供商）
需要 100 万级 token 整库读取的用户（应改选 Gemini 或 Antigravity 提供商）
期望按会话持久计费统计或跨会话保留用量记录的用户（用量统计仅在内存中）

所需权限

本机执行 Codex CLI 进程与网络访问（用于 Codex 服务）
读取被要求审查的文件内容，并作为提示词发送给 Codex CLI
在客户端配置目录中写入 MCP 服务器配置
可选读取 GMCPT_TIMEOUT_MS、GMCPT_LOG_LEVEL 环境变量

风险与副作用

被审查的代码片段会被发送到 Codex 所依赖的远程服务，可能不符合数据外发政策
Codex CLI 的模型与配额行为由上游决定，README 中的默认模型（gpt-6-astra → gpt-5.6-terra）可能变化
首次调用不传 sessionId: "" 会得到非可续接的一次性会话，容易造成上下文丢失的困惑
属于非官方第三方工具，与 Anthropic、OpenAI 等公司无关联或背书
长耗时审查可能超过默认 5 分钟超时而被中断

安装接入

准备工作

运行环境：Node.js 20+

其他可选配置项（2 个）

GMCPT_TIMEOUT_MS 可选 Codex CLI 执行的超时时间（毫秒），默认 300000，即 5 分钟。

GMCPT_LOG_LEVEL 可选日志详细程度：debug、info、warn、error，默认 warn。

确保已安装 Node.js 20+（Linux 或 macOS）。
安装并登录 OpenAI Codex CLI。
将服务器加入 MCP 客户端。Claude Code 可执行：claude mcp add --scope user codex -- npx -y @ask-llm/codex-mcp。
其他 MCP 客户端（STDIO）在配置中写入：{"command": "npx", "args": ["-y", "@ask-llm/codex-mcp"]}。
可选环境变量：GMCPT_TIMEOUT_MS（Codex CLI 执行超时，默认 300000 毫秒）、GMCPT_LOG_LEVEL（日志级别 debug/info/warn/error，默认 warn）。
在客户端中尝试：ask codex to review my last commit。

.mcp.json

{
  "mcpServers": {
    "codex": {
      "command": "npx",
      "args": ["-y", "@ask-llm/codex-mcp"]
    }
  }
}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "codex": {
      "command": "npx",
      "args": [
        "-y",
        "@ask-llm/codex-mcp"
      ]
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add codex -- npx -y @ask-llm/codex-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在 MCP 客户端的工具列表里应出现 ask-codex 工具；发送"让 codex 审查我最近一次提交"后能收到 Codex 给出的评审结果，即表示连接成功。

常见排障

运行 npx @ask-llm/mcp doctor 检查 Node 版本、PATH 解析与提供商 CLI 是否存在及版本
确认 Codex CLI 已安装并完成登录；未登录会直接导致调用失败
若审查耗时较长，调高 GMCPT_TIMEOUT_MS（默认为 300000 毫秒）
若希望多轮续接，务必在首次调用传入 sessionId: ""，后续复用返回的 sessionId
排查问题时把 GMCPT_LOG_LEVEL 设为 debug 以获取更详细日志
若使用旧包名 ask-codex-mcp，请改用 @ask-llm/codex-mcp（可执行文件名不变）

试试这样问

连接成功后，可以直接对 AI 助手这样说：

让 codex 审查 src/auth.ts 里的安全问题
问问 codex 对这次改动有什么第二意见
用 codex 评审我最近一次提交的改动
请 codex 指出这段代码里被忽略的 bug

工具能力 1

ask-codex 只读

调用 OpenAI Codex CLI 回答提示词，用于代码审查、方案辩论或获取第二意见。默认使用 gpt-6-astra，配额限制时回退到 gpt-5.6-terra；省略 sessionId 为一次性调用，首次传 sessionId: "" 可持久化并续接会话。

使用场景

让另一个模型审查代码 diff，找出主模型遗漏的问题

在确定架构方案前获取独立的批评、替代方案与取舍分析

由 Codex 对安全敏感代码（如认证逻辑）做定向审查

把同一个提示词交给多个提供商对比（需配合统一服务器与 multi-llm）

支持客户端

Claude Code

Cursor

Codex

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

Ask Codex 是 Ask LLM 项目中的 Codex 专用 MCP 服务器（npm 包 @ask-llm/codex-mcp，版本 0.2.0），通过 stdio 提供单一工具 ask-codex。它把宿主 AI 助手（如 Claude Code、Cursor、Claude Desktop、Codex CLI 等 40+ MCP 客户端）与 OpenAI Codex CLI 桥接起来，实现 AI 与 AI 的协作：审查 diff、对方案提出批评与替代方案、在提交前获取独立第二意见。默认模型为 gpt-6-astra，配额不足时回退到 gpt-5.6-terra。工具可选传入 sessionId，返回结构化 AskResponse（provider、response、model、sessionId、usage）；Codex 需要首次调用时传 sessionId: "" 才能建立可续接的会话，省略 sessionId 则为一次性调用。它由社区维护，与 Anthropic、OpenAI 等公司没有官方关联。

同仓库的其他 Server

数据同步于 2026-09-25 查看 FMRS 评分方法