Обзор Gerrit MCP Server

Этот сервер 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: Phabricator MCP Server

Предпосылки

• 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

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

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

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

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

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

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

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

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

2. Сгенерируйте 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-шифрование для безопасной связи

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

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

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. Отправить запрос на извлечение