GitLab MCP для проверки кода

Этот проект является ответвлением cayirtepeomer/gerrit-code-review-mcp и адаптирован для интеграции с GitLab.

Сервер MCP (Model Context Protocol) для интеграции помощников ИИ, таких как Claude, с запросами на слияние GitLab. Это позволяет помощникам ИИ просматривать изменения кода напрямую через API GitLab.

Функции

Полный анализ запросов на слияние : получение полной информации о запросах на слияние, включая различия, коммиты и комментарии.
Различия по конкретным файлам : анализ изменений в определенных файлах в запросах на слияние.
Сравнение версий : сравнение различных веток, тегов или коммитов.
Управление обзорами : добавление комментариев, одобрение или отмена одобрения запросов на слияние.
Обзор проекта : получение списков всех запросов на слияние в проекте.

Установка

Предпосылки

Питон 3.10+
Персональный токен доступа GitLab с областью действия API (read_api, api)
Cursor IDE или приложение Claude Desktop для интеграции MCP

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

Клонируйте этот репозиторий:

git clone https://github.com/mehmetakinn/gitlab-mcp-code-review.git
cd gitlab-mcp-code-review

Создайте и активируйте виртуальную среду:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

Установите зависимости:

pip install -r requirements.txt

Создайте файл .env с вашей конфигурацией GitLab (все параметры см. .env.example ):

# Required
GITLAB_TOKEN=your_personal_access_token_here

# Optional settings
GITLAB_HOST=gitlab.com
GITLAB_API_VERSION=v4
LOG_LEVEL=INFO

Параметры конфигурации

В файле .env можно настроить следующие переменные среды:

Переменная	Необходимый	По умолчанию	Описание
GITLAB_ТОКЕН	Да	-	Ваш персональный токен доступа GitLab
GITLAB_HOST	Нет	gitlab.com	Имя хоста экземпляра GitLab
GITLAB_API_VERSION	Нет	версия 4	Версия API GitLab для использования
УРОВЕНЬ_ЛОГА	Нет	ИНФОРМАЦИЯ	Уровень ведения журнала (ОТЛАДКА, ИНФОРМАЦИЯ, ПРЕДУПРЕЖДЕНИЕ, ОШИБКА, КРИТИЧЕСКИЙ)
ОТЛАЖИВАТЬ	Нет	ЛОЖЬ	Включить режим отладки
REQUEST_TIMEOUT	Нет	30	Время ожидания запроса API в секундах
МАКСИМАЛЬНОЕ_КОЛИЧЕСТВО_ПОВТОРЕНИЙ	Нет	3	Максимальное количество попыток повтора для неудавшихся запросов

Интеграция курсора IDE

Чтобы использовать этот MCP с Cursor IDE, добавьте эту конфигурацию в файл ~/.cursor/mcp.json :

{
  "mcpServers": {
    "gitlab-mcp-code-review": {
      "command": "/path/to/your/gitlab-mcp-code-review/.venv/bin/python",
      "args": [
        "/path/to/your/gitlab-mcp-code-review/server.py",
        "--transport",
        "stdio"
      ],
      "cwd": "/path/to/your/gitlab-mcp-code-review",
      "env": {
        "PYTHONPATH": "/path/to/your/gitlab-mcp-code-review",
        "VIRTUAL_ENV": "/path/to/your/gitlab-mcp-code-review/.venv",
        "PATH": "/path/to/your/gitlab-mcp-code-review/.venv/bin:/usr/local/bin:/usr/bin:/bin"
      },
      "stdio": true
    }
  }
}

Замените /path/to/your/gitlab-mcp-code-review на фактический путь к вашему клонированному репозиторию.

Интеграция приложения Claude Desktop

Чтобы использовать этот MCP с приложением Claude Desktop:

Откройте приложение Claude Desktop.
Перейдите в Настройки → Дополнительно → Конфигурация MCP.
Добавьте следующую конфигурацию:

