Advanced GitLab MCP server

Advanced GitLab MCP server

structured-worldApache-2.0
4 звёзд1 форков
Advanced GitLab MCP server — это сервер для интеграции GitLab с AI-ассистентами через протокол MCP. Он открывает доступ к 44 инструментам, которые охватывают 18 типов объектов GitLab: проекты, merge request, pipeline, вики-страницы, work items и другие. Вы можете управлять репозиториями, задачами и CI/CD прямо из чата с нейросетью, не переключаясь между интерфейсами. Сервер построен на CQRS-архитектуре: инструменты для чтения данных начинаются с browse_, а для изменений — с manage_. Это упрощает навигацию и повышает безопасность. Поддерживается работа с несколькими инстансами GitLab, OAuth 2.1, автоматическое обнаружение конфигурации из git remote и режим только для чтения. Сервер подходит для разработчиков и DevOps-инженеров, которые хотят ускорить рутинные операции с GitLab через AI-помощника.
Gitlab
Открыть на GitHubОфициальный сайт

Установка

npx -y @structured-world/gitlab-mcp

Характеристики

Общее

  • СтатусСообщество
  • Разработчикstructured-world
  • ЛицензияApache-2.0

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Управляйте проектами: создавайте, редактируйте, удаляйте проекты и настраивайте их параметры.
  • Работайте с merge request: просматривайте список, создавайте новые, принимайте или отклоняйте изменения.
  • Запускайте и отслеживайте pipeline: запускайте пайплайны, смотрите статус, логи и отменяйте выполнение.
  • Управляйте work items и задачами: создавайте, назначайте, меняйте статус задач прямо из чата.
  • Читайте и редактируйте вики-страницы: просматривайте, создавайте и обновляйте документацию в вики.
  • Обнаруживайте конфигурацию автоматически: сервер определяет GitLab-remote из вашего репозитория и подставляет настройки.
  • Подключайтесь к нескольким инстансам GitLab: для каждого можно задать свой токен, OAuth и лимиты запросов.
  • Включайте режим только для чтения: безопасная работа в production-окружении без риска случайных изменений.
  • Выбирайте транспорт: работайте через stdio, SSE или StreamableHTTP — под любой MCP-клиент.
  • Фильтруйте инструменты: включайте или отключайте группы команд, настраивайте описания под свои задачи.

Как подключить

Установите сервер с помощью npx. Убедитесь, что Node.js версии 24 или выше.

npx -y @structured-world/gitlab-mcp

Добавьте конфигурацию в ваш MCP-клиент. Пример для Claude Desktop:

{ "mcpServers": { "gitlab": { "command": "npx", "args": ["-y", "@structured-world/gitlab-mcp"], "env": { "GITLAB_TOKEN": "ваш_токен_доступа", "GITLAB_API_URL": "https://gitlab.com" } } } }

Перезапустите клиент, чтобы сервер загрузился. После этого в чате AI появится список инструментов для работы с GitLab.

Примеры запросов

  • «Покажи список открытых merge request в проекте frontend/web-app»
  • «Создай новый work item с заголовком „Исправить баг в авторизации“ в проекте backend»
  • «Запусти pipeline для ветки develop в проекте mobile-app»
  • «Найди страницу в вики по запросу „архитектура“»

Технические детали

  • Язык: TypeScript
  • Транспорт: stdio, SSE, StreamableHTTP
  • Лицензия: Apache-2.0
  • Совместимость: Claude Desktop, VS Code, VS Code Insiders, любой MCP-клиент
  • Дополнительно: Docker-образ ghcr.io/structured-world/gitlab-mcp:latest, установка через npx или npm, поддержка Node.js >= 24

Поделиться