Un adaptador que permite al agente de programación Pi usar servidores MCP mediante una única herramienta proxy, para evitar que las definiciones de herramientas inactivas llenen la ventana de contexto.
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
Instala el binario desde npm
npm install -g @zereight/mcp-gitlab - 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
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
Servidor MCP alojado que proporciona a agentes de IA transcripciones de YouTube, búsquedas, listados de canales y playlists, y seguimiento gratuito de nuevas publicaciones.
Un servidor MCP que permite a asistentes de IA como Claude y Cursor buscar en la web mediante una instancia de SearXNG que operas o en la que confías.
Una CLI de Python y un servidor MCP que permiten a agentes de programación y chats obtener el contexto de código adecuado mediante reglas reutilizables para seleccionar archivos.
Taller paso a paso en Go para crear un agente de programación con la API de Claude, añadiendo herramientas de archivos, shell y búsqueda una por una.
Plugin para Unity Editor y runtime, y servidor MCP que permite a agentes de IA como Claude, Cursor y Copilot operar proyectos de Unity y ejecutar LLMs dentro de juegos.