claudecode-review-mcp

一个本地 MCP server，用来让其他 MCP client 调用本机 Claude CLI 审查当前 Git 修改。

默认工具 claude_review_changes 会读取目标仓库中的已暂存 diff、未暂存 diff 和未跟踪的新文件，然后调用：

claude -p --output-format text --permission-mode dontAsk --tools "" --no-session-persistence

Claude 只收到 diff 和仓库状态信息，默认不会改文件。

安装

npm install
npm run build
npm test

要求：

• Node.js 20+
• 已安装并登录 Claude Code CLI，命令名默认为 claude
• 目标目录是 Git 仓库

MCP 配置示例

Codex

本地开发或想立刻使用当前源码时，先构建：

npm run build

然后把下面配置加入 ~/.codex/config.toml：

[mcp_servers.claudecode-review]
command = "node"
args = ["/Users/qian/project/claude-review/dist/index.js"]
startup_timeout_sec = 30
tool_timeout_sec = 300

[mcp_servers.claudecode-review.env]
CLAUDE_REVIEW_CLAUDE_PATH = "/Users/qian/.local/bin/claude"

如果要使用 npm 已发布包，也可以改成：

[mcp_servers.claudecode-review]
command = "npx"
args = ["-y", "claudecode-review-mcp"]
startup_timeout_sec = 30
tool_timeout_sec = 300

如果你的 Claude CLI 不在 /Users/qian/.local/bin/claude，先用下面命令确认路径：

command -v claude

改完配置后，重启 Codex 或新开一个 Codex 会话，然后可以这样让 Codex 调用：

使用 claudecode-review 的 claude_review_changes 审查当前仓库修改，repoPath=/path/to/your/repo。

其他 MCP client

如果从源码本地运行，把下面配置加入你的 MCP client。路径按本机实际目录填写：

{
  "mcpServers": {
    "claudecode-review": {
      "command": "node",
      "args": ["/Users/qian/project/claude-review/dist/index.js"]
    }
  }
}

如果你的 Claude CLI 不在 PATH 中，可以设置环境变量：

{
  "mcpServers": {
    "claudecode-review": {
      "command": "node",
      "args": ["/Users/qian/project/claude-review/dist/index.js"],
      "env": {
        "CLAUDE_REVIEW_CLAUDE_PATH": "/Users/qian/.local/bin/claude"
      }
    }
  }
}

Tool: claude_review_changes

常用调用：

{
  "repoPath": "/path/to/your/repo"
}

参数：

| 参数 | 默认值 | 说明 | | --- | --- | --- | | repoPath | MCP server 启动目录 | 要审查的 Git 仓库 | | includeStaged | true | 包含 git diff --cached | | includeUnstaged | true | 包含 git diff | | includeUntracked | true | 包含未跟踪的新文件 | | baseRef | 无 | 若提供，则审查 git diff <baseRef>，会忽略 staged/unstaged/untracked 开关 | | paths | 无 | 限制审查范围，例如 ["src", "package.json"] | | language | zh-CN | Claude 审查输出语言 | | reviewFocus | 无 | 额外审查重点，例如安全、测试、兼容性 | | model | Claude CLI 默认模型 | 传给 claude --model | | claudePath | claude | Claude CLI 可执行文件路径 | | timeoutMs | 300000 | Claude CLI 超时时间 | | maxDiffBytes | 200000 | diff 超过该大小时拒绝审查 |

示例

只审查某个目录，并要求关注测试：

{
  "repoPath": "/path/to/your/repo",
  "paths": ["src"],
  "reviewFocus": "重点关注边界条件和缺失测试"
}

审查相对 main 的改动：

{
  "repoPath": "/path/to/your/repo",
  "baseRef": "main"
}