Quartz 4

🔍 搜索

Claude Code 访问 Gerrit V2

6 min read

Claude Code 访问 Gerrit V2

Claude Code 访问 Gerrit V2 （Gerrit MCP Server）

巨人：Claude Code访问Gerrit

简介

一个用于 Gerrit Code Review 的 MCP （Model Context Protocol）

打通 AI 和 Gerrit 交互，让 Reviewers 可以借助 AI Review 代码，让 Author 可以借助 AI 修改代码 Comments

功能

Read (7)

Tool描述
gerrit_get_change查看 Change 详情、Labels 和 Reviewers
gerrit_get_files获取文件列表及增删行数
gerrit_get_diff获取文件 Diff 内容
gerrit_search按条件搜索 Change 列表
gerrit_get_comments获取按文件和行号组织的 inline review 评论
gerrit_get_messages获取 Change 级别的消息历史
gerrit_get_commit_message获取指定 Patchset 的 Commit Message

Write (8)

ToolDescription
gerrit_set_review提交 Review：添加 Change 级评论、inline 评论，以及对 Labels 投票（如 Code-Review +1/-1）
gerrit_set_reviewers添加一个或多个 Reviewer
gerrit_submit提交（合并）一个 Gerrit Change
gerrit_abandon放弃一个 Gerrit Change，可附带说明
gerrit_restore恢复一个已放弃的 Gerrit Change，可附带说明
gerrit_set_topic设置或清除 Gerrit Change 的 Topic
gerrit_resolve_comment使用规定模板格式解决 gerrit.pt.mioffice.cn 上的 inline 评论 thread
gerrit_edit_message修改 Gerrit Change 的 Commit Message

安装

安装

npm install -g @mi/gerrit-mcp@latest \
    --registry=https://pkgs.d.xiaomi.net/artifactory/api/npm/mi-npm/

配置

配置方法一：

claude mcp add --scope user gerrit -- gerrit-mcp # 添加 MCP
 
## 命令会打开浏览器自动获取用户名和密码（旧密码会自动失效），获取失败则使用 Cookie
gerrit auth https://gerrit.pt.mioffice.cn

配置方法二：

获取 HTTP 密码

❗ 生成 HTTP 密码后，旧密码立即失效，如果旧密码仍要使用，建议直接使用旧密码

  • 如果 Git 启用了store凭证助手，最新工具可直接读取~/.git-credentials，免配置密码使用
  • 如果使用gerrit auth生成的密码，可使用gerrit auth --list --show-password查看
  1. 登录 Gerrit，如：https://gerrit.pt.mioffice.cn![](https://minio.898311.xyz/blogimg/1780558821359_300735.png)
  2. 进入 Settings > HTTP Credentials
  3. 点击 “Generate New Password”
  4. 复制生成的密码
claude mcp add --scope user gerrit -- gerrit-mcp # 添加 MCP
 
## gerrit auth [url] -u [username] -p [password] # 按照URL添加用户名和密码，支持多仓库
gerrit auth https://gerrit.pt.mioffice.cn -u hezhaojiang -p 123456789

配置方法三，旧版本环境变量的方式配置：

不支持多仓库，获取密码同配置方法二

claude mcp add --scope user gerrit \
    -e GERRIT_URL=https://gerrit.pt.mioffice.cn \
    -e GERRIT_USERNAME=<your_username> \
    -e GERRIT_PASSWORD=<your_http_password> \
    -- gerrit-mcp
 
例如：
claude mcp add --scope user gerrit \
    -e GERRIT_URL=https://gerrit.pt.mioffice.cn \
    -e GERRIT_USERNAME=lvchong \
    -e GERRIT_PASSWORD=xxxxx \
    -- gerrit-mcp

使用示例

配置完成后，你可以在 AI 助手中这样使用：

# Reviewer
** 拉取到本地 Review 可以查看更多代码上下文，可以 Review 出更多问题 **
拉取到本地 review https://gerrit.pt.mioffice.cn/c/miconnect/+/7239571, 并将Review结果提交为 inline comments
 
# Uploader
2. 拉取并修改 https://gerrit.pt.mioffice.cn/c/miconnect/+/7239571 的 comments

常见问题 FAQ

Q1：工程云环境没有 sudo 权限，npm install -g报权限错误怎么办？

将 npm 全局目录改到用户目录下，无需 sudo：

# 1. 设置用户级 npm 全局目录
mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
 
# 2. 添加到 PATH（写入 ~/.bashrc 或 ~/.zshrc）
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
 
# 3. 重新安装
npm install -g @mi/gerrit-mcp@latest --registry=https://pkgs.d.xiaomi.net/artifactory/api/npm/mi-npm/

Q2：Windows 下执行 claude mcp add 报 missing required argument 'commandOrUrl' 错误？

不要使用 PowerShell，改用 cmd 执行命令，可避免参数解析错误。

Q3：MCP 已显示 connected，但访问 Gerrit 报 401 Unauthorized？

  1. 卸载@mi/gerrit-mcp-server，执行npm uninstall @mi/gerrit-mcp-server

  2. 重新执行安装命令，升级 gerrit-mcp

  3. HTTP 密码填写错误或过期，HTTP密码生成后前一个会过期，请使用新密码或重新生成：

    • 方法一：gerrit auth ``gerrit.pt.mioffice.cn
    • 方法二：登录 Gerrit → Settings → HTTP Credentials → Generate New Passwordgerrit auth ``gerrit.pt.mioffice.cn`` -u hezhaojiang -p 123456

Q4：能访问公司内其他 Gerrit 实例（不是 gerrit.pt.mioffice.cn）吗？

  1. 可以，v1.5.16 起已支持多实例，可使用gerrit auth <url> 命令配置不同服务器的 user/token
  2. 针对不支持 HTTP 的 Gerrit 实例，已支持
# 添加 MCP
claude mcp add --scope user gerrit -- gerrit-mcp
# 添加认证信息（HTTP）
gerrit auth gerrit.pt.mioffice.cn
# 添加认证信息（Cookie，Requires Chrome）
gerrit auth gerrit.pt.mioffice.cn --browser

Q5：能用 SSH 代替 HTTP 密码吗？

暂不支持。目前 MCP 使用 HTTP 协议，因为 gerrit.pt.mioffice.cn 的 SSH 协议不支持提交 comments 等关键接口，部分接口在 SSH 下也处于维护状态。其他部门的 Gerrit 可以考虑自行接入

更新记录

v1.5.38（2026-04-08）

增加提示词，inline comments 更加易用

v1.5.33（2026-04-07）

支持读取 ~/.git-credentials 自动认证，存在该文件时无需配置环境变量或者主动 auth 配置密码

v1.5.16（2026-04-02）

支持 cookie 认证，解决部分 Gerrit 服务器禁用了 HTTP 密码问题

v1.5.15（2026-04-02）

增加 gerrit 命令，辅助进行 auth & diff && review 等操作

v1.3.5

AI Review 时能看到完整的文件 diff，不再出现内容被截断的情况。

v1.3.3 ~ v1.3.4

修复若干影响正常使用的问题。

Graph View