Gerrit Review MCP Server

Gerrit Review MCP Server

This MCP server provides integration with Gerrit code review system, allowing AI assistants to review code changes and their details through a simple interface.

Features

The server provides a streamlined toolset for code review:

Fetch Change Details

• Fetches complete change information including files and patch sets
• Shows detailed diff information for each modified file
• Displays file changes, insertions, and deletions
• Supports reviewing specific patch sets
• Returns comprehensive change details including:
  • Project and branch information
  • Author and reviewer details
  • Comments and review history
  • File modifications with diff content
  • Current patch set information

Compare Patchset Differences

• Compare differences between two patchsets of a change
• View specific file differences or all changed files
• Analyze code modifications across patchset versions
• Track evolution of changes through review iterations

Example Usage

Review a complete change:

Compare specific patchsets:

View specific file changes:

Prerequisites

• Python 3.10 or higher (Python 3.11 recommended)
• Gerrit HTTP access credentials
• HTTP password generated from Gerrit settings
• Access to the mcp[cli] package repository (private package)

Installation

Installing via Smithery

To install gerrit-code-review-mcp for Claude Desktop automatically via Smithery:

Manual Installation

1. Clone this repository:

2. Create and activate a virtual environment:

3. Install this package in editable mode with its dependencies:

Configuration

1. Set up environment variables:

Or create a .env file:

2. Generate HTTP password:

• Log into your Gerrit web interface
• Go to Settings > HTTP Credentials
• Generate new password
• Copy the password to your environment or .env file

3. Configure file exclusions (optional):

• Set GERRIT_EXCLUDED_PATTERNS to exclude specific file types from change reviews
• Use comma-separated regex patterns (e.g., \.pbxproj$,\.xcworkspace$,node_modules/)
• Leave empty or unset to use default exclusions
• This helps prevent infinite loops with large files

MCP Configuration

To use this MCP server with Cursor or RooCode, you need to add its configuration to your ~/.cursor/mcp.json or .roo/mcp.json file. Here's the required configuration:

Replace /path/to/your/workspace with your actual workspace path. For example, if your project is in /Users/username/projects/gerrit-code-review-mcp, use that path instead.

Make sure all paths in the configuration point to:

• Your virtual environment's Python interpreter
• The project's server.py file
• The correct working directory
• The virtual environment's bin directory in the PATH

Implementation Details

The server uses Gerrit REST API to interact with Gerrit, providing:

• Fast and reliable change information retrieval
• Secure authentication using HTTP digest auth
• Support for various Gerrit REST endpoints
• Clean and maintainable codebase
• HTTPS encryption for secure communication

Troubleshooting

If you encounter connection issues:

1. Verify your HTTP password is correctly set in GERRIT_HTTP_PASSWORD
2. Check GERRIT_HOST setting (hostname only, without https://)
3. Ensure HTTPS access is enabled on Gerrit server
4. Test connection using curl with the /a/ prefix for authenticated API calls:
   curl -u "your-username:your-http-password" https://your-gerrit-server.com/a/changes/?q=status:open
5. Verify Gerrit access permissions for your account

HTTP Credentials Authentication Issues

If you're having trouble with authentication, check your Gerrit config for gitBasicAuthPolicy = HTTP (or HTTP_LDAP).

License

This project is licensed under the MIT License.

Contributing

We welcome contributions! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request