{
  "mcpServers": {
    "gitlab-mcp-code-review": {
      "command": "/path/to/your/gitlab-mcp-code-review/.venv/bin/python",
      "args": [
        "/path/to/your/gitlab-mcp-code-review/server.py",
        "--transport",
        "stdio"
      ],
      "cwd": "/path/to/your/gitlab-mcp-code-review",
      "env": {
        "PYTHONPATH": "/path/to/your/gitlab-mcp-code-review",
        "VIRTUAL_ENV": "/path/to/your/gitlab-mcp-code-review/.venv",
        "PATH": "/path/to/your/gitlab-mcp-code-review/.venv/bin:/usr/local/bin:/usr/bin:/bin"
      },
      "stdio": true
    }
  }
}

Замените /path/to/your/gitlab-mcp-code-review на фактический путь к вашему клонированному репозиторию.

Доступные инструменты

Сервер MCP предоставляет следующие инструменты для взаимодействия с GitLab:

Инструмент	Описание
`fetch_merge_request`	Получите полную информацию о запросе на слияние
`fetch_merge_request_diff`	Получить различия для конкретного запроса на слияние
`fetch_commit_diff`	Получить информацию о различиях для определенного коммита
`compare_versions`	Сравните различные ветки, теги или коммиты
`add_merge_request_comment`	Добавить комментарий к запросу на слияние
`approve_merge_request`	Одобрить запрос на слияние
`unapprove_merge_request`	Отменить одобрение запроса на слияние
`get_project_merge_requests`	Получить список запросов на слияние для проекта

Примеры использования

Получить запрос на слияние

# Get details of merge request #5 in project with ID 123
mr = fetch_merge_request("123", "5")

Просмотр определенных изменений файла

# Get diff for a specific file in a merge request
file_diff = fetch_merge_request_diff("123", "5", "path/to/file.js")

Сравнить филиалы

# Compare develop branch with master branch
diff = compare_versions("123", "develop", "master")

Добавить комментарий к запросу на слияние

# Add a comment to a merge request
comment = add_merge_request_comment("123", "5", "This code looks good!")

Одобрить запрос на слияние

# Approve a merge request and set required approvals to 2
approval = approve_merge_request("123", "5", approvals_required=2)

Поиск неисправностей

Если у вас возникли проблемы:

Убедитесь, что ваш токен GitLab имеет соответствующие разрешения (api, read_api)
Проверьте настройки файла .env
Убедитесь, что пути конфигурации MCP верны.
Проверьте соединение с помощью: curl -H "Private-Token: your-token" https://gitlab.com/api/v4/projects
Установите LOG_LEVEL=DEBUG в вашем .env-файле для более подробного протоколирования.

Внося вклад

Вклады приветствуются! Пожалуйста, не стесняйтесь отправлять запрос на включение.

Форк репозитория
Создайте ветку функций ( git checkout -b feature/amazing-feature )
Зафиксируйте свои изменения ( git commit -m 'Add some amazing feature' )
Отправить в ветку ( git push origin feature/amazing-feature )
Открыть запрос на извлечение

Более подробную информацию о процессе разработки смотрите в файле CONTRIBUTING.md .

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Сервер MCP, который интегрирует помощников на основе искусственного интеллекта, таких как Клод, с запросами на слияние GitLab, позволяя им просматривать изменения кода, добавлять комментарии и утверждать/отменять запросы на слияние непосредственно через API GitLab.

Related MCP Servers

GitLab MCP Server
chris-miaskowski
-
security
F
license
-
quality
A custom server implementation that allows AI assistants to interact with GitLab repositories, providing capabilities for searching, fetching files, creating/updating content, and managing issues and merge requests.
Last updated -
JavaScript
GitLab MCP Server
harshmaur
-
security
F
license
-
quality
An MCP server that enables communication with GitLab repositories, allowing interaction with GitLab's API to manage projects, issues, and repositories through natural language.
Last updated -
20
1
JavaScript
MIT License
GitHub Actions MCP Server
ko1ynnky
A
security
F
license
A
quality
An MCP server that enables AI assistants to manage GitHub Actions workflows by providing tools for listing, viewing, triggering, canceling, and rerunning workflows through the GitHub API.
Last updated -
9
16
37
TypeScript
GitLab MCP Server
ZephyrDeng
-
security
F
license
-
quality
A Model Context Protocol server that enables AI assistants to interact with GitLab repositories, allowing tasks like managing merge requests, searching projects, and creating comments through RESTful API integration.
Last updated -
67
2
TypeScript

View all related MCP servers

Appeared in Searches

Information about Git Actions and Workflows

GitLab MCP for Code Review