Repolode
zereight

zereight/gitlab-mcp

Servidor MCP que ofrece a los asistentes de IA herramientas estructuradas para trabajar con proyectos, merge requests, incidencias, pipelines, wikis y más en GitLab.

Estrellas
2,089
Forks
368
Issues abiertos
11
Último commit
hace 22 horas

¿Qué es?

gitlab-mcp es un servidor Model Context Protocol que conecta clientes de IA como Claude, Cursor, VS Code y Copilot con una instancia de GitLab. Ofrece alrededor de 280 herramientas para proyectos, merge requests, incidencias, pipelines, wikis, releases, tags y milestones, basadas en las API REST y GraphQL de GitLab. De forma predeterminada, solo carga un conjunto básico y ligero de unas 40 herramientas; durante una sesión se pueden activar conjuntos adicionales para mantener reducida la lista de herramientas del modelo.

El servidor funciona mediante stdio para clientes locales y mediante Streamable HTTP o SSE para implementaciones compartidas o alojadas. Entre las opciones de autenticación se incluyen un personal access token, un flujo OAuth2 local en el navegador, un proxy OAuth de MCP para clientes remotos y el reenvío de tokens en cada solicitud para configuraciones multiusuario. Los modos de permisos (readonly, modify, full), los filtros de inclusión y exclusión de herramientas y las restricciones por grupo o proyecto limitan lo que puede modificar un agente.

Para revisar merge requests, un flujo en dos pasos primero enumera los archivos modificados y luego obtiene los diffs por lotes. Los filtros opcionales de JMESPath y la compactación de resultados reducen el tamaño de las respuestas extensas. El mismo binario también ofrece una interfaz de línea de comandos para obtener cargas completas, como diffs y registros de jobs, y funciona tanto con GitLab.com como con instancias autogestionadas.

Funciones clave

  • 01Alrededor de 280 herramientas para proyectos, merge requests, incidencias, pipelines, wikis y releases
  • 02Conjunto de herramientas ligero por defecto, con activación de herramientas adicionales bajo demanda
  • 03Transportes stdio, SSE y Streamable HTTP
  • 04Personal access token, OAuth2 y autorización remota por solicitud
  • 05Modos de permisos readonly y modify, con filtros de herramientas y proyectos
  • 06Revisión de merge requests en dos pasos, con obtención de diffs por lotes

Casos de uso

  • Pedir a un asistente de programación con IA que revise los archivos modificados y los diffs de una merge request
  • Permitir que un agente consulte los registros de jobs de un pipeline o active acciones de CI en GitLab
  • Compartir entre un equipo un endpoint alojado de GitLab MCP con tokens individuales por usuario
  • Ejecutar una integración de solo lectura con GitLab para generar informes o clasificar incidencias

Inicio rápido

  1. 1

    Instala el binario desde npm

    npm install -g @zereight/mcp-gitlab
  2. 2

    Configura tu token de acceso personal de GitLab (la entrada no se muestra en pantalla)

    read -rs GITLAB_PERSONAL_ACCESS_TOKEN && export GITLAB_PERSONAL_ACCESS_TOKEN
  3. 3

    Registra el servidor en Claude Code

    claude mcp add gitlab --transport stdio --scope local --env GITLAB_PERSONAL_ACCESS_TOKEN="$GITLAB_PERSONAL_ACCESS_TOKEN" --env GITLAB_API_URL=https://gitlab.com/api/v4 -- zereight-mcp-gitlab

Antes de usarlo

  • El conjunto de herramientas predeterminado expone solo unas 40 herramientas; las demás deben activarse con discover_tools.
  • El conjunto de herramientas api es arriesgado porque omite las listas de permitidos y las comprobaciones de seguridad.

En colecciones

Temas

Preguntas frecuentes

¿Qué es gitlab-mcp?
Servidor MCP que ofrece a los asistentes de IA herramientas estructuradas para trabajar con proyectos, merge requests, incidencias, pipelines, wikis y más en GitLab. gitlab-mcp es un servidor Model Context Protocol que conecta clientes de IA como Claude, Cursor, VS Code y Copilot con una instancia de GitLab. Ofrece alrededor de 280 herramientas para proyectos, merge requests, incidencias, pipelines, wikis, releases, tags y milestones, basadas en las API REST y GraphQL de GitLab. De forma predeterminada, solo carga un conjunto básico y ligero de unas 40 herramientas; durante una sesión se pueden activar conjuntos adicionales para mantener reducida la lista de herramientas del modelo.
¿gitlab-mcp es gratuito? ¿Qué licencia tiene?
gitlab-mcp es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿gitlab-mcp sigue mantenido?
Mantenimiento activo. El último commit de gitlab-mcp fue el 6 nov 2026.
¿Para qué puedo usar gitlab-mcp?
Pedir a un asistente de programación con IA que revise los archivos modificados y los diffs de una merge request Permitir que un agente consulte los registros de jobs de un pipeline o active acciones de CI en GitLab Compartir entre un equipo un endpoint alojado de GitLab MCP con tokens individuales por usuario Ejecutar una integración de solo lectura con GitLab para generar informes o clasificar incidencias
¿Cómo se instala gitlab-mcp?
Instala el binario desde npm: npm install -g @zereight/mcp-gitlab Configura tu token de acceso personal de GitLab (la entrada no se muestra en pantalla): read -rs GITLAB_PERSONAL_ACCESS_TOKEN && export GITLAB_PERSONAL_ACCESS_TOKEN Registra el servidor en Claude Code: claude mcp add gitlab --transport stdio --scope local --env GITLAB_PERSONAL_ACCESS_TOKEN="$GITLAB_PERSONAL_ACCESS_TOKEN" --env GITLAB_API_URL=https://gitlab.com/api/v4 -- zereight-mcp-gitlab
¿Dónde consigo gitlab-mcp?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/zereight/gitlab-mcp

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados