代码审查服务器

MCP服务器,提供GPT-5 Codex访问,用于在自主Claude Code会话期间进行方法论审查。

  • by abstractionlair
  • Shell
  • 本地部署
  • 更新于
在 GitHub 查看 abstractionlair/mcp-servers

使用说明

Codex审查MCP服务器

MCP服务器,提供对GPT-5 Codex的访问,以便在自主的克劳德代码会话期间进行方法论审查。

特性

  • 工具: mcp__codex__codex_review -请求食典委方法审查
  • 可配置的推理努力(低/中/高)
  • 可选输出文件保存
  • 处理API密钥管理
  • 完整错误报告

安装

npm install
npm run build

配置

添加到 ~/.config/claude-code/mcp.json:

{
  "mcpServers": {
    "codex": {
      "command": "node",
      "args": ["/Users/YOUR_USERNAME/mcp-servers/build/index.js"],
      "env": {
        "OPENAI_API_KEY": "sk-proj-..."
      }
    }
  }
}

替代的:从现有的加载API密钥 .env:

{
  "mcpServers": {
    "codex": {
      "command": "bash",
      "args": [
        "-c",
        "source ~/.env && node /Users/YOUR_USERNAME/mcp-servers/build/index.js"
      ]
    }
  }
}

Claude代码中的用法

配置后,Claude Code将可以访问 mcp__codex__codex_review 工具 (该名称结合了来自的服务器密钥 mcp.json — codex --使用工具名称 codex_review):

// Claude Code can call this automatically
mcp__codex__codex_review({
  prompt: `# CODEX REVIEW REQUEST: Stage 1 SFT Training Gate

## Context
Reviewing Stage 1 SFT training plan...

## Request
GO / NO-GO for starting SFT training?`,
  reasoning_effort: "high",
  output_file: "reviews/autonomous/20251015_sft_gate.txt"
})

刀具参数

  • prompt (必填):审查请求文本
  • reasoning_effort (可选):“低”|“中”|“高”(默认值:“高”)
  • output_file (可选):保存响应的路径
  • model (可选):Codex型号名称(默认:“gpt-5-Codex”)

需求

  • Node.js 18+
  • codex CLI已安装并位于PATH中
  • 具有Codex访问权限的OpenAI API密钥

人工智能审查员作为强制预推门

食典委审查可以作为强制性的预推门来执行。所包含的钩子对您的分支diff运行Codex审查,解析 APPROVED:/BLOCKED: 裁决,失败关闭(除非审查批准,否则推送被拒绝)。

安装挂钩

cp hooks/pre-push .git/hooks/pre-push
chmod +x .git/hooks/pre-push

运作原理

  1. 上 git push,钩子计算您的分支与其跟踪分支之间的差异。
  2. 它将差异传递给 codex exec 附有审查说明。
  3. 扫描响应以查找 APPROVED: 或 BLOCKED: 在一条线的起点。
    • 批准 --推动前进。
    • 已屏蔽 --推送被拒绝;请修复问题并重试。如果两个标记 出现,封锁获胜。
    • 无判决 --被视为阻塞(出于安全考虑而关闭)。
  4. 评论已存档至 reviews/pre-push/ 如果目录存在。

要绕过(不建议): git push --no-verify.

发展

# Watch mode for development
npm run watch

# Build for production
npm run build

# Run the server tests
npm test

# Test the pre-push hook's verdict parsing (fail-closed contract)
hooks/pre-push.test.sh

许可证

麻省理工学院