Skip to main content
Glama
deenesjakoruzh
cayirtepeomer

Gerrit Review MCP Server

by cayirtepeomer
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Gerrit 审查 MCP 服务器

该 MCP 服务器提供与 Gerrit 代码审查系统的集成，允许 AI 助手通过简单的界面审查代码更改及其详细信息。

特征

该服务器提供了一套精简的代码审查工具集：

获取更改详细信息

fetch_gerrit_change(change_id: str, patchset_number: Optional[str] = None)

  • 获取完整的变更信息，包括文件和补丁集

  • 显示每个修改文件的详细差异信息

  • 显示文件更改、插入和删除

  • 支持审查特定补丁集

  • 返回全面的变更详细信息，包括：

    • 项目和分支信息

    • 作者和审阅者详细信息

    • 评论和评论历史

    • 具有不同内容的文件修改

    • 当前补丁集信息

比较补丁集差异

fetch_patchset_diff(change_id: str, base_patchset: str, target_patchset: str, file_path: Optional[str] = None)

  • 比较两个补丁集之间的差异

  • 查看特定文件差异或所有更改的文件

  • 分析跨补丁集版本的代码修改

  • 通过审查迭代跟踪变化的演变

示例用法

审查完整的变更：

# Fetch latest patchset of change 23824
change = fetch_gerrit_change("23824")

比较特定的补丁集：

# Compare differences between patchsets 1 and 2 for change 23824
diff = fetch_patchset_diff("23824", "1", "2")

查看具体文件变更：

# Get diff for a specific file between patchsets
file_diff = fetch_patchset_diff("23824", "1", "2", "path/to/file.swift")

Related MCP server: Phabricator MCP Server

先决条件

  • Python 3.10 或更高版本（推荐 Python 3.11）

  • Gerrit HTTP 访问凭据

  • 从 Gerrit 设置生成的 HTTP 密码

  • 访问mcp[cli]包存储库（私有包）

安装

  1. 克隆此存储库：

git clone <repository-url>
cd gerrit-review-mcp

  1. 创建并激活虚拟环境：

# For macOS/Linux:
python -m venv .venv
source .venv/bin/activate

# For Windows:
python -m venv .venv
.venv\Scripts\activate

  1. 以可编辑模式安装此包及其依赖项：

pip install -e .

配置

  1. 设置环境变量：

export GERRIT_HOST="gerrit.example.com"  # Your Gerrit server hostname
export GERRIT_USER="your-username"       # Your Gerrit username
export GERRIT_HTTP_PASSWORD="your-http-password"  # Your Gerrit HTTP password

或者创建一个.env文件：

GERRIT_HOST=gerrit.example.com
GERRIT_USER=your-username
GERRIT_HTTP_PASSWORD=your-http-password

  1. 生成 HTTP 密码：

  • 登录您的 Gerrit Web 界面

  • 前往“设置”>“HTTP 凭证”

  • 生成新密码

  • 将密码复制到您的环境或 .env 文件

MCP 配置

要将此 MCP 服务器与 Cursor 一起使用，您需要将其配置添加到~/.cursor/mcp.json文件中。以下是所需的配置：

{
  "mcpServers": {
    "gerrit-review-mcp": {
      "command": "/path/to/your/workspace/gerrit-code-review-mcp/.venv/bin/python",
      "args": [
        "/path/to/your/workspace/gerrit-code-review-mcp/server.py",
        "--transport",
        "stdio"
      ],
      "cwd": "/path/to/your/workspace/gerrit-code-review-mcp",
      "env": {
        "PYTHONPATH": "/path/to/your/workspace/gerrit-code-review-mcp",
        "VIRTUAL_ENV": "/path/to/your/workspace/gerrit-code-review-mcp/.venv",
        "PATH": "/path/to/your/workspace/gerrit-code-review-mcp/.venv/bin:/usr/local/bin:/usr/bin:/bin"
      },
      "stdio": true
    }
  }
}

将/path/to/your/workspace替换为您的实际工作区路径。例如，如果您的项目位于/Users/username/projects/gerrit-code-review-mcp ，请使用该路径。

确保配置中的所有路径都指向：

  • 你的虚拟环境的 Python 解释器

  • 项目的server.py文件

  • 正确的工作目录

  • 虚拟环境的 bin 目录在 PATH 中

实现细节

服务器使用 Gerrit REST API 与 Gerrit 交互，提供：

  • 快速可靠的变更信息检索

  • 使用 HTTP 摘要式身份验证进行安全身份验证

  • 支持各种 Gerrit REST 端点

  • 干净且可维护的代码库

  • HTTPS 加密，实现安全通信

故障排除

如果遇到连接问题：

  1. 验证您的 HTTP 密码是否设置正确

  2. 检查 GERRIT_HOST 设置

  3. 确保 Gerrit 服务器上启用了 HTTPS 访问

  4. 使用 curl 测试连接：

    curl -u "username:http-password" https://your-gerrit-host/a/changes/

  5. 验证您帐户的 Gerrit 访问权限

执照

该项目已获得 MIT 许可。

贡献

欢迎投稿！请：

  1. 分叉存储库

  2. 创建功能分支

  3. 进行更改

  4. 提交拉取请求

This server cannot be deployed

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivityInactive
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers