GitLab MCP Server

Подключите ваш AI-ассистент к GitLab. Задавайте вопросы прямо в чате: "Покажи открытые merge request'ы", "Покажи ревью для MR #123", "Найди merge request'ы для ветки feature/auth".

🚀 Быстрая установка

Требования

Проект использует uv для управления Python-пакетами.

Установка uv:

Установка

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

   git clone https://github.com/FitoDomik/gitlab-mcp-server.git cd gitlab-mcp-server uv venv source .venv/bin/activate # На Windows: .venv\Scripts\activate uv pip install -e . chmod +x run-mcp.sh

2. Получите токен GitLab:

   • Перейдите в GitLab → Settings → Access Tokens

   • Создайте токен с правами read_api

   • Скопируйте токен

3. Настройте проект:

   Создайте файл gitlab-mcp.env в директории вашего проекта:

   GITLAB_PROJECT_ID=12345 GITLAB_ACCESS_TOKEN=glpat-xxxxxxxxxxxxxxxxxxxx GITLAB_URL=https://gitlab.com

4. Подключите к Cursor:

   Создайте .cursor/mcp.json в вашем проекте:

   { "mcpServers": { "gitlab-mcp": { "command": "/путь/к/gitlab-mcp-server/run-mcp.sh", "cwd": "/путь/к/вашему-проекту" } } }

5. Перезапустите Cursor и начните задавать вопросы о GitLab!

💬 Что можно делать

После подключения попробуйте эти команды в чате:

• "Покажи открытые merge request'ы"

• "Покажи детали merge request #456"

• "Покажи ревью и обсуждения для MR #123"

• "Покажи сводку тестов для MR #456"

• "Какие тесты упали в merge request #789?"

• "Покажи pipeline для MR #456"

• "Покажи логи упавшего job для merge request #789"

• "Покажи обсуждения коммитов для MR #456"

• "Найди merge request'ы для ветки feature/auth-improvements"

• "Ответь на обсуждение abc123 в MR #456: 'Спасибо за фидбек!'"

📋 Основные возможности

Merge Request'ы

• Просмотр списка MR с фильтрацией по статусу и ветке

• Детальная информация о конкретном MR

• Поиск MR по имени ветки

Ревью и обсуждения

• Просмотр всех ревью и обсуждений в MR

• Ответы на существующие обсуждения

• Создание новых комментариев

• Разрешение обсуждений

Тесты и Pipeline

• Сводка тестов — быстрый обзор результатов (количество пройденных/упавших тестов)

• Детальный отчет — полная информация о тестах с ошибками и стектрейсами

• Pipeline — обзор всех job'ов и их статусов

• Логи job'ов — просмотр вывода конкретного job'а

Коммиты

• Просмотр всех обсуждений на коммитах в MR

• История комментариев по каждому коммиту

⚙️ Конфигурация

Настройка проекта (рекомендуется)

Каждый проект имеет свой файл gitlab-mcp.env с настройками GitLab. Не добавляйте токены в систему контроля версий.

Глобальная настройка

Можно задать переменные окружения глобально:

Как найти Project ID

• Перейдите в GitLab проект → Settings → General → Project ID

• Или посмотрите в URL: https://gitlab.com/username/project (используйте числовой ID)

🔧 Решение проблем

Ошибка аутентификации: Проверьте, что токен имеет права read_api и не истёк.

Проект не найден: Убедитесь, что Project ID указан правильно (это число, а не название проекта).

Проблемы с подключением: Проверьте, что URL GitLab доступен и указан верно.

Скрипт не найден: Убедитесь, что путь в конфигурации MCP указывает на правильное расположение сервера и скрипт исполняемый.

📚 Справочник инструментов