Google Git
Sign in
gerrit/gerrit-mcp-server/5f764bfd0cc674ae91ac66450e3170763fbdf20e
commit
5f764bfd0cc674ae91ac66450e3170763fbdf20e
[log]
author
Yevhenii Yatchenko <yevhenii.yatchenko@gmail.com>
Fri Mar 13 20:42:48 2026 +0200
committer
Yevhenii Yatchenko <yevhenii.yatchenko@gmail.com>
Mon Mar 23 17:16:13 2026 +0200
tree
ba9ad86fea967028788bdd11fe73bc4860700105
parent
9cadc50cffefe1c584d9be7d01e885189c909462 [diff]
Add /a/ prefix to Gerrit API URLs for authenticated access

Per Gerrit REST API docs, all endpoints assume anonymous access by
default. Users must prefix the URL path with /a/ to authenticate with
HTTP basic credentials or cookies. Without /a/, Gerrit ignores any
auth headers and returns only publicly visible data (which may be
nothing at all).

Change-Id: Icbd710e2bdfb1705c92e7e5a11c5fb5adae2e6d8
4 files changed
tree: ba9ad86fea967028788bdd11fe73bc4860700105
  1. docs/
  2. gerrit_mcp_server/
  3. tests/
  4. .gitignore
  5. AGENT.md
  6. build-gerrit.sh
  7. gemini-cli-config.template.json
  8. gemini-extension.json
  9. GEMINI.md
  10. LICENSE
  11. OWNERS
  12. pyproject.toml
  13. README.md
  14. requirements.txt
  15. server.sh
  16. test.sh
  17. uv-requirements.txt
README.md

🐍 Gerrit MCP Server

An MCP (Model Context Protocol) server for interacting with the Gerrit code review system. This server allows a language model like Gemini to query changes, retrieve details, and manage reviews by executing curl commands against the Gerrit REST API.

This server can be run as a persistent HTTP server or on-demand via STDIO.

📚 Documentation

For detailed information, please see the documents in the docs/ directory:

🚀 Getting Started

1. Prerequisites

Before you begin, ensure you have the following tools installed and available in your system's PATH.

  • Python 3.11+: The build script requires a modern version of Python.
  • curl: The standard command-line tool for transferring data with URLs.

2. Build the Environment

Run the build script from the root of the gerrit-mcp-server project directory. This will create a Python virtual environment, install all dependencies, and make the server ready to run.

./build-gerrit.sh

3. Configure the Server

You will need to create a gerrit_config.json file inside the gerrit_mcp_server directory. Copy the provided sample file gerrit_mcp_server/gerrit_config.sample.json and customize it for your environment. See the Configuration Guide for details on all available options.

cp gerrit_mcp_server/gerrit_config.sample.json gerrit_mcp_server/gerrit_config.json

4. Run the Server (HTTP Mode)

To run the server as a persistent background process, use the server.sh script:

  • Start the server:
    ./server.sh start
  • Check the status:
    ./server.sh status
  • Stop the server:
    ./server.sh stop

For on-demand STDIO mode, please see the Gemini CLI Setup Guide.

Security

This is not an officially supported Google product. This project is not eligible for the Google Open Source Software Vulnerability Rewards Program.