gitlab-ci-mcp

gitlab-ci-mcp

mshegolevMIT
MCP-сервер для GitLab CI/CD. Соединяет AI-ассистента с пайплайнами, джобами, merge requests и файлами репозитория. Разработчик управляет GitLab прямо из диалога с нейросетью. Сервер работает с любым GitLab — облачным gitlab.com и корпоративными self-hosted серверами. Написан на Python с FastMCP. Транспорт — stdio. Подходит для корпоративных сетей: настраивается NO_PROXY, отключается проверка SSL.

Установка

uvx gitlab-ci-mcp

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

Общее

  • СтатусСообщество
  • Разработчикmshegolev
  • ЛицензияMIT

Технологии

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

Описание

Возможности

  • Запуск, остановка и просмотр CI/CD пайплайнов
  • Просмотр логов джобов с grep-фильтрацией
  • Повторный запуск и отмена джобов
  • Создание, мёрж и закрытие merge requests
  • Чтение и запись файлов в репозитории
  • Управление расписаниями пайплайнов
  • Просмотр веток и тегов
  • Работа с переменными CI/CD
  • Просмотр и проверка CI-конфигурации
  • Автоматическая классификация: опасные операции помечаются destructiveHint
  • Структурированный вывод: Markdown + JSON
  • Подробные ошибки: аутентификация, rate-limit, права доступа
  • Постраничная навигация
  • MCP Resources для информации о проекте и CI-конфига

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

1. Установите сервер

uvx gitlab-ci-mcp

Или через pip:

pip install gitlab-ci-mcp

2. Настройте переменные окружения

Создайте токен доступа GitLab с правами api. Укажите его в GITLAB_TOKEN. Укажите адрес GitLab в GITLAB_URL (по умолчанию https://gitlab.com). При необходимости укажите путь к проекту в GITLAB_PROJECT_PATH.

3. Добавьте конфигурацию в клиент

Для Claude Desktop отредактируйте claude_desktop_config.json:

{ "mcpServers": { "gitlab-ci": { "command": "uvx", "args": ["gitlab-ci-mcp"], "env": { "GITLAB_URL": "https://gitlab.example.com", "GITLAB_TOKEN": "ваш-токен", "GITLAB_PROJECT_PATH": "namespace/project" } } } }

4. Перезапустите клиент

Закройте и откройте приложение заново. В списке инструментов появятся команды для работы с GitLab.

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

  • «Покажи последние 10 пайплайнов в проекте namespace/project»
  • «Найди в логе последнего упавшего джоба строки со словом Error»
  • «Создай merge request из ветки feature/new-auth в main с заголовком Новый механизм аутентификации»
  • «Запусти пайплайн на ветке develop и покажи статус»

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

  • Язык: Python
  • Транспорт: stdio
  • Лицензия: MIT
  • Разработчик: mshegolev
  • Совместимые клиенты: Claude Desktop, Claude Code, Cursor, OpenCode, DevX Agent, VS Code + Cline

Поделиться