Repolode
zereight

zereight/gitlab-mcp

MCP-сервер, который предоставляет AI-ассистентам структурированные инструменты для работы с проектами GitLab, merge request’ами, задачами, пайплайнами, вики и многим другим.

Звёзды
2,089
Форки
368
Открытые issues
11
Последний коммит
вчера

Что это?

gitlab-mcp — сервер Model Context Protocol, который подключает AI-клиенты, такие как Claude, Cursor, VS Code и Copilot, к экземпляру GitLab. Он предоставляет около 280 инструментов для работы с проектами, merge request’ами, задачами, пайплайнами, вики, релизами, тегами и вехами на базе GitLab REST и GraphQL API. По умолчанию загружается только компактный набор примерно из 40 основных инструментов, а дополнительные наборы можно активировать прямо во время сессии, чтобы не перегружать модель списком доступных инструментов.

Сервер работает через stdio с локальными клиентами, а для общих или размещённых развёртываний — через Streamable HTTP или SSE. Доступ можно настроить с помощью personal access token, локального OAuth2-потока в браузере, MCP OAuth-прокси для удалённых клиентов или передачи токена с каждым запросом в многопользовательских сценариях. Режимы прав (readonly, modify, full), фильтры разрешённых и запрещённых инструментов, а также ограничения по группам и проектам позволяют контролировать, что агент может изменять.

Для проверки merge request используется двухэтапный процесс: сначала выводится список изменённых файлов, затем diff запрашиваются пакетами. Необязательная фильтрация с помощью JMESPath и сокращение результатов помогают уменьшить объём больших ответов. Тот же бинарный файл предоставляет CLI для получения полных данных, например diff и логов задач, и работает как с GitLab.com, так и с самостоятельно размещёнными экземплярами GitLab.

Ключевые возможности

  • 01Около 280 инструментов для работы с проектами, merge request’ами, задачами, пайплайнами, вики и релизами
  • 02Компактный набор инструментов по умолчанию с активацией дополнительных инструментов по запросу
  • 03Транспорты stdio, SSE и Streamable HTTP
  • 04Авторизация с помощью personal access token, OAuth2 и передачи токена с каждым удалённым запросом
  • 05Режимы прав readonly и modify, а также фильтры по инструментам и проектам
  • 06Двухэтапная проверка merge request с пакетным получением diff

Сценарии использования

  • Попросить AI-ассистента для написания кода проверить изменённые файлы и diff в merge request
  • Поручить агенту проверить логи задач пайплайна или запускать CI-действия в GitLab
  • Использовать один размещённый endpoint GitLab MCP всей командой, передавая токен отдельно для каждого пользователя
  • Настроить интеграцию с GitLab только для чтения, для отчётности или сортировки обращений

Быстрый старт

  1. 1

    Установите бинарный файл из npm

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

    Укажите персональный токен доступа GitLab (ввод не отображается на экране)

    read -rs GITLAB_PERSONAL_ACCESS_TOKEN && export GITLAB_PERSONAL_ACCESS_TOKEN
  3. 3

    Зарегистрируйте сервер в 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

Что важно знать

  • Набор инструментов по умолчанию предоставляет доступ примерно к 40 инструментам; остальные нужно активировать с помощью discover_tools.
  • Набор инструментов api опасен, поскольку обходит списки разрешений и проверки безопасности.

В подборках

Темы

Частые вопросы

Что такое gitlab-mcp?
MCP-сервер, который предоставляет AI-ассистентам структурированные инструменты для работы с проектами GitLab, merge request’ами, задачами, пайплайнами, вики и многим другим. gitlab-mcp — сервер Model Context Protocol, который подключает AI-клиенты, такие как Claude, Cursor, VS Code и Copilot, к экземпляру GitLab. Он предоставляет около 280 инструментов для работы с проектами, merge request’ами, задачами, пайплайнами, вики, релизами, тегами и вехами на базе GitLab REST и GraphQL API. По умолчанию загружается только компактный набор примерно из 40 основных инструментов, а дополнительные наборы можно активировать прямо во время сессии, чтобы не перегружать модель списком доступных инструментов.
gitlab-mcp можно использовать бесплатно? Какая у него лицензия?
gitlab-mcp распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
gitlab-mcp всё ещё поддерживается?
Активно поддерживается. Последний коммит в gitlab-mcp — 6 нояб. 2026 г..
Для чего можно использовать gitlab-mcp?
Попросить AI-ассистента для написания кода проверить изменённые файлы и diff в merge request Поручить агенту проверить логи задач пайплайна или запускать CI-действия в GitLab Использовать один размещённый endpoint GitLab MCP всей командой, передавая токен отдельно для каждого пользователя Настроить интеграцию с GitLab только для чтения, для отчётности или сортировки обращений
Как установить gitlab-mcp?
Установите бинарный файл из npm: npm install -g @zereight/mcp-gitlab Укажите персональный токен доступа GitLab (ввод не отображается на экране): read -rs GITLAB_PERSONAL_ACCESS_TOKEN && export GITLAB_PERSONAL_ACCESS_TOKEN Зарегистрируйте сервер в 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
Где скачать gitlab-mcp?
Исходный код и инструкции по установке — на GitHub: https://github.com/zereight/gitlab-mcp

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты