Revisión del servidor MCP de Gerrit

Este servidor MCP proporciona integración con el sistema de revisión de código Gerrit, lo que permite a los asistentes de IA revisar los cambios de código y sus detalles a través de una interfaz sencilla.

Características

El servidor proporciona un conjunto de herramientas optimizado para la revisión de código:

Obtener detalles del cambio

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

Obtiene información completa sobre los cambios, incluidos archivos y conjuntos de parches.
Muestra información de diferencia detallada para cada archivo modificado
Muestra cambios, inserciones y eliminaciones de archivos.
Admite la revisión de conjuntos de parches específicos
Devuelve detalles completos del cambio, incluidos:
- Información del proyecto y de la sucursal
- Datos del autor y revisor
- Comentarios e historial de reseñas
- Modificaciones de archivos con contenido diferente
- Información del conjunto de parches actual

Comparar las diferencias entre los conjuntos de parches

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

Comparar las diferencias entre dos conjuntos de parches de un cambio
Ver diferencias de archivos específicos o todos los archivos modificados
Analizar modificaciones de código entre versiones de conjuntos de parches
Realizar un seguimiento de la evolución de los cambios mediante iteraciones de revisión

Ejemplo de uso

Revisar un cambio completo:

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

Comparar conjuntos de parches específicos:

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

Ver cambios de archivos específicos:

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

Prerrequisitos

Python 3.10 o superior (se recomienda Python 3.11)
Credenciales de acceso HTTP de Gerrit
Contraseña HTTP generada desde la configuración de Gerrit
Acceso al repositorio de paquetes mcp[cli] (paquete privado)

Instalación

Clonar este repositorio:

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

Crear y activar un entorno virtual:

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

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

Instale este paquete en modo editable con sus dependencias:

pip install -e .

Configuración

Configurar variables de entorno:

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

O crea un archivo .env :

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

Generar contraseña HTTP:

Inicie sesión en su interfaz web de Gerrit
Vaya a Configuración > Credenciales HTTP
Generar nueva contraseña
Copia la contraseña a tu entorno o archivo .env

Configuración de MCP

Para usar este servidor MCP con Cursor, debe agregar su configuración al archivo ~/.cursor/mcp.json . Esta es la configuración requerida:

{
  "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
    }
  }
}

Reemplace /path/to/your/workspace con la ruta real de su espacio de trabajo. Por ejemplo, si su proyecto está en /Users/username/projects/gerrit-code-review-mcp , use esa ruta.

Asegúrese de que todas las rutas en la configuración apunten a:

El intérprete de Python de su entorno virtual
El archivo server.py del proyecto
El directorio de trabajo correcto
El directorio bin del entorno virtual en PATH

Detalles de implementación

El servidor utiliza la API REST de Gerrit para interactuar con Gerrit, proporcionando:

Recuperación de información de cambios rápida y confiable
Autenticación segura mediante autenticación de resumen HTTP
Compatibilidad con varios puntos finales REST de Gerrit
Base de código limpia y mantenible
Cifrado HTTPS para una comunicación segura

Solución de problemas

Si encuentra problemas de conexión:

Verifique que su contraseña HTTP esté configurada correctamente
Compruebe la configuración de GERRIT_HOST
Asegúrese de que el acceso HTTPS esté habilitado en el servidor Gerrit
Pruebe la conexión usando curl:
curl -u "username:http-password" https://your-gerrit-host/a/changes/
Verifique los permisos de acceso de Gerrit para su cuenta

Licencia

Este proyecto está licenciado bajo la licencia MIT.

Contribuyendo

¡Agradecemos sus contribuciones! Por favor:

Bifurcar el repositorio
Crear una rama de características
Realiza tus cambios
Enviar una solicitud de extracción

Gerrit Review MCP Server

Integrations