cc-code-review MCP server
Commit Nov 3, 2026Enables AI clients to perform automated code reviews using Claude Code's native capabilities or a multi-agent fleet pipeline.
Also known as KentQi/cc-code-review
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 3, 2026
- License
- MIT
What is cc-code-review MCP?
cc-code-review enables AI clients to perform automated code reviews using Claude Code's native capabilities or a multi-agent fleet pipeline.
Summary generated from the project's README
About cc-code-review MCP server
Automating code reviews through AI clients like ZCode or Cursor is what this MCP server enables by bridging them to Claude Code's native capabilities. It allows developers to trigger reviews across pull requests, specific branches, working directories, or even the last commit. Users can choose between the standard built-in review commands or a sophisticated multi-agent fleet pipeline that uses up to ten parallel finder subagents and dedicated verifiers to ensure high-quality findings.
The server operates locally on Windows and macOS, requiring Node.js 20 or higher and an existing Claude Code installation. It supports multiple authentication methods, including direct OAuth login, an ANTHROPIC_API_KEY, or via local gateways like CC-Switch. Because it spawns headless Claude Code processes, it can perform deep analysis with varying effort levels from low to max, and even apply automatic fixes to the codebase when the fix mode is enabled.
What you can do with it
- 1Perform deep multi-agent reviewsRun a high-effort review using a fleet of subagents to find complex code issues.
- 2Monitor long-running review tasksCheck the status of an asynchronous review job or cancel it to stop further API spending.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablekentqi/cc-code-review is public and reachablegithub.com/kentqi/cc-code-review ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-03github.com/kentqi/cc-code-review ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubcc-code-review
English | 简体中文 · CHANGELOG · 文档索引 · Releases
EN: An MCP server that calls Claude Code's own /code-review (low..high, including --fix) or runs a fleet pipeline with the same three-phase structure claude's playbook uses (8/10 parallel finder subagents, one verifier per surviving candidate, one sweep finder; findings ≥ 75 of 0–100). Reviews — PR / branch / working dir / last commit, effort low→max — from ZCode or any MCP client, full report back. Works with a CC-Switch-style local gateway, direct OAuth login, or an API key, on Windows and macOS, with the standalone CLI or the desktop-app-embedded CLI. Nothing is installed into Claude Code. Ships as an Agent Plugins v1.0.0 package (plugin.json + skills/ + mcp.json), so conforming harnesses can load the skill and the MCP server from one directory.
把 Claude Code 的 code review 能力封装成 MCP server,让 ZCode(或任何 MCP 客户端)直接调用:
ZCode → MCP → claude -p(headless)→ claude 内置 /code-review(low..high,含 --fix)或内联舰队流水线(max:10 finder + 每候选 verifier + sweep)→ 审查报告原样返回给 ZCode → ZCode 根据报告改代码 → 再次调用复核。
ZCode ──MCP(stdio)──▶ cc-code-review ──spawn──▶ claude -p --output-format stream-json
│ │ cwd = 目标仓库
│ └─ 内置 /code-review(默认)或内联舰队提示词(不写任何文件)
◀── result(报告 + session_id + 花费) ──┘
前置条件
- Node ≥ 20(CI 矩阵 20/22/24;Node 18 已 EOL,不再声明支持)
- 已安装 Claude Code。无需 OAuth 登录,三种接入方式均可:
- CC Switch / claude-code-router 等网关:配置写在
~/.claude/settings.json的env块,claude 每次启动自行读取(同名键 settings 覆盖进程环境变量),所以切换供应商对下一次 review 立即生效。本 MCP 会对本地回环网关(127.0.0.1 等)做 TCP 预检,网关挂了会立刻报"gateway not reachable"而不是干等到超时;本地网关流量不会走 HTTP 代理(自动补NO_PROXY)。 - 官方账号登录(OAuth/Pro/Max):首次需在终端交互式跑一次
claude完成登录,之后 headless 直接可用。注意:若 MCP 宿主以服务/计划任务方式运行且读不到当前用户凭证(Windows Credential Manager / macOS Keychain),会报 "Not logged in"。 - ANTHROPIC_API_KEY 环境变量:从宿主环境继承,天然可用。
- CC Switch / claude-code-router 等网关:配置写在
- PR 范围审查需要
gh已登录;本地 diff 审查(working-dir / branch / last-commit)只需 git。
claude 可执行文件解析(跨平台)
本 MCP 不安装 Claude Code,只调用本机已有的 claude。它按以下优先级解析(claude_review_env 可查看命中来源):
| 优先级 | 来源 | Windows 路径 | macOS 路径 |
|---|---|---|---|
| 1 | CLAUDE_CODE_PATH 环境变量 |
任意可执行文件或 cli.js(不接受 .cmd/.bat/.ps1 shim) | 同左 |
| 2 | PATH 扫描 | claude.exe |
claude(可执行) |
| 3 | 常见安装位置 | %USERPROFILE%\.local\bin\claude.exe(native installer)、winget Links、npm 默认前缀包内 exe |
~/.local/bin/claude(native)、/opt/homebrew/bin/claude、/usr/local/bin/claude、~/.claude/local/claude |
| 4 | npm 全局 root(尊重自定义 prefix) | <npm root -g>/@anthropic-ai/claude-code/bin/claude.exe 或 cli.js |
同左 |
| 5 | Claude 桌面 app 内置 CLI(兜底,非官方入口) | %APPDATA%\Claude\claude-code\<版本>\claude.exe |
~/Library/Application Support/Claude/claude-code/<版本>/claude.app/Contents/MacOS/claude |
说明:
- 不用
where/which子进程(中文 Windows 上where输出 GBK 会解成乱码),直接用 Node 读 PATH 逐目录探测。 - 只装桌面 app、没装 CLI 也能用:兜底到 app 内嵌的版本化 CLI(取最新版本目录;app 更新后路径可能漂移,建议正式使用装一份 CLI)。
- macOS 注意:若宿主从 Dock/Finder 启动,继承的是 launchd 的精简 PATH,本 MCP 会自动把
/opt/homebrew/bin、/usr/local/bin、~/.local/bin等追加进 claude 子进程的 PATH(npm shim 的#!/usr/bin/env node与 claude 内部的 git/gh 都依赖它;追加而非前置,是为了不遮蔽用户自己的 PATH 优先级)。同理,ZCode 的 MCP 配置里command建议写 node 的绝对路径。 - macOS native 二进制首次 headless 运行若被 Gatekeeper 拦截(SIGKILL),错误信息会提示先在终端跑一次
claude --version。 - 超时/取消会杀整棵进程树(Windows
taskkill /T /F,Unix 进程组 SIGKILL);MCP server 自身退出时也会清理存活子进程。
注册到 MCP 客户端(ZCode / Claude Code / Cursor / 其他)
ZCode(一条命令)
推荐:一条命令自动配置(v1.7.0 起)。克隆本仓库后,在里面跑:
npm install
npm run init
init 会做一轮免费自检(claude CLI 解析与版本、加固 flag 地板、shell guard 实测、skill 状态、git/gh、网关连通性),然后按本机环境把注册写进 ~/.zcode/cli/config.json——node 用的是当前运行的绝对路径、入口文件用本仓库的绝对路径、网关凭据(如果检测到 CC Switch / settings.json / 环境变量配置)自动带上。Windows/macOS/Linux 无需手改任何路径。写完重启 ZCode(或重连 MCP)即可,工具名:mcp__cc-code-review__claude_code_review 等。
⚠️ 升级代码后必须重启 MCP 宿主。 stdio MCP 是常驻进程,模块在启动那一刻就载入了内存;而 shell guard 的 hook 脚本是每次 Bash 调用时从磁盘新起的。所以只更新文件不重启,会得到"旧服务器 + 新 hook"的错配:两者对策略的判断不一致,guard 自检会(正确地)拒绝运行,报
the shell guard is installed but did not behave as expected。这不是 bug,是 fail-closed。claude_review_env会直接告诉你答案:首行cc-code-review server: vX.Y.Z,若磁盘源码比本进程新,会追加⚠ STALE PROCESS并给出重启提示(structuredContent 里是server.stale)。
Claude Code / Cursor / 其他 MCP 客户端(手动)
npm run init 只写 ZCode 的配置;其他客户端用下面这段标准 stdio 配置即可——注意 command 必须是本机 node 的绝对路径,args 必须是本仓库 src/index.js 的绝对路径(宿主的工作目录不可控,相对路径会解析到别处):
{
"mcpServers": {
"cc-code-review": {
"command": "<本机 node 绝对路径>",
"args": ["<本仓库>/src/index.js"]
}
}
}
- Claude Code:放进项目
.mcp.json(或用户级 MCP 配置),或直接claude mcp add cc-code-review <本机 node 绝对路径> <本仓库>/src/index.js。 - Cursor:放进
~/.cursor/mcp.json或项目的.cursor/mcp.json。 - ZCode:不想跑
npm run init时,等价的手写位置是~/.zcode/cli/config.json的mcp.servers.cc-code-review(字段同上)。 - 其他客户端:任何支持 stdio MCP server 的宿主都接受这个形状;如果它同时支持 Agent Plugins,也可以直接把本仓库当插件加载(见下一节)。
工具名(
claude_code_review/claude_review_status/claude_review_followup/claude_review_env)与环境变量前缀(CLAUDE_REVIEW_*)保持稳定,不随 server 名改变——已注册过的调用方与脚本无需跟着改,改的只是 server 键名(工具前缀从mcp__claude-review__*变成mcp__cc-code-review__*)。
作为 Agent Plugin / Agent Skill 使用(任意 harness)
本仓库同时是一个 Agent Plugins v1.0.0 包——仓库根目录就是 plugin root,固定位置放三个可移植文件:
cc-code-review/
├── plugin.json # 插件清单(closed schema:名称/版本/描述/许可证)
├── mcp.json # stdio MCP server 配置(固定位置,不内联在 plugin.json)
├── skills/code-review/SKILL.md # 可移植 Agent Skill(Agent Skills 格式)
└── src/ scripts/ ... # MCP server 实现
- 支持 Agent Plugins 的客户端:把本仓库目录作为 plugin 加载即可——
skills/下的 code-review skill 与mcp.json里的 stdio server 会被自动发现。前提是先在插件目录跑过npm install(server 依赖在 node_modules;缺依赖时只有 MCP server 组件失败、skill 仍可加载——协议要求组件失败非致命)。 - 只支持 Agent Skills 的 harness:把
skills/code-review/整个目录复制进该 harness 的 skills 目录(例如 Claude Code 的~/.claude/skills/code-review/,或项目级 skills 目录)。skill 正文与 harness 无关:有 subagent/并行工具就并行派发 finder,没有就顺序执行全部角度,不会因为缺少 fan-out 而跳过角度;报告格式、评分与过滤规则不变。 - 用 MCP server 时不需要装 skill:fleet 流水线会把同一份 SKILL.md 正文内联进 prompt(见上文「评审流水线」),默认路径不往
~/.claude写任何文件。 - 格式校验:skill 遵循 Agent Skills 规范(frontmatter
name/description、正文 < 500 行),插件清单遵循 Agent Plugins 1.0.0 的 closed schema;npm test的plugin-test套件离线校验plugin.json/mcp.json/SKILL.md三个文件。
为什么单独测这三个文件:manifest 违规会让合规客户端拒绝整个插件,而 SKILL.md 违规只会静默丢弃 skill——两种失败都发生在 Claude Code 路径之外,其他套件看不见。
工具
1. claude_code_review — 跑一轮 review
| 参数 | 默认 | 范围 | 说明 |
|---|---|---|---|
repoPath |
必填 | - | 被审查仓库的绝对路径(支持 ~/ 前缀) |
scope |
auto |
5 选 1 | auto / pr / branch / working-dir / last-commit;auto 按 PR → 领先默认分支的提交 → 未提交改动 → 上一条提交 自动判断 |
pr |
- | - | GitHub PR 编号或 URL |
baseRef |
- | 纯 ref 字符 | branch 范围的基线(缺省自动探测默认分支;非法字符/修订范围会在评审前被拒绝,见下文) |
focus |
- | - | 额外关注点(仅作为评审提示,不会被当作指令执行;必须单行) |
outputLanguage |
中文 |
- | 报告语言 |
postToPR |
false |
- | 额外用 gh pr comment 把摘要贴回 PR(默认只返回报告,不外发)。必须同时给 pr:没有具名 PR 时预检直接拒绝(否则会带着一个无处可写的 GitHub 写权限,且提示词会要求模型猜一个 PR 号) |
fix |
false |
- | 修复模式:报告后直接修改仓库文件修复 findings(只放开 Edit/Write,无任何 git 写命令,不 commit;.git/**、.env*、密钥文件均在 deny 列表,实测拦截有效) |
effort |
max |
low/medium/high/xhigh/max | 模型推理力度,与 Claude Code 原生 --effort 同档位;默认 max(最深、最慢、最贵),想快想省就显式传 low/medium;CLI 不支持时自动退化为 think/ultrathink 关键词(两者不会叠加) |
reviewLevel |
由 effort 派生 |
low/medium/high/max | 评审自身深度(同原生 /code-review low|high|max 的参数)。舰队结构与原生 playbook 同为三阶段(finder → 每存活候选 1 个 verifier → sweep),数字由 src/prompt.js 的 FLEET_NUMBERS 单一来源渲染(工具 schema、prompt、本表同一来源;随包 SKILL.md 不再复述数字,改为指向 run 的 "Reviewer fleet" 行):low = 单遍无子代理(≤4 findings);medium/high = 8 个 finder("3+5" 形态:5 个 brief + 3 个拆分 finder,× 6 候选,findings 上限 8);max = 10 个 finder("5+5" 形态:每个 brief 拆两次,× 8 候选)+ 每个存活候选 1 个 verifier(CONFIRMED/PLAUSIBLE/REFUTED)+ 1 个 sweep finder,findings 上限 15;进入验证的候选上限 20。max 的总代理数是结构性的 15+(实测 17),不是硬编码数字 |
ultracode |
false |
- | Ultracode 模式:通过 --settings 写入 ultracode: true,启用原生"常驻动态工作流编排"(每个实质任务走 Workflow 工具、多代理、不计 token 成本);与 effort 正交;旧版 CLI 忽略该键(结果里的 workflow_runs 显示是否真正生效) |
model |
- | - | 覆盖模型(--model 透传) |
maxTurns |
80 |
4–200 | agentic 轮数上限 |
timeoutMinutes |
30 |
1–60 | 硬超时——不设费用上限时它是唯一的总闸;触发时已完成的子代理报告照样返回 |
maxBudgetUsd |
0(不设上限) |
0–50 | API 花费上限(--max-budget-usd)。默认 0 = 任何 effort 级别都不设费用上限:上限会在父代理综合前截停运行,而每个完成的子代理报告都已增量落盘、429 打断的子代理会从 output_file 转录抢救,设上限只会白扔已付费的工作;兜底 guards 是 timeoutMinutes 与 maxTurns。仍可显式设值;env CLAUDE_REVIEW_MAX_BUDGET_USD 只改默认值,显式传参优先 |
pipeline |
auto |
auto / native / fleet / skill | 评审引擎。auto:level 为 low..high(含 fix——走命令自带 --fix)时直接用 claude 内置的 /code-review(无需任何文件);max(以及映射到 max 的 effort=xhigh)、scope=last-commit 无父提交、或存在同名 skill 遮蔽内置命令时改用本 MCP 的舰队流水线(理由见下)。native 强制内置命令;fleet 强制内联舰队(指令写在 prompt 里);skill 为兼容旧行为(唯一会往 ~/.claude 写文件的模式) |
installSkillIfMissing |
false |
- | 仅在 pipeline=skill 时有意义:skill 缺失时安装(默认不装——缺失时退化走内联舰队流水线;已存在且由本 MCP 管理的副本在实际使用前自动刷新;带本 MCP marker 的副本会在使用前自动刷新(对其本地改动会被覆盖);无 marker 的用户副本永不写入、永不被删除;uninstall 只删本 MCP 写的文件) |
返回(默认异步:先返回 jobId(<1 秒)与预检结论,报告用 claude_review_status(jobId) 取回;waitForResult: true 时为下列同步返回):markdown 报告(## Code Review Summary / ## Findings (N) / ## Notes,与随包 SKILL.md 同一份格式合同)+ 每个评审子代理各自的报告(## Reviewer subagent reports,数量随 diff 规模而定)+ 元数据(session_id、花费、轮数、日志路径、模型溯源)。claude 的认证/网关类失败会以醒目的 ⚠️ REVIEW FAILED 横幅返回并附处理建议,不会伪装成"报告"。
2. claude_review_status — 轮询/获取/取消后台 review 任务(免费)
claude_code_review 默认异步:免费预检全部通过后立刻返回 jobId(<1 秒)——因为真实 review 要 2-15 分钟,而多数 MCP 客户端 ~30 秒就掐断工具调用。本工具:传 jobId 轮询(运行中报已耗时)或取回完整报告;传 jobId + cancel=true 中止并停止计费;不传参数列出本进程的任务。需要同步语义的客户端在 claude_code_review 里传 waitForResult: true。
3. claude_review_followup — 追问 / 复核
拿着上一次返回的 session_id 继续对话(claude --resume)。
4. claude_review_env — 环境自检(免费;不是只读工具)
CLI 解析结果与来源、版本、--effort/--max-budget-usd 支持情况、skill 状态、网关连通性(回环网关 TCP 预检)、宿主环境中残留的认证变量告警、git/gh 可用性、CLAUDE_CODE_EFFORT_LEVEL 覆盖告警。首行输出机器可读的 verdict: OK|NOT_FOUND|MISCONFIGURED。installSkill: true 可手动(重)装 skill。
评审流水线:默认用 claude 内置的 /code-review,不写任何文件
Claude Code 2.1.x 自带 code-review 技能(/code-review [level] [target])。本 MCP 默认直接调它,不再往 ~/.claude 装任何东西。
| level | 默认走哪条 | 原因(实测 2.1.311) |
|---|---|---|
| low / medium / high | 内置 /code-review |
单上下文、按"角度"逐个精读,10 秒级完成,零安装;fix 模式走命令自带的 --fix(二进制实测) |
| xhigh(映射到 max) | 本 MCP 舰队 | 与 max 同一条舰队流水线(xhigh 只是把 reviewLevel 映射到 max) |
| max | 内联舰队流水线 | 内置 max 会派子代理,而子代理爱写 cd X && ls && git config … 这类复合/越界命令,被 manual 模式成片拒绝(实测 100 次 denial、5 分钟不收敛);舰队提示词则明确约束在只读面内 |
last-commit 且 HEAD 无父提交 |
内联舰队流水线 | 内置命令的 target 是基线 ref(HEAD~1),root commit 或空仓库没有父提交 |
- 内联舰队 = 不装文件:
skills/code-review/SKILL.md的正文直接拼进 prompt(## Pipeline (bundled with this MCP)),模型照它执行;代价是每次 fleet review 多约 12KB 输入。 pipeline参数可显式指定:auto(默认)/native/fleet/skill。skill是唯一会写~/.claude的兼容模式,默认关闭。- 同名 skill 会遮挡内置命令(实测:装了
~/.claude/skills/code-review后,/code-review变成Skill调用)。因此存在同名 skill 时auto自动改走 fleet 并在结果里说明;显式pipeline=native会直接拒绝,而不是悄悄跑成别的东西。之前装过的那份可用claude_review_env { uninstallSkill: true }移除。 - 结果元数据带
pipeline(描述)与pipelineMode(解析结果),subagent_stats显示舰队规模。
cc-code-review MCP questions
Does this server install anything into Claude Code?
No, nothing is installed into Claude Code. It calls the existing Claude Code CLI on your machine.
What are the different review modes available?
The server supports various effort levels including low, medium, high, xhigh, and max, which determine the depth of the review and the number of sub-agents used.