GitLab MCP para revisión de código

Este proyecto es una bifurcación de cayirtepeomer/gerrit-code-review-mcp y está adaptado para la integración de GitLab.

Un servidor MCP (Protocolo de Contexto de Modelo) para integrar asistentes de IA como Claude con las solicitudes de fusión de GitLab. Esto permite a los asistentes de IA revisar los cambios de código directamente a través de la API de GitLab.

Características

• Análisis completo de solicitudes de fusión : obtenga detalles completos sobre las solicitudes de fusión, incluidas diferencias, confirmaciones y comentarios

• Diferencias específicas de archivos : analiza cambios en archivos específicos dentro de solicitudes de fusión

• Comparación de versiones : compare diferentes ramas, etiquetas o confirmaciones

• Gestión de revisiones : agregar comentarios, aprobar o desaprobar solicitudes de fusión

• Descripción general del proyecto : obtener listas de todas las solicitudes de fusión en un proyecto

Related MCP server: AI-PR-Review-MCP

Instalación

Prerrequisitos

• Python 3.10+

• Token de acceso personal de GitLab con alcance de API (read_api, api)

• Cursor IDE o aplicación de escritorio Claude para la integración de MCP

Inicio rápido

1. Clonar este repositorio:

git clone https://github.com/mehmetakinn/gitlab-mcp-code-review.git
cd gitlab-mcp-code-review

2. Crear y activar un entorno virtual:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. Instalar dependencias:

pip install -r requirements.txt

4. Crea un archivo .env con tu configuración de GitLab (consulta .env.example para ver todas las opciones):

# Required
GITLAB_TOKEN=your_personal_access_token_here

# Optional settings
GITLAB_HOST=gitlab.com
GITLAB_API_VERSION=v4
LOG_LEVEL=INFO

Opciones de configuración

Las siguientes variables de entorno se pueden configurar en su archivo .env :

Integración de Cursor IDE

Para usar este MCP con Cursor IDE, agregue esta configuración a su archivo ~/.cursor/mcp.json :

{
  "mcpServers": {
    "gitlab-mcp-code-review": {
      "command": "/path/to/your/gitlab-mcp-code-review/.venv/bin/python",
      "args": [
        "/path/to/your/gitlab-mcp-code-review/server.py",
        "--transport",
        "stdio"
      ],
      "cwd": "/path/to/your/gitlab-mcp-code-review",
      "env": {
        "PYTHONPATH": "/path/to/your/gitlab-mcp-code-review",
        "VIRTUAL_ENV": "/path/to/your/gitlab-mcp-code-review/.venv",
        "PATH": "/path/to/your/gitlab-mcp-code-review/.venv/bin:/usr/local/bin:/usr/bin:/bin"
      },
      "stdio": true
    }
  }
}

Reemplace /path/to/your/gitlab-mcp-code-review con la ruta real a su repositorio clonado.

Integración de la aplicación de escritorio Claude

Para utilizar este MCP con la aplicación de escritorio Claude:

1. Abra la aplicación de escritorio Claude

2. Vaya a Configuración → Avanzado → Configuración de MCP

3. Agregue la siguiente configuración:

{
  "mcpServers": {
    "gitlab-mcp-code-review": {
      "command": "/path/to/your/gitlab-mcp-code-review/.venv/bin/python",
      "args": [
        "/path/to/your/gitlab-mcp-code-review/server.py",
        "--transport",
        "stdio"
      ],
      "cwd": "/path/to/your/gitlab-mcp-code-review",
      "env": {
        "PYTHONPATH": "/path/to/your/gitlab-mcp-code-review",
        "VIRTUAL_ENV": "/path/to/your/gitlab-mcp-code-review/.venv",
        "PATH": "/path/to/your/gitlab-mcp-code-review/.venv/bin:/usr/local/bin:/usr/bin:/bin"
      },
      "stdio": true
    }
  }
}

Reemplace /path/to/your/gitlab-mcp-code-review con la ruta real a su repositorio clonado.

Herramientas disponibles

El servidor MCP proporciona las siguientes herramientas para interactuar con GitLab:

Ejemplos de uso

Obtener una solicitud de fusión

# Get details of merge request #5 in project with ID 123
mr = fetch_merge_request("123", "5")

Ver cambios específicos en archivos

# Get diff for a specific file in a merge request
file_diff = fetch_merge_request_diff("123", "5", "path/to/file.js")

Comparar sucursales

# Compare develop branch with master branch
diff = compare_versions("123", "develop", "master")

Agregar un comentario a una solicitud de fusión

# Add a comment to a merge request
comment = add_merge_request_comment("123", "5", "This code looks good!")

Aprobar una solicitud de fusión

# Approve a merge request and set required approvals to 2
approval = approve_merge_request("123", "5", approvals_required=2)

Solución de problemas

Si encuentra problemas:

1. Verifique que su token de GitLab tenga los permisos adecuados (api, read_api)

2. Comprueba la configuración de tu archivo .env

3. Asegúrese de que las rutas de configuración de MCP sean correctas

4. Pruebe la conexión con: curl -H "Private-Token: your-token" https://gitlab.com/api/v4/projects

5. Establezca LOG_LEVEL=DEBUG en su archivo .env para obtener un registro más detallado

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

1. Bifurcar el repositorio

2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )

3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )

4. Empujar a la rama ( git push origin feature/amazing-feature )

5. Abrir una solicitud de extracción

Consulte el archivo CONTRIBUTING.md para obtener más detalles sobre el proceso de desarrollo.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.