Servidor GitLab-MCP

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona integración con GitLab. Recupera información sobre fallas en la canalización y resultados de solicitudes de fusión de proyectos específicos de GitLab y se los proporciona al asistente de IA.

descripción general

Este servidor MCP utiliza la API de GitLab para proporcionar la siguiente información al asistente de IA:

1. Salida de consola de trabajos fallidos en GitLab Pipeline

2. Problemas abiertos (comentarios) para GitLab MR

3. Cambios en GitLab MR (diferencia con el estado actual de su repositorio local)

Al utilizar las capacidades de MCP, el asistente de IA puede extraer información directamente de GitLab para brindar asistencia más específica.

Related MCP server: mcp-gitlab-jira

instalar

# uvのインストール
$ curl -LsSf https://astral.sh/uv/install.sh | sh

$ cd /path/to/this-mcp-server
# ライブラリのインストール
$ uv sync

Preparación

Necesitará su token de acceso de GitLab. Para emitir un token de acceso, vaya a Configuración de GitLab → Token de acceso. Al publicar, verifique read_api .

función

1. Obtenga información sobre fallas en la tubería y corríjala ( get_pipeline_failed_jobs )

Obtener la salida de la consola de trabajos fallidos en las canalizaciones de GitLab. El asistente de IA realizará correcciones en función de la información obtenida.

producción :

• La salida de la consola del trabajo fallido, incluido el nombre del trabajo, el estado y los registros detallados

2. Obtener y corregir los comentarios del MR ( get_review_comments )

Recuperar y responder a problemas abiertos (comentarios) en GitLab MR. Los comentarios resueltos y los comentarios que no estén asociados a un archivo serán excluidos.

producción :

• Problemas abiertos relacionados con archivos en MR (incluidos comentarista, hora, contenido del comentario, ubicación del archivo, etc.)

3. Obtener y revisar los cambios en el MR ( get_review_changes )

Obtén la diferencia desde la confirmación base (base_sha) del GitLab MR hasta el estado actual de tu repositorio local. En lugar de obtener una diferencia remota, puedes obtener una diferencia con la última versión local (incluido cualquier cambio no confirmado que tengas en progreso). Se realizará una revisión en función de las diferencias obtenidas.

producción :

• Cambios desde la confirmación base del MR al estado local actual (tipo de cambio y diferencia para cada archivo)

Colaboración con asistentes de IA

Un asistente de IA (como Claude) puede llamar a las siguientes funciones en este servidor MCP:

• get_pipeline_failed_jobs() : Obtener información sobre fallas en la tubería

• get_review_comments() : Obtener los comentarios de MR

• get_review_changes() : Obtener los cambios en el MR

Estas funciones recuperan automáticamente información sobre el MR relacionado con la rama actual.

Claude para configuraciones de escritorio

Agregue lo siguiente a claude_desktop_config.json :

{
    "mcpServers": {
        "gitlab-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/this-mcp-server",
                "run",
                "main.py"
            ],
            "env": {
                "GITLAB_URL": "your_gitlab_url",
                "GITLAB_PROJECT_NAME": "gitlab_project_name",
                "GITLAB_API_KEY": "your_gitlab_api_key",
                "GIT_REPO_PATH": "/path/to/git/repo"
            }
        }
    }
}

Configuración con cursor

Agregue lo siguiente a .cursor/mcp.json en la raíz de su proyecto:

{
    "mcpServers": {
        "gitlab-mcp": {
            "command": "env",
            "args": [
                "GITLAB_URL=your_gitlab_url",
                "GITLAB_PROJECT_NAME=gitlab_project_name",
                "GITLAB_API_KEY=your_gitlab_api_key",
                "GIT_REPO_PATH=/path/to/git/repo",
                "uv",
                "--directory",
                "/path/to/this-mcp-server",
                "run",
                "main.py"
            ]
        }
    }
}

Nota: En la configuración de ejemplo anterior, reemplace los siguientes valores según corresponda:

• your_gitlab_api_key : Su token de acceso a la API de GitLab

• /path/to/git/repo : La ruta absoluta al repositorio Git local

• /path/to/this-mcp-server : Ruta absoluta al directorio de este servidor MCP