Обзор Gerrit MCP Server

Name: Gerrit Review MCP Server
Author: cayirtepeomer

значок кузнеца

Этот сервер MCP обеспечивает интеграцию с системой проверки кода Gerrit, позволяя помощникам на базе искусственного интеллекта просматривать изменения кода и их детали с помощью простого интерфейса.

Функции

Сервер предоставляет оптимизированный набор инструментов для проверки кода:

Получить сведения об изменении

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: CodeChecker MCP

Предпосылки

Python 3.10 или выше (рекомендуется Python 3.11)
Учетные данные доступа HTTP Gerrit
HTTP-пароль, сгенерированный из настроек Gerrit
Доступ к репозиторию пакетов mcp[cli] (частный пакет)

Установка

Установка через Smithery

Чтобы автоматически установить gerrit-code-review-mcp для Claude Desktop через Smithery :

npx -y @smithery/cli install @cayirtepeomer/gerrit-code-review-mcp --client claude

Ручная установка

Клонируйте этот репозиторий:

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

Создайте и активируйте виртуальную среду:

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

Установите этот пакет в режиме редактирования со всеми его зависимостями:

pip install -e .

Конфигурация

Настройте переменные среды:

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

Сгенерируйте HTTP-пароль:

Войдите в веб-интерфейс Gerrit.
Перейдите в Настройки > Учетные данные HTTP.
Сгенерировать новый пароль
Скопируйте пароль в вашу среду или файл .env.

Конфигурация МКП

Чтобы использовать этот сервер 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-шифрование для безопасной связи

Поиск неисправностей

Если у вас возникли проблемы с подключением:

Проверьте правильность установки вашего HTTP-пароля.
Проверьте настройку GERRIT_HOST
Убедитесь, что на сервере Gerrit включен доступ по протоколу HTTPS.
Проверьте соединение с помощью curl:
curl -u "username:http-password" https://your-gerrit-host/a/changes/
Проверьте разрешения доступа Gerrit для вашей учетной записи

Лицензия

Данный проект лицензирован по лицензии MIT.

Внося вклад

Мы приветствуем ваши вклады! Пожалуйста:

Форк репозитория
Создать ветку функций
Внесите изменения
Отправить запрос на извлечение

Gerrit Review MCP Server