gitlab-mcp-server

gitlab-mcp-server

dubuqingfengMIT
9 звёзд5 форков
GitLab MCP Server — это инструмент-посредник между GitLab и AI-ассистентами, работающими по протоколу MCP. Он решает задачу автоматизации рутинных операций с репозиторием: разработчику больше не нужно переключаться в веб-интерфейс, чтобы посмотреть Merge Request, провести код-ревью или найти файл. Достаточно описать задачу текстом — ассистент выполнит её через сервер. Сервер не просто даёт доступ к данным GitLab, в него встроена система умного код-ревью. Она анализирует код в зависимости от типа проекта — TypeScript, React, Python, Go и другие. Правила настраиваются через JSON: можно отключить встроенные или добавить свои для конкретного проекта. Дополнительно поддерживается отправка уведомлений в Lark.

Установка

npx -y @dubuqingfeng/gitlab-mcp-server

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

Общее

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

Технологии

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

Описание

Возможности

  • Получает детальную информацию о конкретном Merge Request и выводит список всех MR в проекте.
  • Запускает автоматическое код-ревью для Merge Request, для отдельной ветки или для конкретного коммита.
  • Читает содержимое любого файла из указанной ветки репозитория.
  • Выводит полный список веток проекта.
  • Пишет заметки и результаты ревью в Merge Request.
  • Гибко настраивает уведомления: может писать заметку только в GitLab, только в Lark, или дублировать в оба сервиса.
  • Применяет встроенные правила код-ревью для TypeScript, React, Node.js, Go, Python, Rust, общих бэкенд-проектов и баз данных.
  • Поддерживает создание собственных правил ревью через внешний JSON-конфиг, отключение стандартных правил и добавление проектных типов.
  • Сортирует правила ревью по категориям: безопасность, производительность, поддерживаемость, стиль кода, лучшие практики.

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

1. Установите пакет через npx. Требуется Node.js.

npx -y @dubuqingfeng/gitlab-mcp-server

2. Создайте персональный токен доступа GitLab с правами read_api и write_repository.

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

{ "mcpServers": { "gitlab-mcp-server": { "command": "npx", "args": ["-y", "@dubuqingfeng/gitlab-mcp-server"], "env": { "GITLAB_TOKEN": "glpat-ваш_токен", "GITLAB_URL": "https://gitlab.com" } } } }

Переменная GITLAB_URL необязательна — по умолчанию сервер работает с gitlab.com. Если используете self-hosted GitLab, укажите URL инстанса без суффикса /api/v4.

4. Перезапустите MCP-клиент, чтобы сервер стал доступен AI-ассистенту.

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

  • «Покажи список всех открытых Merge Request в проекте my-org/backend-api. Отсортируй по убыванию даты создания».
  • «Проведи код-ревью для Merge Request #23. Проверь код на уязвимости и соответствие лучшим практикам для Python».
  • «Прочитай содержимое файла src/config/database.ts из ветки develop».
  • «Напиши в Merge Request #15 комментарий: "Функция handleRequest не обрабатывает ошибки валидации. Добавь try-catch блок"».

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

  • Язык: TypeScript
  • Транспорт: stdio
  • Лицензия: MIT
  • Совместимость: Claude Desktop, Cursor, Continue.dev и другие MCP-клиенты

Поделиться